Método test() da RegExp do JavaScript

Definição e uso

test() Método testa o item correspondente na string.

Se encontrar um item correspondente, retorna trueCaso contrário, retorne false.

Exemplo

Exemplo 1

Procurar o caractere "e" na string:

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

Experimente você mesmo

Exemplo 2

Realizar busca global e testar "Hello" e "W3School" na string:

// String:
let text = "Hello world!";
// Procurar "Hello"
let pattern1 = /Hello/g;
let result1 = pattern1.test(text);
// Procurar "W3School"
let pattern2 = /W3School/g;
let result2 = pattern2.test(text);

Experimente você mesmo

Sintaxe

regexp.test(string)

Parâmetro

Parâmetro Descrição
string Obrigatório. A string a ser pesquisada.

Retorno

Tipo Descrição
Boolean Se encontrar correspondências, retorna true, caso contrário, retorna false.

Detalhes técnicos

Retorno

Se a string string contém regexp o texto correspondente, caso contrário, retorne trueCaso contrário, retorne false.

lança

Tipo Descrição
TypeError Se o objeto chamado não for RegExp, lança essa exceção.

Descrição

Objeto RegExp test() Método que verifica se a string coincide com um padrão.

O método test() detectará a string stringverifique se contém regexp o texto correspondente. Se string contém tal texto, o método retornará trueCaso contrário, retorne false.

Chame o método test() do objeto RegExp r, passe a string s como argumento, e isso é equivalente a: (r.exec(s) != null).

Suporte do navegador

test() É uma característica do ECMAScript1 (ES1).

Todos os navegadores suportam completamente o ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte

Métodos de busca de expressão regular

No JavaScript, a busca de texto de expressão regular pode ser feita com diferentes métodos.

UsoPadrão (pattern)Como expressão regular, esses são os métodos mais comuns:

Exemplo Descrição
text.match(padrão) Método match() da stringa
text.search(padrão) Método search() da stringa
padrão.exec(text) Método exec() do RexExp
padrão.test(text) Método test() do RexExp