CKTIS / JavaScript
String.prototype.split — tekst opsplitsen in een array
String.prototype.split splitst tekst op basis van een scheidingsteken en geeft een array met delen terug. Lees hoe de limiet en lege elementen werken, en wat het verschil is tussen een leeg en een weggelaten scheidingsteken.
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.split(separator, limit)String.prototype.split splitst tekst van links naar rechts zonder het origineel te wijzigen. Een scheidingsteken in de vorm van een tekenreeks wordt letterlijk gezocht en komt niet in de resulterende array terecht. Aangrenzende scheidingstekens en scheidingstekens aan het begin of einde kunnen lege elementen opleveren.
Als separator is weggelaten of undefined is, geeft de methode een array met de volledige tekenreeks terug, tenzij de limiet nul is. Als er geen overeenkomst is, blijft de volledige tekenreeks eveneens intact. Het scheidingsteken "" splitst in UTF-16-code-eenheden, die niet altijd overeenkomen met volledige, door gebruikers waargenomen tekens; "".split("") geeft [] terug.
Het optionele limit begrenst het aantal elementen, niet het aantal splitsingen: de resterende tekst wordt weggegooid. De standaardwaarde is 2 ** 32 - 1; een opgegeven waarde wordt geconverteerd via ToUint32. Een limit van 0 levert [] op.
Het scheidingsteken kan ook een object zijn met een methode [Symbol.split], zoals een RegExp. In dat geval geeft split de ontvanger en de limiet door aan die methode en retourneert het rechtstreeks het resultaat ervan; een aangepaste methode kan de hierboven beschreven regels veranderen. Een aanroep van String.prototype.split met null of undefined als ontvanger veroorzaakt een TypeError.
Voorbeelden
const text = "red,,blue,";
console.log(JSON.stringify(text.split(",")));
console.log(JSON.stringify(text.split(",", 2)));
console.log(JSON.stringify(text.split()));
console.log(JSON.stringify("".split("")));Resultaat
["red","","blue",""] ["red",""] ["red,,blue,"] []
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.