Metodo test

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce un valore booleano che indica se una stringa in cui eseguire la ricerca include o meno un criterio di espressione regolare.

function test(str : String) : Boolean

Argomenti

str
Obbligatorio. Stringa in cui eseguire la ricerca.

Note

Mediante il metodo test viene verificato se una stringa include un criterio. Viene restituito true se la verifica ha esito positivo, false in caso contrario. Se viene individuata una corrispondenza, le proprietà dell'oggetto globale RegExp verranno aggiornate in base ai risultati di tale corrispondenza.

Se per un'espressione regolare è impostato il flag globale, verrà cercata la stringa che ha inizio nella posizione indicata dal valore di lastIndex. Se il flag globale non è impostato, il valore di lastIndex verrà ignorato e la ricerca comincerà dal punto di inizio della stringa.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo del metodo test. In questo esempio, utilizzare nella funzione un criterio di espressione regolare e una stringa. Verrà verificata l'occorrenza del criterio di espressione regolare nella stringa e restituita una stringa con i risultati della ricerca:

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.
}