Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.raw — segmentos brutos de literais de modelo

String.raw é um método estático utilizado como etiqueta de um literal de modelo. Preserva a escrita de sequências como \n nos segmentos de texto literais, mas continua a avaliar as expressões ${...} e a inserir os respetivos valores.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

String.raw`text${expression}text`
String.raw(template, ...substitutions)

String.raw é um método estático, não um método de uma cadeia de caracteres individual. Como etiqueta de um literal de modelo, junta os segmentos de texto literais brutos às substituições. Uma sequência \n num segmento literal produz uma barra invertida e a letra n, não um carácter de mudança de linha.

As expressões dentro de ${...} continuam a ser avaliadas e os respetivos valores são convertidos em cadeias de caracteres. O tratamento bruto aplica-se aos segmentos literais, não às substituições: se um valor substituído já contiver um carácter de mudança de linha, esse carácter mantém-se. O método não desfaz o processamento anterior de sequências de escape e não fornece uma codificação segura para HTML ou SQL.

Também é possível uma chamada normal, String.raw(template, ...substitutions). O método lê template.raw como um objeto semelhante a um array e intercala os seus elementos com as substituições. As substituições em falta não acrescentam nada, as adicionais são ignoradas e um raw com comprimento zero produz uma cadeia vazia. A ausência de raw ou um valor null causa um TypeError.

No exemplo, a primeira linha contém um \n literal, a segunda confirma o conteúdo da cadeia e a terceira mostra a substituição omitida entre B e C.

Exemplos

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));

Resultado

Hello\nAda!
true
A7BC

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes