O métodosearch() realiza uma busca por uma ocorrência entre uma expressão regular e umaString.

Sintaxe

str.search(regexp)

Parâmetros

regexp

Um objeto contendo uma expressão regular. Se um objetoobj for passado como parâmetro e não for do tipoRegExp, ele será implicitamente convertido para umaRegExp através da instruçãonew RegExp(obj).

Valor retornado

O índice na string do primeiro trecho que satisfaz a expressão regular. Do contrário, o valor-1 será retornado.

Descrição

Quando você quiser saber se um padrão foi encontrado, e também saber seu índice dentro de uma string, usesearch(). (Se você deseja apenas saber se ele existe, use o método semelhantetest() do protótipo RegExp, que retorna um booleano.)

Para obter mais informações (mas em compensação a execução se torna mais lenta), usematch() (semelhante ao métodoexec() da RegExp).

Exemplos

Usandosearch()

O exemplo a seguir pesquisa uma string com dois objetosregexp diferentes para mostrar uma pesquisa bem-sucedida (valor positivo) vs. uma pesquisa mal-sucedida (-1).

let str = "hey JudE";let re = /[A-Z]/g;let reDot = /[.]/g;console.log(str.search(re)); // retorna 4, que é o índice da primeira letra maiúscula "J"console.log(str.search(reDot)); // retorna -1 pois não conseguiu encontrar o ponto "."

Especificações

Navegadores compatíveis

Notas específicas para a engine Gecko

• Antes do Gecko 8.0,search() foi implementado incorretamente. Quando era chamadosem parâmetros ou comundefined, ele buscava pela string 'undefined', ao invés de buscar pela string vazia. Isto foi corrigido. Agora'a'.search() e'a'.search(undefined) corretamente retornam 0.
• A partir do Gecko 39, o argumento não-padrãoflags está defasado (deprecated) e dispara um aviso no console (Erro do Firefox 1142351).
• A partir do Gecko 47, o argumento não-padrãoflags não é mais suportado em buildsnon-release e em breve será removido inteiramente (Erro do Firefox 1245801).
• A partir do Gecko 49, o argumento não-padrãoflags não é mais suportado (Erro do Firefox 1108382).

Veja também

• String.prototype.match()
• RegExp.prototype.exec()