Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.fromCodePoint — créer du texte à partir de points de code

String.fromCodePoint crée une chaîne à partir de points de code Unicode, y compris ceux supérieurs à 0xFFFF. Ils sont automatiquement encodés en UTF-16 ; les valeurs numériques non valides provoquent une erreur RangeError.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

String.fromCodePoint(...codePoints)

String.fromCodePoint(...codePoints) est une méthode statique de String, et non une méthode d’une chaîne individuelle. Elle renvoie une chaîne contenant les points de code fournis, dans l’ordre des arguments. Sans argument, elle renvoie "".

Chaque argument est converti avec ToNumber. Le résultat doit être un entier compris entre 0 et 0x10FFFF, bornes incluses. Les fractions, NaN, les infinis et les valeurs hors limites provoquent une erreur RangeError. Les arguments de type BigInt ou Symbol provoquent une erreur TypeError lors de la conversion.

Contrairement à String.fromCharCode, qui accepte des unités de code UTF-16, String.fromCodePoint accepte des points de code entiers. Une valeur supérieure à 0xFFFF est encodée sous forme de paire de substituts, ce qui augmente de deux la propriété .length de la chaîne. .length compte les unités de code, et non les points de code ni les caractères visibles.

La méthode accepte aussi les valeurs de substitut 0xD800–0xDFFF ; elle ne garantit donc pas un UTF-16 bien formé. Il s’agit d’une API du langage ECMAScript, et non d’une API de navigateur. Pour vérifier sa disponibilité dans l’environnement cible, utilisez typeof String.fromCodePoint === "function".

Exemples

const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");

Résultat

A😀
3
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources