CKTIS / JavaScript
Sintaxis de los literales de plantilla
Los literales de plantilla permiten escribir texto de varias líneas e interpolar expresiones. Una función de etiqueta recibe por separado los fragmentos de texto y los valores de sustitución.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`Los literales de plantilla se delimitan con acentos graves (backticks), no con comillas simples ni dobles. Los saltos de línea normales y la sangría del texto forman parte del resultado. Para escribir un acento grave literal, antepón una barra invertida. Escribe \${ para incluir ${ sin iniciar una sustitución.
En un literal sin etiqueta, JavaScript evalúa las expresiones de ${expression} de izquierda a derecha y convierte cada valor en una cadena antes de pasar a la siguiente expresión. El resultado es una cadena. Interpolar directamente un valor de tipo Symbol lanza TypeError; si necesitas su representación textual, usa String(value) de forma explícita.
En una plantilla etiquetada, tag`...` llama a una función sin paréntesis. Su primer argumento, parts, es un array congelado de fragmentos de texto procesados, incluidos los vacíos: n sustituciones dan n + 1 fragmentos. Los demás argumentos son los valores de sustitución, sin conversión automática a cadenas. El valor que devuelva la función será el resultado de la expresión. Las evaluaciones repetidas en el mismo punto del código fuente y en el mismo realm de JavaScript reutilizan el mismo array.
El array congelado parts.raw contiene los fragmentos sin interpretar las secuencias de escape. Los finales de línea CRLF y CR del código fuente se convierten en LF en ambas formas. Una secuencia de escape inválida como \xG provoca SyntaxError sin etiqueta; con etiqueta, el fragmento procesado correspondiente vale undefined y el fragmento sin procesar conserva la secuencia.
Es sintaxis de JavaScript, no una API del DOM; comprueba si el entorno de ejecución de destino la admite. La interpolación no escapa los valores para HTML. Para mostrar texto no fiable en un elemento normal de la página, usa textContent, no innerHTML.
Ejemplos
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"]
El literal sin etiqueta imprime dos líneas. En el resultado de la función de etiqueta, el primer `true` indica que el fragmento procesado empieza con un salto de línea; el segundo indica que el fragmento sin procesar empieza con dos caracteres: una barra invertida y `n`. `"number"` confirma que la función recibió un número.
Lecciones relacionadas
- JavaScript · Lección 23 · Avanzado · Versión: 4
- JavaScript · Lección 24 · Avanzado · Versión: 4
- JavaScript · Lección 25 · Avanzado · Versión: 4
- JavaScript · Lección 31 · Avanzado · Versión: 4
- JavaScript · Lección 32 · Avanzado · Versión: 4
- JavaScript · Lección 35 · Avanzado · Versión: 4
- JavaScript · Lección 40 · Avanzado · Versión: 4
- JavaScript · Lección 41 · Avanzado · Versión: 4
- JavaScript · Lección 42 · Avanzado · Versión: 4
- JavaScript · Lección 43 · Avanzado · Versión: 4