KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.toString() — een stringwaarde ophalen

String.prototype.toString() geeft de primitieve stringwaarde van een string of String-object terug. Het is geen algemene omzetter: een incompatibele this-waarde veroorzaakt een TypeError.

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

Syntax

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

Het catalogussymbool String.toString verwijst hier naar String.prototype.toString(), aangeroepen op een stringwaarde. Verwar dit niet met de expressie String.toString(), die een methode op de functie String zelf aanroept.

De methode heeft geen parameters. Voor een primitieve string geeft ze dezelfde waarde terug; voor een object dat met new String(...) is gemaakt, haalt ze de tekst op uit de interne slot [[StringData]]. Het resultaat is een primitieve waarde van het type string, geen object. De ingebouwde methode String.prototype.valueOf() geeft dezelfde waarde terug.

De methode is niet generiek: String.prototype.toString.call(42) veroorzaakt een TypeError, net als aanroepen met null, undefined of een gewoon object zonder [[StringData]]. Alleen een eigen toString-methode hebben is niet voldoende. Het voorbeeld toont geldige ontvangers en vangt de fout voor een getal bewust op.

Voorbeelden

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);
}

Resultaat

true
hello string
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen