CKTIS / JavaScript
String — conversion explicite en texte
String(value) convertit une valeur en chaîne primitive. Appelée sans argument, la fonction renvoie une chaîne vide. Si la conversion réussit, new String(value) crée un objet enveloppe et non une valeur primitive.
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(value)
String()
new String(value)String est une fonction intégrée à ECMAScript, et non une API du navigateur. L’appel String(value) renvoie une chaîne primitive si la conversion réussit. Le type String représente des séquences immuables d’unités de code de 16 bits, généralement interprétées comme de l’UTF-16 ; une lettre visible ou un autre caractère ne correspond pas nécessairement à une unité de code.
Ne pas fournir d’argument n’est pas la même chose que passer undefined : String() renvoie "", tandis que String(undefined) renvoie "undefined". De même, String(null) produit "null" et String(42) produit "42". Un argument Symbol direct bénéficie d’un traitement spécial : String(Symbol("tag")) renvoie "Symbol(tag)".
Ce traitement spécial ne s’applique qu’aux appels sans new : new String(Symbol("tag")) lève une exception TypeError au lieu de créer un objet enveloppe. Si la conversion réussit, new String(value) crée un objet enveloppe. Ainsi, typeof String("hello") produit "string", tandis que typeof new String("hello") produit "object". Comparer ces valeurs avec l’égalité stricte, ===, produit false. Pour une conversion ordinaire en texte, utilisez String(value) sans new.
La conversion d’un objet peut appeler ses propres mécanismes de conversion, tels que [Symbol.toPrimitive] ou toString, et peut déclencher une exception. String(value) n’est ni une sérialisation JSON ni un moyen d’afficher en toute sécurité des objets arbitraires non fiables sans exécuter leur code.
Exemples
console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);Résultat
["","undefined","null","42"] Symbol(tag) string object false
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.