CKTIS / JavaScript
Littéraux de gabarit en JavaScript
Créez des chaînes multilignes et insérez le résultat d’expressions. Découvrez quand JavaScript produit une chaîne et quand il transmet les fragments et les valeurs à une fonction d’étiquette.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`Les littéraux de gabarit sont délimités par des accents graves (backticks) plutôt que par des guillemets. Un emplacement ${expression} contient une expression. Sans étiquette, JavaScript évalue les expressions de gauche à droite, convertit chaque résultat en chaîne et l’insère dans le texte. L’interpolation directe d’une valeur de type Symbol déclenche une TypeError. Les sauts de ligne et l’indentation du texte littéral font partie de la chaîne. Écrivez \` pour insérer un accent grave et \${ pour insérer ${ sans ouvrir d’emplacement.
Une fonction placée juste avant l’accent grave ouvrant est appelée comme étiquette (tag). Son premier argument est un tableau gelé des fragments de texte traités (cooked), y compris les fragments vides. Les autres arguments sont les valeurs des expressions, sans conversion automatique en chaînes. Le retour de la fonction est le résultat de l’expression entière et n’est pas forcément une chaîne. Réévaluer la même occurrence du littéral dans le même environnement global (realm) réutilise le même tableau, sans le copier.
Dans un fragment traité, \n représente un saut de ligne. Le tableau gelé parts.raw conserve à cet endroit la barre oblique inverse et la lettre n. Une séquence d’échappement invalide comme \xZ provoque une SyntaxError sans étiquette ; avec une étiquette, le fragment traité correspondant vaut undefined et la forme brute reste accessible. L’étiquette intégrée String.raw assemble les fragments bruts et les valeurs des substitutions converties en chaînes.
L’interpolation n’échappe pas les données pour HTML, et la présence d’une étiquette ne suffit pas à sécuriser le résultat. Pour afficher des données non fiables sous forme de texte brut dans un élément prévu pour l’affichage de texte, comme <p> ou <span>, utilisez textContent, pas innerHTML. Sur un élément <script>, modifier textContent définit le code source du script au lieu d’afficher du texte. Les littéraux de gabarit relèvent de la syntaxe ECMAScript et ne nécessitent pas le DOM ; vérifiez leur prise en charge dans l’environnement d’exécution cible.
Exemples
{
const count = 5;
const report = `Items: ${count}
Status: ready`;
function inspect(parts, value) {
return [parts[0], parts.raw[0], value];
}
console.log(JSON.stringify(report));
console.log(JSON.stringify(inspect`Items:\n${count}`));
}Résultat
"Items: 5\nStatus: ready" ["Items:\n","Items:\\n",5]
La première ligne montre une chaîne multiligne. La seconde compare les fragments traité et brut. `JSON.stringify` rend visible la différence entre un saut de ligne et un `\n` littéral ; le nombre `5` reste sans guillemets.
Leçons associées
- JavaScript · Leçon 1 · Avancé · Version : 4
- JavaScript · Leçon 4 · Avancé · Version : 4
- JavaScript · Leçon 5 · Avancé · Version : 4
- JavaScript · Leçon 6 · Avancé · Version : 4
- JavaScript · Leçon 7 · Avancé · Version : 4
- JavaScript · Leçon 8 · Avancé · Version : 4
- JavaScript · Leçon 10 · Avancé · Version : 4
- JavaScript · Leçon 11 · Avancé · Version : 4
- JavaScript · Leçon 14 · Avancé · Version : 4
- JavaScript · Leçon 16 · Avancé · Version : 4
- JavaScript · Leçon 17 · Avancé · Version : 4
- JavaScript · Leçon 18 · Avancé · Version : 4
- JavaScript · Leçon 17 · Intermédiaire · Version : 3
- JavaScript · Leçon 19 · Intermédiaire · Version : 3
- JavaScript · Leçon 20 · Intermédiaire · Version : 3
- JavaScript · Leçon 21 · Intermédiaire · Version : 3
- JavaScript · Leçon 22 · Intermédiaire · Version : 3
- JavaScript · Leçon 23 · Intermédiaire · Version : 3
- JavaScript · Leçon 25 · Intermédiaire · Version : 3
- JavaScript · Leçon 28 · Intermédiaire · Version : 3
- JavaScript · Leçon 30 · Intermédiaire · Version : 3
- JavaScript · Leçon 31 · Intermédiaire · Version : 3
- JavaScript · Leçon 33 · Intermédiaire · Version : 3
- JavaScript · Leçon 35 · Intermédiaire · Version : 3
- JavaScript · Leçon 38 · Intermédiaire · Version : 3
- JavaScript · Leçon 42 · Intermédiaire · Version : 3