[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/String/fromCharCode [Back]  [Original]

String.fromCharCode() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

String.fromCharCode()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

La mthode statique String.fromCharCode() renvoie une chane de caractres cre partir de points de code UTF-16.

Dans cet article

Exemple interactif

console.log(String.fromCharCode(189, 43, 190, 61));
// Expected output: "+="

Syntaxe

js
String.fromCharCode(num1, ..., numN)

Paramtres

num1, ..., numN

Une squence de nombres reprsentant des points de code UTF-16 entre 0 et 65535 (0xFFFF). Les nombres suprieurs 0xFFFF sont tronqus.

Valeur de retour

Une chane de caractres qui contient les caractres correspondants la srie de points de code UTF-16.

Description

Cette mthode renvoie une chane de caractre et non un objet String.

La mthode fromCharCode() tant une mthode statique de l'objet String, elle doit toujours tre utilise avec la syntaxe String.fromCharCode() plutt qu'en appelant la mthode partir d'un objet String construit sur mesure.

Exemples

Pour les caractres du plan multilingue de base, UTF-16 utilise une seule unit de code :

js
String.fromCharCode(65, 66, 67); // ABC
String.fromCharCode(0x2014); // ""
String.fromCharCode(0x12014); // "" galement, le 1 a t tronqu
String.fromCharCode(8212); // renvoie galement "" car 8212
// est la forme dcimale

Les caractres hors de ce plan utilisent deux units de code (on parle de surrogate pair) :

js
String.fromCharCode(0xd83c, 0xdf03); // Point de code U+1F303 pour l'moji nuit toile

// Forme dcimale quivalente :
String.fromCharCode(55356, 57091);

String.fromCharCode(0xd834, 0xdf06, 0x61, 0xd834, 0xdf07);
// "\uD834\uDF06a\uD834\uDF07"

Utiliser des valeurs Unicode plus grandes

En UTF-16, les caractres les plus communs sont reprsentables sur une seule valeur de 16 bits. Toutefois, cet ensemble de caractres (aussi appel plan multilingue de base ou BMP en anglais) ne reprsente qu'1/17e de l'espace total reprsent par les caractres Unicode. Le reste des points de code, sur l'intervalle 65536 (0x010000) 1114111 (0x10FFFF) sont des caractres additionnels qui sont reprsents par deux valeurs sur 16 bits qu'on appelle surrogate pairs en anglais.

La mthode fromCharCode() ne fonctionne qu'avec des valeurs sur 16 bits et il faudra donc fournir une paire de codets pour obtenir certains caractres. Ainsi, String.fromCharCode(0xD83C, 0xDF03) renvoie le point de code U+1F303 qui reprsente l'moji nuit toile .

Bien qu'il y ait une relation mathmatique entre la valeur compose et les deux codets qui forment la paire, on a besoin d'une tape supplmentaire chaque fois. Aussi, il sera plus pratique d'utiliser String.fromCodePoint() (ES2015 / ES6) qui permet de manipuler les codes des caractres hors BMP : on pourra ainsi crire String.fromCodePoint(0x1F303) pour renvoyer le caractre U+1F303 (moji nuit toile ).

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-string.fromcharcode

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page