Método de teste.
Retorna um valor booleano que indica se um padrão de expressão regular existe em uma seqüência de caracteres pesquisada.
function test(str : String) : Boolean
Argumentos
- str
Obrigatório. A seqüência na qual deseja realizar a pesquisa.
Comentários
O teste método verifica se um padrão existe dentro de uma seqüência de caracteres e retorna true em caso afirmativo, e false contrário. Se uma correspondência for encontrada, as propriedades do modelo global da RegExp objeto são atualizados para refletir os resultados de correspondência.
Se o sinalizador global estiver definido para uma expressão regular, teste procura a seqüência iniciando na posição indicada pelo valor do lastIndex. Se o sinalizador global não estiver definido, teste ignora o valor de lastIndex e pesquisas desde o início da string.
Exemplo
O exemplo a seguir ilustra o uso da teste método. Para usar esse exemplo, passe a função de um padrão de expressão regular e uma seqüência de caracteres. A função testará a ocorrência do padrão de expressão regular na seqüência de caracteres e retornar uma seqüência de caracteres que indica os resultados da pesquisa:
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);
}