Méthode test() de RegExp JavaScript

Définition et utilisation

test() Méthode pour tester les éléments correspondants dans une chaîne de caractères.

Si un élément correspondant est trouvé, retourne truesinon retourne false.

Exemple

Exemple 1

Recherche de caractères "e" dans une chaîne de caractères :

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

Essayez-le vous-même

Exemple 2

Recherche globale et test de "Hello" et "W3School" dans la chaîne :

// Chaîne :
let text = "Hello world!";
// Rechercher "Hello"
let pattern1 = /Hello/g;
let result1 = pattern1.test(text);
// Rechercher "W3School"
let pattern2 = /W3School/g;
let result2 = pattern2.test(text);

Essayez-le vous-même

Syntaxe

regexp.test(string)

Paramètre

Paramètre Description
string Requis. La chaîne à rechercher.

Valeur de retour

Type Description
Boolean Si un élément correspondant est trouvé, retourne true, sinon retourne false.

Détails techniques

Valeur de retour

Si la chaîne string contient avec regexp le texte correspondant, sinon retourne truesinon retourne false.

lance une exception.

Type Description
TypeError L'objet appelant la méthode n'est pas RegExp, une exception est lancée.

Description

Objet RegExp test() méthode vérifie si une chaîne correspond à un modèle.

La méthode test() vérifie si la chaîne stringvérifie si la chaîne regexp le texte correspondant. Si string contient ce texte, cette méthode retourne truesinon, retourne false.

Appeler la méthode test() de l'objet RegExp r, et lui passer la chaîne s, cela équivaut à : (r.exec(s) != null).

Support du navigateur

test() C'est une caractéristique ECMAScript1 (ES1).

Tous les navigateurs supportent complètement ES1 (JavaScript 1997) :

Chrome IE Edge Firefox Safari Opera
Supporté Supporté Supporté Supporté Supporté Supporté

Méthodes de recherche d'expression régulière

En JavaScript, la recherche de texte avec des expressions régulières peut être effectuée de différentes manières.

UtilisationModèle (pattern)En tant que expression régulière, ces sont les méthodes les plus couramment utilisées :

Exemple Description
text.match(pattern) Méthode match() de chaîne
text.search(pattern) Méthode search() de chaîne
pattern.exec(text) Méthode exec() de RexExp
pattern.test(text) Méthode test() de RexExp