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

CKTIS / JavaScript

Syntaxe des littéraux de gabarit

Les littéraux de gabarit permettent d’écrire du texte multiligne et d’y insérer des expressions. Une fonction d’étiquette reçoit séparément les segments de texte et les valeurs à insérer.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`

Un littéral de gabarit est délimité par des accents graves (backticks), et non par des guillemets simples ou doubles. Les sauts de ligne ordinaires et l’indentation du texte font partie du résultat. Pour écrire un accent grave littéral, fais-le précéder d’une barre oblique inverse. Écris \${ pour insérer ${ sans ouvrir de substitution.

Dans un littéral sans étiquette, JavaScript évalue les expressions de ${expression} de gauche à droite et convertit chaque valeur en chaîne avant de passer à l’expression suivante. Le résultat est une chaîne. Insérer directement une valeur de type Symbol déclenche TypeError ; pour obtenir sa représentation textuelle, utilise explicitement String(value).

Dans un gabarit étiqueté, tag`...` appelle une fonction sans parenthèses. Son premier argument, parts, est un tableau gelé des segments de texte interprétés, y compris les segments vides : n substitutions donnent n + 1 segments. Les autres arguments sont les valeurs de substitution, sans conversion automatique en chaînes. La valeur renvoyée par la fonction devient celle de l’expression. Les évaluations répétées au même emplacement du code source dans le même realm JavaScript réutilisent le même tableau.

Le tableau gelé parts.raw contient les segments sans interprétation des séquences d’échappement. Les fins de ligne CRLF et CR du code source deviennent LF dans les deux formes. Une séquence d’échappement invalide comme \xG provoque une SyntaxError sans étiquette ; avec une étiquette, le segment interprété concerné vaut undefined et le segment brut conserve la séquence.

Il s’agit de syntaxe JavaScript, pas d’une API DOM ; vérifie sa prise en charge dans l’environnement cible. L’interpolation n’échappe pas les valeurs pour le HTML. Pour afficher du texte non fiable dans un élément ordinaire de la page, utilise textContent, pas innerHTML.

Exemples

const count = 2;
const message = `Total: ${count + 1}
Ready`;

function inspect(parts, value) {
  return [parts[1].startsWith("\n"), parts.raw[1].startsWith("\\n"), typeof value];
}

console.log(message);
console.log(JSON.stringify(inspect`Total: ${count + 1}\nReady`));

Résultat

Total: 3
Ready
[true,true,"number"]

Le littéral sans étiquette affiche deux lignes. Dans le résultat de la fonction d’étiquette, le premier `true` indique que le segment interprété commence par un saut de ligne ; le second indique que le segment brut commence par deux caractères : une barre oblique inverse et `n`. `"number"` confirme que la fonction a reçu un nombre.

Leçons associées

  • JavaScript · Leçon 23 · Avancé · Version : 4
  • JavaScript · Leçon 24 · Avancé · Version : 4
  • JavaScript · Leçon 25 · Avancé · Version : 4
  • JavaScript · Leçon 31 · Avancé · Version : 4
  • JavaScript · Leçon 32 · Avancé · Version : 4
  • JavaScript · Leçon 35 · Avancé · Version : 4
  • JavaScript · Leçon 40 · Avancé · Version : 4
  • JavaScript · Leçon 41 · Avancé · Version : 4
  • JavaScript · Leçon 42 · Avancé · Version : 4
  • JavaScript · Leçon 43 · Avancé · Version : 4

Sources