Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp.prototype.test — vérifier la présence d’une correspondance

La méthode test() vérifie si une expression régulière correspond à un texte et renvoie true ou false. Les indicateurs g et y font utiliser lastIndex pour la recherche ; des appels répétés peuvent donc produire des résultats différents.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.test(string)

Appelle RegExp.prototype.test sous la forme regexp.test(string). La méthode renvoie true si une correspondance est trouvée, et false dans le cas contraire. Elle ne renvoie pas les groupes capturés ; utilise exec() pour les obtenir. L’argument est converti en texte. Si l’argument est omis, il devient le texte "undefined".

Par défaut, il suffit qu’une partie du texte corresponde. Pour limiter la correspondance aux limites de l’entrée, utilise les ancres ^ et $, en gardant à l’esprit que l’indicateur m les transforme en limites de ligne.

Avec l’implémentation standard de exec(), les indicateurs g et y utilisent lastIndex pour déterminer la position de départ. Avec g, la recherche peut essayer des positions ultérieures, ce que y ne permet pas. En mode Unicode (avec u ou v), si lastIndex pointe sur le substitut bas d’une paire de substituts UTF-16, une correspondance peut commencer au substitut haut qui le précède, même avec y. En cas de réussite, lastIndex est défini sur la fin de la correspondance ; en cas d’échec, il est remis à zéro. En l’absence de ces deux indicateurs, l’implémentation standard de exec() lit tout de même lastIndex et applique ToLength à sa valeur. Si la conversion réussit, la recherche commence à la position 0 sans modifier la propriété lastIndex. En revanche, si tu affectes une valeur de type Symbol à lastIndex, test() lève une exception TypeError même sans g ni y. Pour effectuer des vérifications indépendantes, omets g et y ou définis lastIndex = 0 avant chaque appel.

Une correspondance vide ne fait pas avancer automatiquement lastIndex : une boucle fondée sur test() peut ne jamais se terminer. La méthode utilise exec(), donc remplacer cette méthode peut modifier le comportement. Il s’agit d’une API du langage ECMAScript, et non d’une API de navigateur.

Exemples

const pattern = /cat/g;
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
console.log(pattern.test("cat"));
console.log(pattern.lastIndex);
pattern.lastIndex = 0;
console.log(pattern.test("cat"));

Résultat

true
3
false
0
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources