test, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne une valeur booléenne indiquant l'existence ou non d'un modèle d'expression régulière dans une chaîne recherchée.

function test(str : String) : Boolean

Arguments

str
Obligatoire. Chaîne sur laquelle la recherche doit être effectuée.

Notes

La méthode test vérifie l'existence d'un modèle à l'intérieur d'une chaîne. Si le modèle existe, la méthode retourne la valeur true ; sinon, elle retourne la valeur false. Si une correspondance est trouvée, les propriétés de l'objet RegExp global sont mises à jour pour refléter les résultats de la recherche.

Si l'indicateur global est défini pour une expression régulière, la méthode test recherche la chaîne débutant à la position indiquée par la valeur de la propriété lastIndex. Si l'indicateur global n'est pas défini, test ignore la valeur de lastIndex et effectue la recherche à partir du début de la chaîne.

Exemple

L'exemple ci-dessous illustre l'utilisation de la méthode test. Pour utiliser cet exemple, passez à la fonction un modèle d'expression régulière et une chaîne. La fonction recherche alors le modèle d'expression régulière dans la chaîne et retourne une chaîne indiquant le résultat de cette recherche :

function TestDemo(re, s){
   var s1;                         //Declare variable.
   // Test string for existence of regular expression.
   if (re.test(s))                 //Test for existence.
      s1 = " contains ";           //s contains pattern.
   else
      s1 = " does not contain ";   //s does not contain pattern.
   return("'" + s + "'" + s1 + "'"+ re.source + "'"); //Return string.
}