RegExp.prototype[@@search]()

regexp[Symbol.search](str)

str

String, являющийся объектом поиска.

integer

В случае успеха, [@@search]() вернёт индекс первого совпадения регулярного выражения внутри строки. В противном случае, он вернёт -1.

Этот метод вызывается внутреннее в String.prototype.search(). Например, два следующих примера вернут один и тот же результат.

'abc'.search(/a/);

/a/[Symbol.search]('abc');

Этот метод существует для настройки поведения поиска в подклассах RegExp.

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

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

Подкласс RegExp может быть перезаписан с помощью метода [@@search]() для изменения поведения.

class MyRegExp extends RegExp {
  constructor(str) {
    super(str)
    this.pattern = str;
  }
  [Symbol.search](str) {
    return str.indexOf(this.pattern);
  }
}

var re = new MyRegExp('a+b');
var str = 'ab a+b';
var result = str.search(re); // String.prototype.search calls re[@@search].
console.log(result); // 3

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