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.