Метод[@@search]() выполняет поиск совпадения между регулярным выражениемthis и строкой.

Синтаксис

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

Используя@@search в подклассах

Подкласс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]()
• RegExp.prototype[@@replace]()
• RegExp.prototype[@@split]()
• RegExp.prototype.exec()
• RegExp.prototype.test()