Accueil >JavaScript >Référence JS – méthodes et objets >String()

String()

String(value)

Convertit une valeur en chaîne. Contrairement à value.toString(), elle fonctionne aussi pour null et undefined.

Paramètres

  • value – valeur à convertir.

Valeur de retour

Une chaîne.

Exemples

console.log(String(17.9), String(true), String(null), String(undefined));
console.log(String([1, 2]), String({ a: 1 }), String(Symbol('id')));
try {
  null.toString();
} catch (e) {
  console.log(e.name);
}

Résultat :

17.9 true null undefined
1,2 [object Object] Symbol(id)
TypeError

Points d’attention

  • Un objet devient [object Object] – pour afficher des données, utilisez JSON.stringify().
  • '' + value fonctionne de la même façon, mais se termine par une erreur TypeError avec un symbole.
  • new String('x') crée un objet, et non une chaîne – ne l’utilisez pas.

Prise en charge par les navigateurs

Baseline – largement disponible : fonctionne dans tous les navigateurs courants, et depuis longtemps (au plus tard depuis 2015). Depuis la version : Chrome 1, Firefox 1, Safari 1 ; Node.js 0.10.0. État : octobre 2026 (MDN browser-compat-data).

Voir aussi :
Littéraux de gabarits
String.prototype.concat()