Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.raw — segments bruts de littéral de gabarit

String.raw est une méthode statique utilisée comme étiquette d’un littéral de gabarit. Elle conserve l’écriture de séquences telles que \n dans les segments de texte littéraux, tout en évaluant les expressions ${...} et en insérant leurs valeurs.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

String.raw`text${expression}text`
String.raw(template, ...substitutions)

String.raw est une méthode statique, et non une méthode d’une chaîne de caractères particulière. Utilisée comme étiquette d’un littéral de gabarit, elle assemble les segments de texte littéraux bruts avec les substitutions. Une séquence \n dans un segment littéral produit une barre oblique inverse et la lettre n, et non un caractère de nouvelle ligne.

Les expressions à l’intérieur de ${...} sont toujours évaluées et leurs valeurs converties en chaînes. Le traitement brut s’applique aux segments littéraux, pas aux substitutions : si une valeur substituée contient déjà un caractère de nouvelle ligne, celui-ci reste une nouvelle ligne. La méthode n’annule pas le traitement antérieur des séquences d’échappement et ne fournit pas d’encodage sûr pour HTML ou SQL.

Un appel ordinaire, String.raw(template, ...substitutions), est également possible. La méthode lit template.raw comme un objet de type tableau et entrelace ses éléments avec les substitutions. Les substitutions manquantes n’ajoutent rien, les substitutions supplémentaires sont ignorées et un raw de longueur nulle produit une chaîne vide. L’absence de raw ou une valeur null provoque un TypeError.

Dans l’exemple, la première ligne contient un \n littéral, la deuxième confirme le contenu de la chaîne et la troisième montre l’omission de la substitution entre B et C.

Exemples

const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));

Résultat

Hello\nAda!
true
A7BC

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources