regExp.@@search

regExp.@@search

[@@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

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

规范

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'RegExp.prototype@@search' in that specification.StandardInitial definition.
ECMAScript 2017 Draft (ECMA-262)The definition of 'RegExp.prototype@@search' in that specification.Draft

浏览器兼容性

FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support?49 (49)???

FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support??49.0 (49)???