KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String — expliciete omzetting naar tekst

String(value) zet een waarde om in een primitieve tekenreeks. Zonder argument retourneert de functie een lege tekenreeks. Als de omzetting slaagt, maakt new String(value) een wrapperobject in plaats van een primitieve waarde.

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

String(value)
String()
new String(value)

String is een ingebouwde ECMAScript-functie, geen browser-API. De aanroep String(value) retourneert een primitieve tekenreeks als de omzetting slaagt. Het type String stelt onveranderlijke reeksen van 16-bits code-eenheden voor, die doorgaans als UTF-16 worden geïnterpreteerd; één zichtbaar teken komt niet noodzakelijk overeen met één code-eenheid.

Een argument weglaten is iets anders dan undefined doorgeven: String() retourneert "", maar String(undefined) retourneert "undefined". Zo levert String(null) ook "null" op en String(42) "42". Een rechtstreeks doorgegeven Symbol-argument wordt speciaal behandeld: String(Symbol("tag")) retourneert "Symbol(tag)".

Die speciale behandeling geldt alleen bij aanroepen zonder new: new String(Symbol("tag")) gooit een TypeError in plaats van een wrapperobject te maken. Als de omzetting slaagt, maakt new String(value) een wrapperobject. Daarom levert typeof String("hello") "string" op, terwijl typeof new String("hello") "object" oplevert. Een strikte vergelijking van deze waarden met === levert false op. Gebruik voor gewone tekstconversie String(value) zonder new.

Bij het omzetten van een object kunnen de eigen omzettingsmechanismen ervan worden aangeroepen, zoals [Symbol.toPrimitive] of toString; er kan ook een uitzondering optreden. String(value) is geen JSON-serialisatie en ook geen manier om willekeurige niet-vertrouwde objecten veilig weer te geven zonder hun code uit te voeren.

Voorbeelden

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

Resultaat

["","undefined","null","42"]
Symbol(tag)
string object
false

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