CKTIS / JavaScript
Sintassi dei template literal con tag
Una funzione tag riceve separatamente i segmenti di testo e i valori di sostituzione. Ciò che restituisce diventa il valore dell’intera espressione.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`
function tag(strings, ...values) { /* process the parts and return a value */ }In tag`prefix ${expression} suffix` , l’espressione tag precede un letterale delimitato da accenti gravi. JavaScript invoca il tag senza costruire prima una stringa. In tag(`prefix ${expression} suffix`), invece, il letterale senza tag converte i valori di sostituzione in stringhe e li unisce al testo: la funzione riceve un’unica stringa già composta.
Il primo argomento del tag è l’array strings con i segmenti letterali. JavaScript valuta le espressioni ${...} da sinistra a destra prima della chiamata e passa i loro valori come argomenti distinti, senza convertirli in stringhe. Un parametro rest come ...values permette di raccoglierli. Con n sostituzioni ci sono n + 1 segmenti, compresi quelli vuoti. Il valore dell’espressione è quello restituito dal tag e non deve essere per forza una stringa.
In strings[i] le sequenze di escape sono interpretate (cooked), mentre strings.raw[i] ne conserva la grafia. In un letterale con tag, una sequenza di escape non valida rende undefined l’intero elemento corrispondente di strings; senza tag causa un SyntaxError. Entrambi gli array sono congelati. Valutazioni ripetute della stessa occorrenza del letterale nello stesso realm ECMAScript riutilizzano lo stesso array strings. Un’altra occorrenza ha un array proprio, anche a parità di testo.
In obj.tag`x` , la chiamata passa obj come valore di this, come in una normale chiamata a un metodo. Se il valore del tag non è invocabile, si verifica un TypeError. L’uso diretto dell’optional chaining, come in obj?.tag`x` , causa un SyntaxError.
È sintassi del linguaggio definita in ECMAScript 2024, non un’API del browser. Verifica il supporto nell’ambiente di esecuzione di destinazione. Un tag non sanifica i dati da solo: non passare risultati non attendibili a innerHTML senza un’adeguata sanificazione dell’HTML.
Esempi
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}`));Risultato
{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}`inspect` restituisce un oggetto che `JSON.stringify` converte in una stringa da visualizzare. `\n` è un solo carattere di nuova riga in `strings[0]`, ma due caratteri in `strings.raw[0]`. Il valore `7` resta un numero e il segmento finale è vuoto.
Lezioni correlate
- JavaScript · Lezione 28 · Avanzato · Versione: 4