CKTIS / JavaScript
Escape de texto en HTML
Al generar HTML, escapa el texto plano según la posición en la que lo insertes. Si escribes directamente en un elemento normal del DOM, usa `textContent` con la cadena original.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const escapeHtmlText = (text) => text.replaceAll('&', '&').replaceAll('<', '<').replaceAll('>', '>');
// Use escaped text only in the ordinary text position of trusted HTML markup.
const markup = `<p>${escapeHtmlText(text)}</p>`;
// If writing directly to an ordinary DOM element, use the original string instead.
element.textContent = text;El escape en contexto de texto HTML es la codificación de salida para insertar texto plano en el código fuente HTML, por ejemplo dentro de un elemento p. Un < sin escapar puede abrir una etiqueta y & puede iniciar una referencia de carácter. El analizador convierte < en un < literal dentro del texto, sin interpretar el carácter decodificado como el inicio de una etiqueta.
Al encadenar llamadas a replaceAll, sustituye & por & antes de sustituir < por <, para no escapar los & introducidos por sustituciones posteriores. El ejemplo también sustituye > por >, algo opcional aquí; tampoco hace falta escapar las comillas en este contexto. Codifica el texto original una sola vez al insertarlo y omite la codificación manual si la plantilla ya la aplica.
Para establecer el texto de un elemento normal del DOM, asigna la cadena original a textContent. No uses innerHTML para ese fin: analiza el marcado. No reutilices esta función para atributos, URL, JavaScript ni CSS, porque tienen reglas distintas. Si necesitas conservar parte del marcado de un HTML no confiable, aplica una sanitización de HTML en vez de escaparlo como texto.
Ejemplos
function escapeHtmlText(text) {
return text.replaceAll('&', '&')
.replaceAll('<', '<')
.replaceAll('>', '>');
}
const text = 'A & B <em>demo</em> <';
console.log(`<p>${escapeHtmlText(text)}</p>`);Resultado
<p>A & B <em>demo</em> &lt;</p>
La consola muestra el código fuente HTML, no el texto renderizado. Al analizarlo se obtiene un párrafo sin ningún elemento `em`, y el `<` final queda como texto literal.
Lecciones relacionadas
- JavaScript · Lección 28 · Avanzado · Versión: 4