Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.split — rozdělení textu na pole

String.prototype.split rozdělí text podle oddělovače a vrátí pole částí. Zjistěte, jak funguje limit a prázdné prvky a jaký je rozdíl mezi prázdným a vynechaným oddělovačem.

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

Syntaxe

string.split(separator, limit)

String.prototype.split rozděluje text zleva doprava a nemění původní řetězec. Oddělovač v podobě řetězce se hledá doslovně a do výsledného pole se nezahrnuje. Sousední oddělovače i oddělovače na začátku nebo na konci mohou vytvořit prázdné prvky.

Pokud je separator vynechán nebo má hodnotu undefined, metoda vrátí pole obsahující celý řetězec, pokud limit není nula. Pokud se nenajde žádná shoda, zůstane také zachován celý řetězec. Oddělovač "" rozděluje na jednotky kódu UTF-16, které nemusí odpovídat celým znakům vnímaným uživatelem; "".split("") vrátí [].

Nepovinný argument limit omezuje počet prvků, nikoli počet rozdělení: zbývající text se zahodí. Výchozí hodnota je 2 ** 32 - 1; zadaná hodnota se převede pomocí ToUint32. Hodnota limit rovná 0 vytvoří [].

Oddělovačem může být také objekt s metodou [Symbol.split], například RegExp. V takovém případě předá split této metodě příjemce a limit a její výsledek vrátí přímo; vlastní metoda může výše popsaná pravidla změnit. Volání String.prototype.split s příjemcem null nebo undefined vyvolá TypeError.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje