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

CKTIS / JavaScript

String.prototype.toString() — récupérer une valeur chaîne

String.prototype.toString() renvoie la valeur chaîne primitive d’une chaîne ou d’un objet String. Ce n’est pas un convertisseur général : une valeur this incompatible entraîne une TypeError.

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

stringValue.toString()
String.prototype.toString.call(value)

Le symbole de catalogue String.toString désigne ici String.prototype.toString(), appelée sur une valeur chaîne. Ne la confondez pas avec l’expression String.toString(), qui appelle une méthode sur la fonction String elle-même.

La méthode ne prend aucun paramètre. Pour une chaîne primitive, elle renvoie cette même valeur ; pour un objet créé avec new String(...), elle récupère le texte depuis l’emplacement interne [[StringData]]. Le résultat est une primitive de type string, et non un objet. La méthode intégrée String.prototype.valueOf() renvoie la même valeur.

La méthode n’est pas générique : String.prototype.toString.call(42) déclenche une TypeError, tout comme les appels avec null, undefined ou un objet ordinaire dépourvu de [[StringData]]. La simple présence d’une méthode toString personnalisée ne suffit pas. L’exemple montre des récepteurs valides et intercepte volontairement l’erreur pour un nombre.

Exemples

const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();

console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());

try {
  String.prototype.toString.call(42);
} catch (error) {
  console.log(error instanceof TypeError);
}

Résultat

true
hello string
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