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
...valoreslos 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 atagcon los trozos de texto y, aparte, los valores.- Siempre hay un trozo más que valores; el tag puede devolver cualquier cosa.
textos.rawtiene los trozos sin interpretar los escapes;String.rawes 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
Resuelto
Elige una respuesta en cada pregunta.
¿Qué recibe una función usada como tag:
tag`Hola, ${nombre}!`?¿Tiene que devolver un texto una función tag?
¿Qué hace
String.raw`C:\nuevo`?¿Por qué un tag es más seguro que un template normal para armar HTML?
Ordena la salida: Lo que recibe el tag
Resuelto
Un tag que cuenta lo que recibe, y String.raw. Ordena lo que aparecería en la consola.
1function ver(textos, ...valores) {2 console.log(textos.length, valores.length);3 return textos.raw.join("|");4}5 6console.log(ver`a${1}b${2}c`);7console.log(ver`${"x"}`);8console.log(String.raw`C:\nuevo\tabla`);Consola, de arriba abajo
- |
- a|b|c
- C:\nuevo\tabla
- 3 2
- 2 1
Con dos valores hay tres trozos de texto: "a", "b" y "c". Un template que empieza y termina con un valor tiene dos trozos vacíos. String.raw deja las barras invertidas tal cual: no hay salto de línea ni tabulador.
Detective: Un tag llamado con paréntesis
Resuelto
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 functionPaso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: HTML sin sorpresas
Resuelto
Escribe el tag html, que escape los valores pero no el texto fijo.
$ node programa.js
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)
Una solución
1function escapar(valor) {2 return String(valor)3 .replaceAll("&", "&")4 .replaceAll("<", "<")5 .replaceAll(">", ">")6 .replaceAll('"', """);7}8 9function html(textos, ...valores) {10 let resultado = textos[0];11 valores.forEach((v, i) => {12 resultado += escapar(v) + textos[i + 1];13 });14 return resultado;15}16 17const nombre = '<img src=x onerror="alert(1)">';18console.log(html`<p class="saludo">Hola, ${nombre}</p>`);El texto fijo lo escribió el programador y es de confianza; los valores pueden venir de cualquier lado. Un tag puede tratarlos distinto porque los recibe por separado. Es la idea detrás de las librerías que protegen contra la inyección de HTML y de SQL.