CKTIS / JavaScript
String.raw — segmenti grezzi dei template literal
String.raw è un metodo statico usato come tag di un template literal. Conserva la rappresentazione di sequenze come \n nei segmenti di testo letterali, continuando però a valutare le espressioni ${...} e a inserire i relativi valori.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
String.raw`text${expression}text`
String.raw(template, ...substitutions)String.raw è un metodo statico, non un metodo di una singola stringa. Usato come tag di un template literal, unisce i segmenti di testo letterali grezzi con le sostituzioni. Una sequenza \n in un segmento letterale produce una barra rovesciata e la lettera n, non un carattere di nuova riga.
Le espressioni all’interno di ${...} vengono comunque valutate e i loro valori convertiti in stringhe. La gestione grezza riguarda i segmenti letterali, non le sostituzioni: se un valore sostituito contiene già un carattere di nuova riga, questo resta un carattere di nuova riga. Il metodo non annulla l’elaborazione precedente delle sequenze di escape e non fornisce una codifica sicura per HTML o SQL.
È possibile anche una chiamata normale, String.raw(template, ...substitutions). Il metodo legge template.raw come un oggetto simile a un array e ne intercala gli elementi con le sostituzioni. Le sostituzioni mancanti non aggiungono nulla, quelle in eccesso vengono ignorate e un raw di lunghezza zero produce una stringa vuota. Se raw manca o ha valore null, viene generato un TypeError.
Nell’esempio, la prima riga contiene un \n letterale, la seconda conferma il contenuto della stringa e la terza mostra la sostituzione omessa tra B e C.
Esempi
const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));Risultato
Hello\nAda! true A7BC
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.