JavaScript RegExp test() 方法

定义和用法

test() 方法测试字符串中的匹配项。

如果找到匹配项,则返回 true,否则返回 false

实例

例子 1

在字符串中搜索字符 "e :

let text = "The best things in life are free"; let pattern = /e/;
let result = pattern.test(text);

亲自试一试

例子 2

进行全局搜索,并在字符串中测试 "Hello" 和 "W3School":

// 字符串:
let text = "Hello world!";

// 查找 "Hello"
let pattern1 = /Hello/g;
let result1 = pattern1.test(text);

// 查找 "W3School"
let pattern2 = /W3School/g;
let result2 = pattern2.test(text);

亲自试一试

语法

regexp.test(string)

参数

参数 描述
string 必需。要搜索的字符串。

返回值

类型 描述
Boolean 如果找到匹配项,则返回 true,否则返回 false。

技术细节

返回值

如果字符串 string 中含有与 regexp 匹配的文本,则返回 true,否则返回 false

抛出

类型 描述
TypeError 调用该方法的对象不是 RegExp 时,抛出该异常。

说明

RegExp 对象的 test() 方法检测字符串是否匹配某个模式。

test() 方法将检测字符串 string,看它是否含有与 regexp 相匹配的文本。如果 string 中含有这样的文本,该方法将返回 true,否则,返回 false

调用 RegExp 对象 r 的 test() 方法,并为它传递字符串 s,与这个表示式是等价的:(r.exec(s) != null)。

浏览器支持

test() 是 ECMAScript1 (ES1) 特性。

所有浏览器都完全支持 ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

正则表达式搜索方法

在 JavaScript 中,正则表达式文本搜索可以用不同的方法完成。

使用模式(pattern)作为正则表达式,这些是最常用的方法:

举例 描述
text.match(pattern) 字符串方法 match()
text.search(pattern) 字符串方法 search()
pattern.exec(text) RexExp 方法 exec()
pattern.test(text) RexExp 方法 test()