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

CKTIS / JavaScript

String.prototype.normalize — normalización Unicode

normalize() devuelve texto en una forma de normalización Unicode seleccionada. Ayuda a comparar representaciones equivalentes de caracteres y admite NFC, NFD, NFKC y NFKD; NFC es la opción predeterminada.

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

str.normalize(form = "NFC")

String.prototype.normalize devuelve una cadena normalizada sin modificar la entrada. Dos textos aparentemente idénticos pueden contener secuencias distintas de puntos de código: "\u00E9" y "e\u0301" representan é, pero no son iguales con ===. Antes de compararlos, normaliza ambos lados a la misma forma.

"NFD" realiza una descomposición canónica; "NFC" también compone caracteres cuando Unicode así lo especifica. "NFKD" realiza una descomposición de compatibilidad, mientras que "NFKC" añade la composición canónica. Las formas de compatibilidad pueden eliminar distinciones significativas: la ligadura "\uFB00" se convierte en "ff". Elígelas conscientemente; no son una limpieza universal del texto.

Si se omite form o se pasa undefined, se selecciona "NFC". En caso contrario, el método intenta convertir form en una cadena. Si se pasa un Symbol, la conversión lanza un TypeError. Si la conversión se completa pero la cadena resultante no coincide exactamente con ninguno de los valores "NFC", "NFD", "NFKC" o "NFKD", el método lanza un RangeError. Las mayúsculas y minúsculas importan. El receptor se convierte en una cadena, pero un receptor null o undefined provoca un TypeError.

La normalización no es una conversión de mayúsculas y minúsculas ni una eliminación general de acentos. Puede cambiar length, que cuenta unidades de código UTF-16 y no caracteres visibles. Es un método del lenguaje ECMAScript, no una API del DOM; la disponibilidad en el navegador de destino debe comprobarse independientemente de la versión de Node utilizada por el proyecto.

Ejemplos

const composed = "\u00E9";
const decomposed = "e\u0301";
console.log(composed === decomposed);
console.log(composed.normalize() === decomposed.normalize());
console.log(composed.length, decomposed.length);
console.log(composed.normalize("NFD").length);
console.log("\uFB00".normalize("NFKC") === "ff");

Resultado

false
true
1 2
2
true

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.

Fuentes