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
规范
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'RegExp.prototype@@search' in that specification. | Standard | Initial definition. |
ECMAScript 2017 Draft (ECMA-262)The definition of 'RegExp.prototype@@search' in that specification. | Draft | |
浏览器兼容性
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) | ? | ? | ? |