| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/raw | [Back] [Original] |
Get to know MDN better
Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.
Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La mthode statique String.raw() est une fonction d'tiquetage (tag function) pour les gabarits de chanes de caractres (elle est semblable au prfixe r en Python ou au prfixe @ en C#). Cette fonction permet d'obtenir la chane brute pour un gabarit (les caractres spciaux ne sont pas pris en compte mais retranscrits tels quels, les squences d'chappement ne sont pas interprtes et les emplacements (ex. ${toto}) sont traits).
// Create a variable that uses a Windows
// path without escaping the backslashes:
const filePath = String.raw`C:\Development\profile\aboutme.html`;
console.log(`The file was uploaded from: ${filePath}`);
// Expected output: "The file was uploaded from: C:\Development\profile\aboutme.html"
String.raw(callSite, ...substitutions);
String.raw`gabaritChane`;
callSiteUn site d'appel bien form pour un gabarit (call site object) tel que {raw: "string"}.
Paramtre contenant les valeurs substituer.
Un gabarit de chane de caractres, ventuellement avec des substitutions (${...}).
La chane de caractres brute correspondant un gabarit donn.
TypeErrorUne exception TypeError est renvoye si le premier argument n'est pas un objet bien form.
Dans la plupart des cas, String.raw() est utilis avec des gabarits de chanes de caractres. La premire syntaxe, prsente ci-avant est rarement utilise. En effet, le moteur JavaScript appellera cette forme avec les arguments appropris, comme pour les fonctions d'tiquetage (tag).
La mthode String.raw() est la seule mthode d'tiquetage native pour les chanes de caractres. Elle fonctionne comme la fonction par dfaut pour les gabarits et permet d'effectuer des concatnations. Il est galement possible d'implmenter cette mthode avec du code JavaScript.
String.raw`Hi\n${2 + 3}!`;
// "Hi\n5!", le caractre aprs "Hi" n'est pas
// le caractre de nouvelle ligne
// "\" et "n" sont bien deux caractres distincts
// ici.
String.raw`Hi\u000A!`;
// "Hi\u000A!", de mme ici. Les caractres
// \, u, 0, 0, 0, A et 6 sont distincts.
// Tous les caractres d'chappement seront
// inefficaces. Des backslashes peuvent donc tre
// prsents dans la chane produite. Cela peut
// tre vrifi avec la proprit .length de la
// chane.
let nom = "Bob";
String.raw`Hi\n${nom}!`;
// "Hi\nBob!", les remplacements sont effectus.
// Gnralement, on n'appelle pas String.raw
// comme une fonction, mais c'est possible :
String.raw({ raw: "test" }, 0, 1, 2);
// "t0e1s2t"
| Spcification |
|---|
| ECMAScript 2027 LanguageSpecification # sec-string.raw |
Cette page a t modifie le 2 dc. 2025 par les contributeurices du MDN.
StringString.prototype.anchor()String.prototype.at()String.prototype.big()String.prototype.blink()String.prototype.bold()String.prototype.charAt()String.prototype.charCodeAt()String.prototype.codePointAt()String.prototype.concat()String.prototype.endsWith()String.prototype.fixed()String.prototype.fontcolor()String.prototype.fontsize()String.prototype.includes()String.prototype.indexOf()isWellFormed()String.prototype.italics()String.prototype.lastIndexOf()String.prototype.link()String.prototype.localeCompare()String.prototype.match()String.prototype.matchAll()String.prototype.normalize()String.prototype.padEnd()String.prototype.padStart()String.prototype.repeat()String.prototype.replace()String.prototype.replaceAll()String.prototype.search()String.prototype.slice()String.prototype.small()String.prototype.split()String.prototype.startsWith()String.prototype.strike()String.prototype.sub()String.prototype.substr()String.prototype.substring()String.prototype.sup()String.prototype.toLocaleLowerCase()String.prototype.toLocaleUpperCase()String.prototype.toLowerCase()String.prototype.toString()String.prototype.toUpperCase()toWellFormed()String.prototype.trim()String.prototype.trimEnd()String.prototype.trimStart()String.prototype.valueOf()String.prototype[@@iterator]()Object/FunctionObject.prototype.__defineGetter__()Object.prototype.__defineSetter__()Object.prototype.__lookupGetter__()Object.prototype.__lookupSetter__()Object.prototype.hasOwnProperty()Object.prototype.isPrototypeOf()Object.prototype.propertyIsEnumerable()Object.prototype.toLocaleString()Object.prototype.toString()Object.prototype.valueOf()Certaines parties de ce contenu sont protges par le droit d'auteur 19982026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.
| Web Proxy Viewer | New URL | Original Page |