Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła