Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti