CKTIS / JavaScript
String.raw — segmentos sin procesar de literales de plantilla
String.raw es un método estático que se usa como etiqueta de un literal de plantilla. Conserva la escritura de secuencias como \n en los segmentos de texto literales, pero sigue evaluando las expresiones ${...} e insertando sus valores.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
String.raw`text${expression}text`
String.raw(template, ...substitutions)String.raw es un método estático, no un método de una cadena individual. Como etiqueta de un literal de plantilla, une los segmentos de texto literales sin procesar con las sustituciones. Una secuencia \n en un segmento literal produce una barra invertida y la letra n, no un carácter de salto de línea.
Las expresiones dentro de ${...} siguen evaluándose y sus valores se convierten en cadenas. El tratamiento sin procesar se aplica a los segmentos literales, no a las sustituciones: si un valor sustituido ya contiene un carácter de salto de línea, ese carácter sigue siendo un salto de línea. El método no deshace el procesamiento previo de secuencias de escape ni proporciona una codificación segura para HTML o SQL.
También es posible una llamada normal, String.raw(template, ...substitutions). El método lee template.raw como un objeto similar a un array e intercala sus elementos con las sustituciones. Las sustituciones que faltan no añaden nada, las adicionales se ignoran y un raw de longitud cero produce una cadena vacía. Si falta raw o su valor es null, se produce un TypeError.
En el ejemplo, la primera línea contiene un \n literal, la segunda confirma el contenido de la cadena y la tercera muestra la sustitución omitida entre B y C.
Ejemplos
const name = "Ada";
const text = String.raw`Hello\n${name}!`;
console.log(text);
console.log(text === "Hello\\nAda!");
console.log(String.raw({ raw: ["A", "B", "C"] }, 7));Resultado
Hello\nAda! true A7BC
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.