Cette fonction, proposition pour ECMAScript 6 (Harmony), est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
Résumé
La méthode normalize() permet de renvoyer la forme normalisée Unicode d'une chaîne de caractères (si la valeur n'est pas une chaîne de caractèrs, elle sera convertie).
Syntaxe
str.normalize([form]);
Paramètres
form- Paramètre optionnel. Une chaîne parmi "NFC", "NFD", "NFKC", or "NFKD", définissant la forme de normalisation Unicode à utiliser. Si le paramètre n'est pas précisé ou vaut
undefined, la valeur par défaut utilisée sera "NFC".NFC- Normalization Form Canonical Composition.NFD- Normalization Form Canonical Decomposition.NFKC- Normalization Form Compatibility Composition.NFKD- Normalization Form Compatibility Decomposition.
Exception levée
RangeError- Une exception
RangeErrorest envoyée si le paramètreformn'est pas une des valeurs définies ci-avant.
Description
La méthode normalize() renvoie la forme normalisée Unicode de la chaîne de caractères. Elle n'affecte pas la valeur de la chaîne.
Exemple
Utiliser la méthode normalize()
// Chaîne initiale
// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
var str = "\u1E9B\u0323";
// Forme canonique composée (Canonically-composed form) (NFC)
// U+1E9B: LATIN SMALL LETTER LONG S WITH DOT ABOVE
// U+0323: COMBINING DOT BELOW
str.normalize("NFC"); // "\u1E9B\u0323"
str.normalize(); // la même chaîne que précédemment
// Forme canonique décomposée (Canonically-decomposed form) (NFD)
// U+017F: LATIN SMALL LETTER LONG S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize("NFD"); // "\u017F\u0323\u0307"
// Forme composée compatible (NFKC)
// U+1E69: LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE
str.normalize("NFKC"); // "\u1E69"
// Forme décomposée compatible (NFKD)
// U+0073: LATIN SMALL LETTER S
// U+0323: COMBINING DOT BELOW
// U+0307: COMBINING DOT ABOVE
str.normalize("NFKD"); // "\u0073\u0323\u0307"
Spécifications
| Spécification | Statut | Commentaires |
|---|---|---|
| ECMAScript 6 (ECMA-262) La définition de 'String.prototype.normalize' dans cette spécification. |
Draft | Définition initiale. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support simple | 34 | 31 (31) | 11 sur Windows 10 Preview | (Oui) | Pas de support |
| Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | Pas de support | 34 | Pas de support bug 864843 |
Pas de support | Pas de support | Pas de support |