CKTIS / JavaScript
String.prototype.normalize — normalisation Unicode
normalize() renvoie du texte sous une forme de normalisation Unicode choisie. La méthode aide à comparer des représentations équivalentes de caractères et prend en charge NFC, NFD, NFKC et NFKD ; NFC est la forme par défaut.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.normalize(form = "NFC")String.prototype.normalize renvoie une chaîne normalisée sans modifier l’entrée. Des textes qui semblent identiques peuvent contenir des séquences de points de code différentes : "\u00E9" et "e\u0301" représentent é, mais ne sont pas égaux avec ===. Avant de les comparer, normalisez les deux côtés dans la même forme.
"NFD" effectue une décomposition canonique ; "NFC" compose aussi les caractères lorsque Unicode le prévoit. "NFKD" effectue une décomposition de compatibilité, tandis que "NFKC" y ajoute la composition canonique. Les formes de compatibilité peuvent supprimer des distinctions importantes : la ligature "\uFB00" devient "ff". Utilisez-les avec discernement, et non comme un nettoyage universel du texte.
Si form est omis ou si undefined est passé, la forme choisie est "NFC". Sinon, la méthode tente de convertir form en chaîne. Passer un Symbol déclenche une TypeError lors de cette conversion. Si la conversion réussit, mais que la chaîne obtenue n’est pas exactement l’une des valeurs "NFC", "NFD", "NFKC" ou "NFKD", la méthode déclenche une RangeError. La casse est importante. Le récepteur est converti en chaîne, mais un récepteur null ou undefined provoque une TypeError.
La normalisation n’est ni une conversion de casse ni une suppression générale des accents. Elle peut modifier length, qui compte les unités de code UTF-16 et non les caractères visibles. Il s’agit d’une méthode du langage ECMAScript, et non d’une API DOM ; sa disponibilité dans le navigateur cible doit être vérifiée indépendamment de la version de Node utilisée par le projet.
Exemples
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");Résultat
false true 1 2 2 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.