RegExp.prototype[@@search]() - JavaScript 编辑

[@@search]() 方法执行了一个在给定字符串中的一个搜索以取得匹配正则模式的项。

语法

regexp[Symbol.search](str)

参数

str

搜索的目标 String。

返回值

整数

如果成功的话，[@@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

{jsxref("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

规范

Specification	Status	Comment
ECMAScript 2015 (6th Edition, ECMA-262) RegExp.prototype[@@search]	Standard	初始定义
ECMAScript Latest Draft (ECMA-262) RegExp.prototype[@@search]	Draft

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	?	49 (49)	?	?	?

Feature	Android	Chrome for Android	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	49.0 (49)	?	?	?

另见

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