Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
String.fromCodePoint()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La méthode statiqueString.fromCodePoint() renvoie une chaîne de caractères créée à partir d'un suite de codets.
Exemple interactif
console.log(String.fromCodePoint(9731, 9733, 9842, 0x2f804));// Expected output: "☃★♲你"Syntaxe
String.fromCodePoint(num1[, ...[, numN]])Paramètres
num1, ..., numNUne séquence de codets (code points).
Valeur de retour
Une chaîne de caractères créée à partir de la séquence de codets indiquée.
Exceptions
- Une exception
RangeErrorest renvoyée si un codet (Unicode) invalide est utilisé (par exemple, on pourra avoir "RangeError: NaN is not a valid code point").
Description
fromCodePoint() étant une méthode statique deString, elle doit toujours être utilisée avec la syntaxeString.fromCodePoint(), plutôt qu'avec une méthode d'un objetString qui aurait été créé.
Exemples
UtiliserfromCodePoint()
String.fromCodePoint(42); // "*"String.fromCodePoint(65, 90); // "AZ"String.fromCodePoint(0x404); // "\u0404"String.fromCodePoint(0x2f804); // "\uD87E\uDC04"String.fromCodePoint(194564); // "\uD87E\uDC04"String.fromCodePoint(0x1d306, 0x61, 0x1d307); // "\uD834\uDF06a\uD834\uDF07"String.fromCodePoint("_"); // RangeErrorString.fromCodePoint(Infinity); // RangeErrorString.fromCodePoint(-1); // RangeErrorString.fromCodePoint(3.14); // RangeErrorString.fromCodePoint(3e-2); // RangeErrorString.fromCodePoint(NaN); // RangeErrorComparaison avecfromCharCode()
La méthodeString.fromCharCode() ne peut pas renvoyer les caractères de l'intervalle 0x010000 à 0X10FFFF avec un seul codet, il est nécessaire de lui fournir la paire décomposée (surrogate pair) pour obtenr un tel caractère :
String.fromCharCode(0xd83c, 0xdf03); // émoji « nuit étoilée »String.fromCharCode(55356, 57091); // équivalent en notation décimaleString.fromCodePoint(), en revanche, peut renvoyer les caractères qui s'expriment sur plus d'un codet de 16 bits grâce à leur codet « simple » :
String.fromCodePoint(0x1f303); // ou 127747 en notation décimaleSpécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.fromcodepoint |