База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

String.prototype.split — разделяне на текст в масив

String.prototype.split разделя текста по разделител и връща масив от части. Научете как действат ограничението и празните елементи и каква е разликата между празен и пропуснат разделител.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

string.split(separator, limit)

String.prototype.split разделя текста отляво надясно, без да променя оригинала. Разделител под формата на низ се търси буквално и не се включва в получения масив. Съседни разделители, както и разделители в началото или края, могат да създадат празни елементи.

Ако separator е пропуснат или има стойност undefined, методът връща масив с целия низ, освен ако ограничението не е нула. Ако няма съвпадение, целият низ също остава непокътнат. Разделителят "" разделя на UTF-16 кодови единици, които невинаги съответстват на цели знаци според възприятието на потребителя; "".split("") връща [].

Незадължителният аргумент limit ограничава броя на елементите, а не броя на разделянията: останалият текст се отхвърля. Стойността по подразбиране е 2 ** 32 - 1; подадената стойност се преобразува чрез ToUint32. Стойност на limit, равна на 0, дава [].

Разделителят може да бъде и обект с метод [Symbol.split], например RegExp. В този случай split подава на метода получателя и ограничението и връща директно неговия резултат; потребителски метод може да промени описаните по-горе правила. Извикването на String.prototype.split с null или undefined като получател предизвиква TypeError.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници