La méthode statique String.fromCharCode()
renvoie une chaîne de caractères créée à partir de points de code UTF-16.
Syntaxe
String.fromCharCode(num1, ..., numN)
Paramètres
num1, ..., numN
- Une séquence de nombres représentant des points de code UTF-16 entre 0 et 65535 (
0xFFFF
). Les nombres supérieurs à0xFFFF
sont tronqués.
Valeur de retour
Une chaîne de caractères qui contient les caractères correspondants à la série de points de code UTF-16.
Description
Cette méthode renvoie une chaîne de caractère et non un objet String
.
La méthode fromCharCode()
étant une méthode statique de l'objet String
, elle doit toujours être utilisée avec la syntaxe String.fromCharCode()
plutôt qu'en appelant la méthode à partir d'un objet String
construit sur mesure.
Exemples
Utiliser fromCharCode()
String.fromCharCode(65,66,67); // ABC
String.fromCharCode(0x2014); // "
Utiliser des valeurs Unicode plus grandes
Bien que la plupart des valeurs fréquentes puissent être représentées sur des nombres sur 16 bits (l'hypothèse valable qui avait été prise au début de la standardisation de JavaScript) et que fromCharCode()
puisse être utilisé pour renvoyer un caractère pour la plupart de ces valeurs (à savoir les valeurs UCS-2 qui représentent un sous-ensemble d'UTF-16 avec les caractères les plus communs), fromCharCode()
ne sera pas suffisant pour traiter l'ensemble des valeurs Unicode (jusqu'à 21 bits). Les valeurs les plus élevées peuvent représenter un seul caractère grâce à une paire de codets (surrogates), String.fromCodePoint()
(qui fait partie du standard ES2015) peut être utilisé pour renvoyer une telle paire et peut donc permettre de réprésenter ces caractères.
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) La définition de 'StringfromCharCode' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'String.fromCharCode' dans cette spécification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) La définition de 'String.fromCharCode' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.
Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Support simple | Oui | Oui | 1 | Oui | Oui | Oui |
Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
---|---|---|---|---|---|---|---|
Support simple | Oui | Oui | Oui | 4 | Oui | Oui | Oui |