RegExp.prototype[@@split]()

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"]

Подклассы 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)"]

• String.prototype.split()
• RegExp.prototype[@@match]() (en-US)
• RegExp.prototype[@@replace]() (en-US)
• RegExp.prototype[@@search]()
• RegExp.prototype.exec()
• RegExp.prototype.test()