String.prototype.normalize()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. Itâs been available across browsers since septiembre de 2016.
El método normalize() retorna la Forma de Normalización Unicode de la cadena dada (si el valor no es una cadena, primero será convertido a ese tipo).
Sintaxis
str.normalize([form])
Parámetros
form-
Uno de
"NFC","NFD","NFKC", o"NFKD", especificando la Forma de Normalización Unicode. Si es omitida oundefined, se utiliza"NFC".NFCâ Forma de Normalización de Composición Canónica.NFDâ Forma de Normalización de Descomposición Canónica.NFKCâ Forma de Normalización de Composición de Compatibilidad.NFKDâ Forma de Normalización de Descomposición de Compatibilidad.
Valor de retorno
Una cadena que contiene la Forma de Normalización Unicode de la cadena dada.
Errores lanzados
RangeError-
Un error
RangeErrores lanzado siformno es uno de los valores especificados arriba.
Descripción
El método normalize() retorna la Forma de Normalización Unicode de una cadena. No afecta el valor de la cadena en sà misma.
Ejemplos
Uso de normalize()
js
// Cadena inicial
// U+1E9B: LETRA S LATINA MINÃSCULA CON PUNTO ARRIBA
// U+0323: COMBINACIÃN CON PUNTO ABAJO
var str = "\u1E9B\u0323";
// Forma compuesta canónicamente (NFC)
// U+1E9B: LETRA S LATINA MINÃSCULA CON PUNTO ARRIBA
// U+0323: COMBINACIÃN CON PUNTO ABAJO
str.normalize("NFC"); // '\u1E9B\u0323'
str.normalize(); // lo mismo que arriba
// Forma canónicamente descompuesta (NFD)
// U+017F: LETRA S LATINA MINÃSCULA
// U+0323: COMBINACIÃN CON PUNTO ABAJO
// U+0307: COMBINACIÃN CON PUNTO ARRIBA
str.normalize("NFD"); // '\u017F\u0323\u0307'
// Compuesta con compatibilidad (NFKC)
// U+1E69: LETRA S LATINA MINÃSCULA CON PUNTO ARRIBA Y ABAJO
str.normalize("NFKC"); // '\u1E69'
// Descompuesta con compatibilidad (NFKD)
// U+0073: LETRA S LATINA MINÃSCULA
// U+0323: COMBINACIÃN CON PUNTO ABAJO
// U+0307: COMBINACIÃN CON PUNTO ARRIBA
str.normalize("NFKD"); // '\u0073\u0323\u0307'
Especificaciones
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.normalize |