RegExp.prototype.test()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
RegExp
实例的 test()
方法使用正则表达式在指定字符串中执行搜索。如果存在匹配,则返回 true
, 否则返回 false
。
JavaScript 的 RegExp
对象在设置了 global
(全局)或 sticky
(粘性)标志时(例如 /foo/g
或 /foo/y
),是有状态的。它们会从上一次匹配中保存一个 lastIndex
属性。利用这个特性,test()
方法可以用来在一段文本字符串中(配合捕获组)迭代查找多个匹配项。
尝试一下
const str = "table football";
const regex = new RegExp("foo*");
const globalRegex = new RegExp("foo*", "g");
console.log(regex.test(str));
// Expected output: true
console.log(globalRegex.lastIndex);
// Expected output: 0
console.log(globalRegex.test(str));
// Expected output: true
console.log(globalRegex.lastIndex);
// Expected output: 9
console.log(globalRegex.test(str));
// Expected output: false
语法
regexObj.test(str)
参数
str
-
用来与正则表达式匹配的字符串
返回值
如果正则表达式与指定的字符串匹配,返回true
;否则false
。
描述
当你想要知道一个正则表达式是否与指定的字符串匹配时,就可以使用 test()
(类似于 String.prototype.search()
方法),差别在于 test 返回一个布尔值,而 search 返回索引(如果找到)或者 -1(如果没找到);若想知道更多信息(然而执行比较慢),可使用exec()
方法(类似于 String.prototype.match()
方法)。和 exec()
(或者组合使用),一样,在相同的全局正则表达式实例上多次调用test
将会越过之前的匹配。
示例
使用 test()
一个简单的例子,测试 "hello" 是否包含在字符串的最开始,返回布尔值。
let str = "hello world!";
let result = /^hello/.test(str);
console.log(result);
// true
下例打印一条信息,该信息内容取决于是否成功通过指定测试:
function testinput(re, str) {
var midstring;
if (re.test(str)) {
midstring = " contains ";
} else {
midstring = " does not contain ";
}
console.log(str + midstring + re.source);
}
当设置全局标志的正则使用test()
规范
Specification |
---|
ECMAScript® 2026 Language Specification # sec-regexp.prototype.test |