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);   // "—"
String.fromCharCode(0x112014); // "—" également, la valeur a été tronquée

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

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,