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.