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

CKTIS / JavaScript

Sintaxe dos literais de modelo

Os literais de modelo permitem escrever texto com várias linhas e interpolar expressões. Uma função de etiqueta recebe separadamente os segmentos de texto e os valores de substituição.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`

Os literais de modelo são delimitados por acentos graves (backticks), e não por aspas simples ou duplas. As quebras de linha normais e a indentação do texto fazem parte do resultado. Para escrever um acento grave literal, coloca uma barra invertida antes dele. Escreve \${ para incluir ${ sem iniciar uma substituição.

Num literal sem etiqueta, o JavaScript avalia as expressões em ${expression} da esquerda para a direita e converte cada valor numa cadeia de caracteres antes de passar à expressão seguinte. O resultado é uma cadeia de caracteres. Interpolar diretamente um valor do tipo Symbol lança TypeError; se precisares da sua representação textual, usa explicitamente String(value).

Num modelo com etiqueta, tag`...` chama uma função sem parênteses. O primeiro argumento, parts, é um array congelado de segmentos de texto processados, incluindo os vazios: n substituições dão n + 1 segmentos. Os restantes argumentos são os valores de substituição, sem conversão automática em cadeias de caracteres. O valor devolvido pela função é o resultado da expressão. Avaliações repetidas no mesmo ponto do código-fonte e no mesmo realm de JavaScript reutilizam o mesmo array.

O array congelado parts.raw contém os segmentos sem interpretar as sequências de escape. As terminações de linha CRLF e CR no código-fonte passam a LF em ambas as formas. Uma sequência de escape inválida como \xG provoca SyntaxError sem etiqueta; com etiqueta, o segmento processado afetado tem o valor undefined e o segmento não processado mantém a sequência.

É sintaxe de JavaScript, não uma API do DOM; verifica se o ambiente de execução de destino a suporta. A interpolação não escapa os valores para HTML. Para apresentar texto não fiável num elemento normal da página, usa textContent, não innerHTML.

Exemplos

const count = 2;
const message = `Total: ${count + 1}
Ready`;

function inspect(parts, value) {
  return [parts[1].startsWith("\n"), parts.raw[1].startsWith("\\n"), typeof value];
}

console.log(message);
console.log(JSON.stringify(inspect`Total: ${count + 1}\nReady`));

Resultado

Total: 3
Ready
[true,true,"number"]

O literal sem etiqueta imprime duas linhas. No resultado da função de etiqueta, o primeiro `true` indica que o segmento processado começa com uma quebra de linha; o segundo indica que o segmento não processado começa com dois caracteres: uma barra invertida e `n`. `"number"` confirma que a função recebeu um número.

Lições relacionadas

  • JavaScript · Lição 23 · Avançado · Versão: 4
  • JavaScript · Lição 24 · Avançado · Versão: 4
  • JavaScript · Lição 25 · Avançado · Versão: 4
  • JavaScript · Lição 31 · Avançado · Versão: 4
  • JavaScript · Lição 32 · Avançado · Versão: 4
  • JavaScript · Lição 35 · Avançado · Versão: 4
  • JavaScript · Lição 40 · Avançado · Versão: 4
  • JavaScript · Lição 41 · Avançado · Versão: 4
  • JavaScript · Lição 42 · Avançado · Versão: 4
  • JavaScript · Lição 43 · Avançado · Versão: 4

Fontes