CKTIS / JavaScript
String.prototype.split — podział tekstu na tablicę
String.prototype.split dzieli tekst według separatora i zwraca tablicę części. Poznaj działanie limitu, pustych elementów oraz różnicę między pustym a pominiętym separatorem.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
string.split(separator, limit)String.prototype.split dzieli tekst od lewej do prawej, nie zmieniając oryginału. Separator tekstowy jest dopasowywany dosłownie i nie trafia do wynikowej tablicy. Sąsiadujące separatory oraz separator na początku lub końcu mogą tworzyć puste elementy.
Pominięty separator lub wartość undefined zwraca tablicę z całym tekstem, chyba że limit wynosi zero. Brak dopasowania również pozostawia cały tekst. Separator "" dzieli na jednostki kodowe UTF-16, a nie zawsze na całe znaki widoczne dla użytkownika; "".split("") zwraca [].
Opcjonalny limit ogranicza liczbę elementów, nie liczbę podziałów: pozostała część tekstu jest odrzucana. Domyślnie wynosi 2 ** 32 - 1; podana wartość jest konwertowana przez ToUint32. limit równy 0 daje [].
Separator może być także obiektem z metodą [Symbol.split], na przykład RegExp. Wtedy split przekazuje jej odbiorcę i limit oraz zwraca jej wynik bezpośrednio; niestandardowa metoda może zmienić opisane reguły. Wywołanie String.prototype.split z odbiorcą null lub undefined powoduje TypeError.
Przykłady
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("")));Wynik
["red","","blue",""] ["red",""] ["red,,blue,"] []
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.