Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Literales de plantilla en JavaScript

Crea cadenas de varias líneas e inserta resultados de expresiones. Aprende cuándo JavaScript genera una cadena y cuándo pasa los fragmentos y valores a una función de etiqueta.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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

Los literales de plantilla se delimitan con acentos graves (backticks), no con comillas. Un marcador ${expression} contiene una expresión. Sin etiqueta, JavaScript evalúa las expresiones de izquierda a derecha, convierte cada resultado en una cadena y lo une al texto. Interpolar directamente un valor de tipo Symbol lanza un TypeError. Los saltos de línea y la sangría del texto literal pasan a formar parte de la cadena. Usa \` para insertar un acento grave y \${ para escribir ${ sin abrir un marcador.

Una función situada justo antes del acento grave de apertura se invoca como etiqueta (tag). Su primer argumento es un array congelado de fragmentos de texto procesados (cooked), incluidos los vacíos. Los demás argumentos son los valores de las expresiones, sin conversión automática a cadenas. Lo que devuelve la función es el resultado de toda la expresión y no tiene por qué ser una cadena. Al reevaluar la misma aparición del literal en el mismo entorno global (realm), se reutiliza el mismo array en lugar de crear una copia.

En un fragmento procesado, \n representa un salto de línea. El array congelado parts.raw conserva ahí la barra inversa y la letra n. Una secuencia de escape no válida como \xZ provoca un SyntaxError sin etiqueta; con etiqueta, el fragmento procesado correspondiente vale undefined y la forma sin procesar sigue disponible. La etiqueta incorporada String.raw une los fragmentos sin procesar con los valores de las sustituciones convertidos en cadenas.

La interpolación no escapa datos para HTML y una etiqueta no hace seguro el resultado por sí sola. Para mostrar datos no confiables como texto plano en un elemento destinado a mostrar texto, como <p> o <span>, usa textContent, no innerHTML. En un elemento <script>, asignar un valor a textContent establece el código fuente del script en lugar de mostrar texto. Los literales de plantilla son sintaxis de ECMAScript y no requieren el DOM; comprueba su compatibilidad en el entorno de ejecución de destino.

Ejemplos

{
  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]

La primera línea muestra una cadena de varias líneas. La segunda compara los fragmentos procesado y sin procesar. `JSON.stringify` hace visible la diferencia entre un salto de línea y un `\n` literal; el número `5` sigue sin comillas.

Lecciones relacionadas

  • JavaScript · Lección 1 · Avanzado · Versión: 4
  • JavaScript · Lección 4 · Avanzado · Versión: 4
  • JavaScript · Lección 5 · Avanzado · Versión: 4
  • JavaScript · Lección 6 · Avanzado · Versión: 4
  • JavaScript · Lección 7 · Avanzado · Versión: 4
  • JavaScript · Lección 8 · Avanzado · Versión: 4
  • JavaScript · Lección 10 · Avanzado · Versión: 4
  • JavaScript · Lección 11 · Avanzado · Versión: 4
  • JavaScript · Lección 14 · Avanzado · Versión: 4
  • JavaScript · Lección 16 · Avanzado · Versión: 4
  • JavaScript · Lección 17 · Avanzado · Versión: 4
  • JavaScript · Lección 18 · Avanzado · Versión: 4
  • JavaScript · Lección 17 · Intermedio · Versión: 3
  • JavaScript · Lección 19 · Intermedio · Versión: 3
  • JavaScript · Lección 20 · Intermedio · Versión: 3
  • JavaScript · Lección 21 · Intermedio · Versión: 3
  • JavaScript · Lección 22 · Intermedio · Versión: 3
  • JavaScript · Lección 23 · Intermedio · Versión: 3
  • JavaScript · Lección 25 · Intermedio · Versión: 3
  • JavaScript · Lección 28 · Intermedio · Versión: 3
  • JavaScript · Lección 30 · Intermedio · Versión: 3
  • JavaScript · Lección 31 · Intermedio · Versión: 3
  • JavaScript · Lección 33 · Intermedio · Versión: 3
  • JavaScript · Lección 35 · Intermedio · Versión: 3
  • JavaScript · Lección 38 · Intermedio · Versión: 3
  • JavaScript · Lección 42 · Intermedio · Versión: 3

Fuentes