Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.split — dijeljenje teksta u polje

String.prototype.split dijeli tekst prema razdjelniku i vraća polje dijelova. Saznajte kako funkcioniraju ograničenje i prazni elementi te koja je razlika između praznog i izostavljenog razdjelnika.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

string.split(separator, limit)

String.prototype.split dijeli tekst slijeva nadesno, ne mijenjajući izvornik. Razdjelnik u obliku niza znakova traži se doslovno i ne uključuje se u rezultirajuće polje. Susjedni razdjelnici te razdjelnici na početku ili kraju mogu stvoriti prazne elemente.

Ako je separator izostavljen ili ima vrijednost undefined, metoda vraća polje koje sadrži cijeli niz, osim ako je ograničenje nula. Ako nema podudaranja, cijeli niz također ostaje sačuvan. Razdjelnik "" dijeli niz na UTF-16 kodne jedinice, koje ne moraju odgovarati cijelim znakovima kako ih korisnici doživljavaju; "".split("") vraća [].

Neobavezni argument limit ograničava broj elemenata, a ne broj dijeljenja: preostali se tekst odbacuje. Zadana je vrijednost 2 ** 32 - 1; navedena vrijednost pretvara se pomoću ToUint32. Vrijednost limit jednaka 0 daje [].

Razdjelnik može biti i objekt s metodom [Symbol.split], primjerice RegExp. U tom slučaju split toj metodi prosljeđuje prijamnik i ograničenje te izravno vraća njezin rezultat; prilagođena metoda može promijeniti gore opisana pravila. Pozivanje String.prototype.split s null ili undefined kao prijamnikom izaziva TypeError.

Primjeri

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("")));

Rezultat

["red","","blue",""]
["red",""]
["red,,blue,"]
[]

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori