test, méthode
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, teststring)
{
// Test string for existence of regular expression.
var found = re.test(teststring)
// Format the output.
var s = "";
s += "'" + teststring + "'"
if (found)
s += " contains ";
else
s += " does not contain ";
s += "'" + re.source + "'"
return(s);
}