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

CKTIS / JavaScript

Literais de modelo em JavaScript

Cria cadeias de caracteres com várias linhas e insere resultados de expressões. Aprende quando JavaScript produz uma cadeia e quando passa fragmentos e valores a uma função de etiqueta.

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

Sintaxe

`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`

Os literais de modelo escrevem-se entre acentos graves (backticks), em vez de aspas. Um marcador ${expression} contém uma expressão. Sem etiqueta, o JavaScript avalia as expressões da esquerda para a direita, converte cada resultado numa cadeia de caracteres e junta-o ao texto. Interpolar diretamente um valor do tipo Symbol lança um TypeError. As quebras de linha e a indentação no texto literal passam a fazer parte da cadeia. Usa \` para inserir um acento grave e \${ para escrever ${ sem abrir um marcador.

Uma função colocada imediatamente antes do acento grave de abertura é chamada como etiqueta (tag). O primeiro argumento é um array congelado de fragmentos de texto processados (cooked), incluindo os vazios. Os restantes argumentos são os valores das expressões, sem conversão automática em cadeias. O valor devolvido pela função é o resultado de toda a expressão e não tem de ser uma cadeia. Avaliar repetidamente a mesma ocorrência do literal no mesmo ambiente global (realm) reutiliza o mesmo array em vez de criar uma cópia.

Num fragmento processado, \n representa uma quebra de linha. O array congelado parts.raw conserva aí a barra invertida e a letra n. Uma sequência de escape inválida como \xZ causa um SyntaxError sem etiqueta; com etiqueta, o fragmento processado correspondente tem o valor undefined e a forma original continua disponível. A etiqueta incorporada String.raw junta os fragmentos não processados aos valores das substituições convertidos em cadeias.

A interpolação não escapa dados para HTML e uma etiqueta, por si só, não torna o resultado seguro. Para apresentar dados não fiáveis como texto simples num elemento destinado a apresentar texto, como <p> ou <span>, usa textContent, não innerHTML. Num elemento <script>, atribuir um valor a textContent define o código-fonte do script em vez de apresentar texto. Os literais de modelo fazem parte da sintaxe de ECMAScript e não precisam do DOM; verifica o suporte no ambiente de execução de destino.

Exemplos

{
  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}`));
}

Resultado

"Items: 5\nStatus: ready"
["Items:\n","Items:\\n",5]

A primeira linha mostra uma cadeia com várias linhas. A segunda compara os fragmentos processado e não processado. `JSON.stringify` torna visível a diferença entre uma quebra de linha e um `\n` literal; o número `5` mantém-se sem aspas.

Lições relacionadas

  • JavaScript · Lição 1 · Avançado · Versão: 4
  • JavaScript · Lição 4 · Avançado · Versão: 4
  • JavaScript · Lição 5 · Avançado · Versão: 4
  • JavaScript · Lição 6 · Avançado · Versão: 4
  • JavaScript · Lição 7 · Avançado · Versão: 4
  • JavaScript · Lição 8 · Avançado · Versão: 4
  • JavaScript · Lição 10 · Avançado · Versão: 4
  • JavaScript · Lição 11 · Avançado · Versão: 4
  • JavaScript · Lição 14 · Avançado · Versão: 4
  • JavaScript · Lição 16 · Avançado · Versão: 4
  • JavaScript · Lição 17 · Avançado · Versão: 4
  • JavaScript · Lição 18 · Avançado · Versão: 4
  • JavaScript · Lição 17 · Intermédio · Versão: 3
  • JavaScript · Lição 19 · Intermédio · Versão: 3
  • JavaScript · Lição 20 · Intermédio · Versão: 3
  • JavaScript · Lição 21 · Intermédio · Versão: 3
  • JavaScript · Lição 22 · Intermédio · Versão: 3
  • JavaScript · Lição 23 · Intermédio · Versão: 3
  • JavaScript · Lição 25 · Intermédio · Versão: 3
  • JavaScript · Lição 28 · Intermédio · Versão: 3
  • JavaScript · Lição 30 · Intermédio · Versão: 3
  • JavaScript · Lição 31 · Intermédio · Versão: 3
  • JavaScript · Lição 33 · Intermédio · Versão: 3
  • JavaScript · Lição 35 · Intermédio · Versão: 3
  • JavaScript · Lição 38 · Intermédio · Versão: 3
  • JavaScript · Lição 42 · Intermédio · Versão: 3

Fontes