String.fromCharCode()

La méthode statique String.fromCharCode() renvoie une chaîne de caractères créée à partir de points de code UTF-16.

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

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

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

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.

Voir aussi

• String.prototype.charCodeAt()
• String.prototype.charAt()
• String.fromCodePoint()
• String.prototype.codePointAt()