Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources