Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

[@@split]() метод делит объект String  в массив сторок, путём разбиения строки на подстроки.

Синтаксис

regexp[Symbol.split](str[, limit])

Параметры

str
Цель разбиения.
limit

Необязательное. Целое число ограничивающее кол-во рабиений. [@@split]() метод разбивает все совпадения this RegExp шаблона, до тех пор пока не достигнет числа limit или строка будет короче this шаблона.

Возвращаемое значение

Array содержит подстроки как элементы.

Описание

Этот метод вызывает String.prototype.split(), если аргумент separator объект RegExp. Для примера, два данных выражения возвращают одинаковый результат.

'a-b-c'.split(/-/);

/-/[Symbol.split]('a-b-c');

Этот метод существует для кастомизации поведения (разбиения) подкласса RegExp.

Если аргумент str не объект типа RegExp, метод String.prototype.split() не вызывается, так же не создается объект типа RegExp.

Примеры

Прямой вызов

Этот метод может быть использован, так же как String.prototype.split(), кроме случаев когда this отличаются и аргументы идут в разном порядке.

var re = /-/g;
var str = '2016-01-02';
var result = re[Symbol.split](str);
console.log(result);  // ["2016", "01", "02"]

Использование @@split в подклассах

Подклассы RegExp могут переопределить [@@split]() для изменения дефольтного поведения.

class MyRegExp extends RegExp {
  [Symbol.split](str, limit) {
    var result = RegExp.prototype[Symbol.split].call(this, str, limit);
    return result.map(x => "(" + x + ")");
  }
}

var re = new MyRegExp('-');
var str = '2016-01-02';
var result = str.split(re); // String.prototype.split calls re[@@split].
console.log(result); // ["(2016)", "(01)", "(02)"]

Specifications

Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'RegExp.prototype[@@split]' в этой спецификации.
Стандарт Initial definition.
ECMAScript Latest Draft (ECMA-262)
Определение 'RegExp.prototype[@@split]' в этой спецификации.
Черновик  

Browser compatibility

ВозможностьChromeEdgeFirefoxInternet ExplorerOperaSafari
Базовая поддержка Да Да49 Нет Да Да
ВозможностьAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Базовая поддержка Да Да Да49 Да Да Да

See also

Метки документа и участники

Внесли вклад в эту страницу: 0x0071
Обновлялась последний раз: 0x0071,