CKTIS / JavaScript
Letterali di modello in JavaScript
Crea stringhe su più righe e inserisci il risultato di espressioni. Scopri quando JavaScript produce una stringa e quando passa frammenti e valori a una funzione tag.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`I letterali di modello si racchiudono tra accenti gravi (backtick), non tra virgolette. Un segnaposto ${expression} contiene un’espressione. Senza tag, JavaScript valuta le espressioni da sinistra a destra, converte ciascun risultato in una stringa e lo unisce al testo. Interpolare direttamente un valore di tipo Symbol genera un TypeError. Le interruzioni di riga e i rientri del testo letterale fanno parte della stringa. Usa \` per inserire un accento grave e \${ per scrivere ${ senza aprire un segnaposto.
Una funzione posta subito prima dell’accento grave di apertura viene chiamata come tag. Il primo argomento è un array congelato di frammenti di testo elaborati (cooked), compresi quelli vuoti. Gli altri argomenti sono i valori delle espressioni, senza conversione automatica in stringhe. Il valore restituito dal tag è il risultato dell’intera espressione e non deve essere necessariamente una stringa. Valutando più volte la stessa occorrenza del letterale nello stesso ambiente globale (realm), si riutilizza lo stesso array, senza copiarlo.
In un frammento elaborato, \n rappresenta un carattere di nuova riga. L’array congelato parts.raw conserva invece la barra inversa e la lettera n. Una sequenza di escape non valida come \xZ causa un SyntaxError senza tag; con un tag, il frammento elaborato corrispondente vale undefined e la forma grezza resta disponibile. Il tag integrato String.raw unisce i frammenti grezzi ai valori delle sostituzioni convertiti in stringhe.
L’interpolazione non esegue l’escape dei dati per HTML e un tag non rende sicuro il risultato da solo. Per mostrare dati non attendibili come testo semplice in un elemento destinato alla visualizzazione di testo, come <p> o <span>, usa textContent, non innerHTML. In un elemento <script>, impostare textContent definisce il codice sorgente dello script, anziché visualizzare del testo. I letterali di modello fanno parte della sintassi ECMAScript e non richiedono il DOM; verifica il supporto nell’ambiente di esecuzione di destinazione.
Esempi
{
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}`));
}Risultato
"Items: 5\nStatus: ready" ["Items:\n","Items:\\n",5]
La prima riga mostra una stringa su più righe. La seconda confronta il frammento elaborato con quello grezzo. `JSON.stringify` rende visibile la differenza tra un carattere di nuova riga e un `\n` letterale; il numero `5` resta senza virgolette.
Lezioni correlate
- JavaScript · Lezione 1 · Avanzato · Versione: 4
- JavaScript · Lezione 4 · Avanzato · Versione: 4
- JavaScript · Lezione 5 · Avanzato · Versione: 4
- JavaScript · Lezione 6 · Avanzato · Versione: 4
- JavaScript · Lezione 7 · Avanzato · Versione: 4
- JavaScript · Lezione 8 · Avanzato · Versione: 4
- JavaScript · Lezione 10 · Avanzato · Versione: 4
- JavaScript · Lezione 11 · Avanzato · Versione: 4
- JavaScript · Lezione 14 · Avanzato · Versione: 4
- JavaScript · Lezione 16 · Avanzato · Versione: 4
- JavaScript · Lezione 17 · Avanzato · Versione: 4
- JavaScript · Lezione 18 · Avanzato · Versione: 4
- JavaScript · Lezione 17 · Intermedio · Versione: 3
- JavaScript · Lezione 19 · Intermedio · Versione: 3
- JavaScript · Lezione 20 · Intermedio · Versione: 3
- JavaScript · Lezione 21 · Intermedio · Versione: 3
- JavaScript · Lezione 22 · Intermedio · Versione: 3
- JavaScript · Lezione 23 · Intermedio · Versione: 3
- JavaScript · Lezione 25 · Intermedio · Versione: 3
- JavaScript · Lezione 28 · Intermedio · Versione: 3
- JavaScript · Lezione 30 · Intermedio · Versione: 3
- JavaScript · Lezione 31 · Intermedio · Versione: 3
- JavaScript · Lezione 33 · Intermedio · Versione: 3
- JavaScript · Lezione 35 · Intermedio · Versione: 3
- JavaScript · Lezione 38 · Intermedio · Versione: 3
- JavaScript · Lezione 42 · Intermedio · Versione: 3