KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.concat — tekenreeksen samenvoegen

String.prototype.concat voegt een willekeurig aantal argumenten aan een tekenreeks toe en zet ze om naar tekst. De methode geeft een primitieve stringwaarde terug en verandert de oorspronkelijke tekenreeks niet.

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

str.concat(...args)

String.prototype.concat voegt de tekenreeks van de ontvanger samen met nul of meer argumenten, in de opgegeven volgorde. De methode voegt geen scheidingstekens toe: spaties en leestekens moet je zelf expliciet meegeven. Het resultaat is een primitieve string-waarde, geen String-object.

Tekenreeksen zijn onveranderlijk: de methode wijzigt de oorspronkelijke waarde niet. Wijs het resultaat toe aan een variabele om het te bewaren. Een aanroep zonder argumenten geeft de tekst van de ontvanger ongewijzigd terug.

De ontvanger wordt eerst naar tekst omgezet, gevolgd door de argumenten van links naar rechts met ToString. De argumenten null en undefined leveren respectievelijk "null" en "undefined" op; een argument van het type symbol veroorzaakt een TypeError. Bij de omzetting van objecten kan aangepaste code worden uitgevoerd en een uitzondering ontstaan.

De methode is generiek: String.prototype.concat.call(42, "!") geeft "42!" terug. Als ontvanger veroorzaken null en undefined echter een TypeError. Dit is een methode uit de ECMAScript-standaard, geen browser-API.

Voorbeelden

const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);

Resultaat

Level 3!
Level
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