CKTIS / JavaScript
String.prototype.normalize — normalizzazione Unicode
normalize() restituisce testo in una forma di normalizzazione Unicode selezionata. Aiuta a confrontare rappresentazioni equivalenti dei caratteri e supporta NFC, NFD, NFKC e NFKD; NFC è il valore predefinito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
str.normalize(form = "NFC")String.prototype.normalize restituisce una stringa normalizzata senza modificare l’input. Testi apparentemente identici possono contenere sequenze diverse di punti di codice: "\u00E9" e "e\u0301" rappresentano é, ma non sono uguali con ===. Prima di confrontarli, normalizza entrambi nella stessa forma.
"NFD" esegue una decomposizione canonica; "NFC" compone anche i caratteri nei casi previsti da Unicode. "NFKD" esegue una decomposizione di compatibilità, mentre "NFKC" aggiunge la composizione canonica. Le forme di compatibilità possono eliminare distinzioni significative: la legatura "\uFB00" diventa "ff". Sceglile con attenzione, non come pulizia universale del testo.
Se form viene omesso o si passa undefined, viene selezionato "NFC". Altrimenti il metodo tenta di convertire form in una stringa. Se si passa un Symbol, la conversione genera un TypeError. Se la conversione riesce ma la stringa risultante non coincide esattamente con nessuno dei valori "NFC", "NFD", "NFKC" o "NFKD", il metodo genera un RangeError. La distinzione tra maiuscole e minuscole è importante. Il ricevitore viene convertito in una stringa, ma un ricevitore null o undefined causa un TypeError.
La normalizzazione non è una conversione tra maiuscole e minuscole né una rimozione generale degli accenti. Può modificare length, che conta le unità di codice UTF-16 e non i caratteri visibili. È un metodo del linguaggio ECMAScript, non un’API DOM; la disponibilità nel browser di destinazione va verificata indipendentemente dalla versione di Node usata dal progetto.
Esempi
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");Risultato
false true 1 2 2 true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.