CKTIS / JavaScript
Syntaxe des littéraux de gabarit étiquetés
La fonction d’étiquette reçoit séparément les segments de texte et les valeurs de substitution. Son résultat devient la valeur de l’expression entière.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`
function tag(strings, ...values) { /* process the parts and return a value */ }Dans tag`prefix ${expression} suffix` , l’expression tag précède un littéral délimité par des accents graves. JavaScript appelle la fonction d’étiquette sans construire d’abord une chaîne. Dans tag(`prefix ${expression} suffix`), le littéral non étiqueté convertit les valeurs de substitution en chaînes et les assemble avec le texte : la fonction reçoit une seule chaîne déjà formée.
Le premier argument de la fonction est le tableau strings, qui contient les segments littéraux. JavaScript évalue les expressions ${...} de gauche à droite avant l’appel et transmet leurs valeurs comme arguments distincts sans les convertir en chaînes. Un paramètre du reste tel que ...values les rassemble. Pour n substitutions, il y a n + 1 segments, y compris les segments vides. La valeur de l’expression est celle que renvoie la fonction, pas nécessairement une chaîne.
strings[i] contient le segment dont les séquences d’échappement sont interprétées (cooked) ; strings.raw[i] en conserve l’écriture. Une séquence d’échappement mal formée rend tout l’élément correspondant de strings égal à undefined dans un littéral étiqueté ; sans étiquette, elle provoque une SyntaxError. Les deux tableaux sont gelés. La même occurrence du littéral, évaluée plusieurs fois dans le même realm ECMAScript, réutilise le même tableau strings. Une autre occurrence a son propre tableau, même si le texte est identique.
Dans obj.tag`x` , l’appel transmet obj comme valeur de this, comme pour un appel de méthode ordinaire. Une valeur d’étiquette non appelable provoque une TypeError. L’utilisation directe du chaînage optionnel, comme dans obj?.tag`x` , provoque une SyntaxError.
Cette syntaxe du langage est définie dans ECMAScript 2024 ; ce n’est pas une API de navigateur. Vérifie sa prise en charge dans l’environnement d’exécution cible. Une étiquette n’assainit pas les données par elle-même : ne transmets pas de résultat non fiable à innerHTML sans assainissement HTML adapté.
Exemples
function inspect(strings, value) {
return {
cookedLength: strings[0].length,
rawLength: strings.raw[0].length,
valueType: typeof value,
tail: strings[1],
};
}
console.log(JSON.stringify(inspect`\n${7}`));Résultat
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` renvoie un objet que `JSON.stringify` transforme en chaîne pour l’affichage. `\n` est un seul caractère de saut de ligne dans `strings[0]`, mais deux caractères dans `strings.raw[0]`. La valeur `7` reste un nombre et le dernier segment est vide.
Leçons associées
- JavaScript · Leçon 28 · Avancé · Version : 4