大网数据广告活动
Web 标准与前端开发

RegExp.prototype.test()

· 52CE 我爱测

RegExp 实例的 **`test()`** 方法使用正则表达式在指定字符串中执行搜索。如果存在匹配,则返回 `true`, 否则返回 `false`。

RegExp 实例的 test() 方法使用正则表达式在指定字符串中执行搜索。如果存在匹配,则返回 true, 否则返回 false。

JavaScript 的 RegExp 对象在设置了 RegExp/global(全局)或 RegExp/sticky(粘性)标志时(例如 /foo/g 或 /foo/y),是有状态的。它们会从上一次匹配中保存一个 RegExp/lastIndex 属性。利用这个特性,test() 方法可以用来在一段文本字符串中(配合捕获组)迭代查找多个匹配项。

JavaScript Demo: RegExp.prototype.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(如果没找到);若想知道更多信息(然而执行比较慢),可使用RegExp.prototype.exec() 方法(类似于 String.prototype.match() 方法)。和 RegExp.prototype.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()

如果正则表达式设置了全局标志,test() 的执行会改变正则表达式 lastIndex属性。连续的执行test()方法,后续的执行将会从 lastIndex 处开始匹配字符串,(RegExp.prototype.exec() 同样改变正则本身的 lastIndex 属性值).

下面的实例表现了这种行为:

var regex = /foo/g;

// regex.lastIndex is at 0
regex.test("foo"); // true

// regex.lastIndex is now at 3
regex.test("foo"); // false

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。