CKTIS / JavaScript
Littéral de gabarit
Un littéral de gabarit utilise des accents graves (`) comme délimiteurs. Il permet d’insérer des expressions avec ${expression} et d’écrire du texte sur plusieurs lignes. Dans la variante balisée, une fonction de balisage reçoit les segments de texte et les valeurs des expressions.
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
`text ${expression} text`
tag`text ${expression} text`Un template literal est délimité par des accents graves plutôt que par des apostrophes ou des guillemets. Dans sa forme ordinaire, il produit une chaîne de caractères. La syntaxe ${expression} évalue une expression, convertit son résultat en texte et l’insère à cet emplacement ; les substitutions sont traitées de gauche à droite.
Dans un littéral de gabarit ordinaire, les indentations et les retours à la ligne non échappés font partie de la chaîne obtenue. Une barre oblique inverse placée immédiatement avant un retour à la ligne dans le code source forme une continuation de ligne et n’ajoute aucun saut de ligne à la chaîne. Les séquences d’échappement comme \n sont interprétées. Pour écrire ${ littéralement, utilisez \${ ; faites précéder un accent grave d’une barre oblique inverse. Dans les chaînes ordinaires délimitées par ' ou ", ${expression} ne réalise pas d’interpolation.
Placer tag directement avant le littéral appelle une fonction de balisage : elle reçoit un tableau de segments de texte traités, puis les valeurs des substitutions sans conversion automatique en chaînes. La propriété raw du tableau expose les segments non traités. Le résultat est la valeur renvoyée par la fonction, pas nécessairement une chaîne.
L’exemple combine interpolation, calcul et retour à la ligne. Un littéral de gabarit ne fournit pas à lui seul l’échappement HTML automatique ni la construction sûre de requêtes SQL ; le traitement approprié doit être fourni séparément.
Exemples
const name = "Ada";
const count = 3;
const message = `Hello, ${name}!
Total: ${count * 2}`;
console.log(message);Résultat
Hello, Ada! Total: 6
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.