Saltar al contenido
Metaprogramación

Template tags

Lección 4 de 49 min4 ejercicios

Si pones el nombre de una función pegado a un template literal, miTag`Hola, ${nombre}`, el template no se arma solo: se le entrega a la función, separado en sus partes, y ella decide qué devolver. Esa pequeña sintaxis está detrás de muchas librerías populares de estilos, HTML y SQL.

Qué recibe un tag

function inspeccionar(textos, ...valores) {
  console.log(textos);
  console.log(valores);
  return "lo que yo quiera";
}

const nombre = "Ana";
const edad = 31;
console.log(inspeccionar`Hola, ${nombre}. Tienes ${edad} años.`);
  • El primer argumento es un array con los trozos de texto fijo.
  • Después, cada valor interpolado, como un argumento aparte (con ...valores los juntas).
  • Siempre hay un trozo más que valores: si el template empieza o termina con un valor, el trozo correspondiente es "".
  • Puede devolver cualquier cosa, no solo un texto.

Para rearmar el texto, se alternan trozos y valores:

function mayusculas(textos, ...valores) {
  return textos.reduce((acc, t, i) => acc + String(valores[i - 1]).toUpperCase() + t);
}

const fruta = "mango";
console.log(mayusculas`Quiero un ${fruta} y un ${"kiwi"}, por favor.`);

Texto crudo y String.raw

El array de textos tiene además una propiedad raw, con los trozos tal como se escribieron, sin interpretar las secuencias de escape. String.raw es un tag del lenguaje que la usa:

console.log("C:\nuevo");             // \n se convierte en un salto de línea
console.log(String.raw`C:\nuevo`);   // se queda como \n
console.log(String.raw`\d+\.\d+`);   // útil para armar expresiones regulares

Usos reales

Escapar HTML: el texto fijo lo escribió el programador; los valores pueden venir de cualquier lado. Un tag los recibe por separado y puede escapar solo los valores. Lo vas a escribir en el laboratorio.

Consultas seguras: en lugar de devolver un texto, el tag devuelve la consulta con marcadores y los valores aparte, para que la base de datos nunca los confunda con código:

function sql(textos, ...valores) {
  return {
    texto: textos.join("?"),
    parametros: valores,
  };
}

const email = "ana@mail.com'; DROP TABLE usuarios; --";
console.log(sql`SELECT * FROM usuarios WHERE email = ${email}`);

Quitar la sangría de textos de varias líneas escritos dentro del código:

function sinSangria(textos, ...valores) {
  const texto = String.raw({ raw: textos }, ...valores);
  const lineas = texto.split("\n").filter((l, i, arr) => !((i === 0 || i === arr.length - 1) && !l.trim()));
  const minimo = Math.min(...lineas.filter((l) => l.trim()).map((l) => l.match(/^ */)[0].length));
  return lineas.map((l) => l.slice(minimo)).join("\n");
}

const mensaje = sinSangria`
    Hola, Ana:
      Tu pedido llegó.
    Saludos.
  `;
console.log(mensaje);

Resumen

  • tag`plantilla` llama a tag con los trozos de texto y, aparte, los valores.
  • Siempre hay un trozo más que valores; el tag puede devolver cualquier cosa.
  • textos.raw tiene los trozos sin interpretar los escapes; String.raw es el tag que los usa.
  • Usos: escapar HTML, consultas seguras, estilos, traducciones, quitar sangrías.
  • Ojo: con paréntesis, tag(`…`), el template se arma antes y la función recibe un texto normal.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Funciones pegadas a un template

Elige una respuesta en cada pregunta.

  1. ¿Qué recibe una función usada como tag: tag`Hola, ${nombre}!`?

  2. ¿Tiene que devolver un texto una función tag?

  3. ¿Qué hace String.raw`C:\nuevo`?

  4. ¿Por qué un tag es más seguro que un template normal para armar HTML?

Ordena la salida: Lo que recibe el tag

Un tag que cuenta lo que recibe, y String.raw. Ordena lo que aparecería en la consola.

function ver(textos, ...valores) {  console.log(textos.length, valores.length);  return textos.raw.join("|");} console.log(ver`a${1}b${2}c`);console.log(ver`${"x"}`);console.log(String.raw`C:\nuevo\tabla`);

Consola, de arriba abajo

  1. |
  2. a|b|c
  3. C:\nuevo\tabla
  4. 3 2
  5. 2 1

Detective: Un tag llamado con paréntesis

El tag está bien escrito, pero falla al usarlo. Encuentra la línea y elige el arreglo.

Consola

resaltar.js:2
  return textos.reduce((acc, t, i) => acc + t + (i < valores.length ? `*${valores[i]}*` : ""), "");
                ^

TypeError: textos.reduce is not a function

Paso 1: toca la línea de código que causa el error.

Laboratorio: HTML sin sorpresas

Escribe el tag html, que escape los valores pero no el texto fijo.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Escapa el valor y deja intacto el HTML fijo (pendiente)
  • Funciona con varios valores y con números (pendiente)
  • Es una función tag: recibe los textos y los valores por separado (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.