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()