CKTIS / JavaScript
String.prototype.normalize — normalização Unicode
normalize() devolve texto numa forma de normalização Unicode escolhida. Ajuda a comparar representações equivalentes de caracteres e suporta NFC, NFD, NFKC e NFKD; NFC é a forma predefinida.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
str.normalize(form = "NFC")String.prototype.normalize devolve uma cadeia normalizada sem alterar a entrada. Textos aparentemente idênticos podem conter sequências diferentes de pontos de código: "\u00E9" e "e\u0301" representam é, mas não são iguais com ===. Antes de os comparar, normaliza ambos para a mesma forma.
"NFD" efetua uma decomposição canónica; "NFC" também compõe caracteres nos casos previstos pelo Unicode. "NFKD" efetua uma decomposição de compatibilidade, enquanto "NFKC" acrescenta a composição canónica. As formas de compatibilidade podem eliminar distinções importantes: a ligatura "\uFB00" passa a "ff". Escolhe-as com cuidado; não são uma limpeza universal do texto.
Se form for omitido ou se for passado undefined, é escolhida a forma "NFC". Caso contrário, o método tenta converter form numa cadeia. Se for passado um Symbol, a conversão lança um TypeError. Se a conversão for bem-sucedida, mas a cadeia resultante não corresponder exatamente a nenhum dos valores "NFC", "NFD", "NFKC" ou "NFKD", o método lança um RangeError. As maiúsculas e minúsculas são relevantes. O recetor é convertido numa cadeia, mas um recetor null ou undefined provoca um TypeError.
A normalização não é uma conversão entre maiúsculas e minúsculas nem uma remoção geral de acentos. Pode alterar length, que conta unidades de código UTF-16 e não caracteres visíveis. É um método da linguagem ECMAScript, não uma API DOM; a disponibilidade no navegador de destino deve ser verificada independentemente da versão de Node utilizada pelo projeto.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.