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