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

CKTIS / JavaScript

Sintaxis de los literales de plantilla etiquetados

La función de etiqueta recibe por separado los fragmentos de texto y los valores de sustitución. Su retorno es el valor de toda la expresión.

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

Sintaxis

tag`prefix ${expression} suffix`
obj.tag`prefix ${expression} suffix`

function tag(strings, ...values) { /* process the parts and return a value */ }

En tag`prefix ${expression} suffix` , la expresión tag precede a un literal delimitado por acentos graves. JavaScript invoca la etiqueta sin construir primero una cadena. En tag(`prefix ${expression} suffix`), en cambio, el literal sin etiqueta convierte los valores de sustitución en cadenas y los une al texto: la función recibe una sola cadena ya construida.

El primer argumento de la etiqueta es el arreglo strings de fragmentos literales. JavaScript evalúa las expresiones ${...} de izquierda a derecha antes de la llamada y pasa sus valores como argumentos separados, sin convertirlos en cadenas. Un parámetro rest como ...values permite recogerlos. Con n sustituciones hay n + 1 fragmentos, incluidos los vacíos. El valor de la expresión es lo que devuelve la etiqueta, que no tiene por qué ser una cadena.

En strings[i] se interpretan las secuencias de escape (cooked); strings.raw[i] conserva cómo se escribieron. Una secuencia de escape mal formada hace que todo el elemento correspondiente de strings valga undefined en un literal etiquetado; sin etiqueta, provoca un SyntaxError. Ambos arreglos están congelados. Las evaluaciones repetidas de la misma aparición del literal en el mismo realm de ECMAScript reutilizan el mismo arreglo strings. Otra aparición tiene su propio arreglo, aunque el texto sea idéntico.

En obj.tag`x` , la llamada pasa obj como valor de this, igual que en una llamada normal a un método. Si el valor de la etiqueta no es invocable, se produce un TypeError. El uso directo del encadenamiento opcional, como en obj?.tag`x` , provoca un SyntaxError.

Es sintaxis del lenguaje definida en ECMAScript 2024, no una API del navegador. Comprueba la compatibilidad del entorno de ejecución de destino. Una etiqueta no sanea los datos por sí sola: no pases resultados no confiables a innerHTML sin un saneamiento adecuado del HTML.

Ejemplos

function inspect(strings, value) {
  return {
    cookedLength: strings[0].length,
    rawLength: strings.raw[0].length,
    valueType: typeof value,
    tail: strings[1],
  };
}

console.log(JSON.stringify(inspect`\n${7}`));

Resultado

{"cookedLength":1,"rawLength":2,"valueType":"number","tail":""}

`inspect` devuelve un objeto que `JSON.stringify` convierte en cadena para mostrarlo. `\n` es un solo carácter de salto de línea en `strings[0]`, pero dos caracteres en `strings.raw[0]`. El valor `7` sigue siendo un número y el último fragmento está vacío.

Lecciones relacionadas

  • JavaScript · Lección 28 · Avanzado · Versión: 4

Fuentes