Método search() da String do JavaScript

Definição e uso

search() o método compara a string com a expressão regular.

Comentário:se o valor de busca for uma string, então converta em expressão regular.

search() o método retorna o índice (posição) da primeira correspondência encontrada.

se não encontrar correspondências, então search() o método retorna -1.

Dica:search() o método distingue entre maiúsculas e minúsculas.

Veja também:

Tutorial de expressões regulares

Manual de referência de expressões regulares

Diferença entre String search() e String indexOf()

search() não pode usar o parâmetro de posição de início.

indexOf() o método não pode procurar expressões regulares.

Diferença entre String search() e String match()

search() o método retorna a posição da primeira correspondência.

match() o método retorna um array de correspondências.

instância

exemplo 1

procurar "Blue":

let text = "Mr. Blue has a blue house";
let position = text.search("Blue");

Experimente você mesmo

exemplo 2

procurar "blue":

let text = "Mr. Blue has a blue house";
let position = text.search("blue");

Experimente você mesmo

exemplo 3

procurar /Blue/:

let text = "Mr. Blue has a blue house";
let position = text.search(/Blue/);

Experimente você mesmo

exemplo 4

procurar /blue/：

let text = "Mr. Blue has a blue house";
let position = text.search(/blue/);

Experimente você mesmo

Exemplo 5

Busca insensível a maiúsculas e minúsculas:

let text = "Mr. Blue has a blue house";
let position = text.search(/blue/i);

Experimente você mesmo

Sintaxe

string.search(regexp)

Parâmetro

Parâmetro Descrição
regexp

Obrigatório. Valor de busca.

expressão regular (ou string que pode ser convertida em expressão regular).

Retorno

Tipo Descrição
número a posição da primeira ocorrência. Se não houver correspondência, retorna -1.

Detalhes técnicos

Parâmetro regexp

O parâmetro é o valor a ser pesquisado na string string do objeto RegExp que busca na string, que tem o padrão especificado. Se o parâmetro não for objeto RegExp, ele primeiro passa-o para o construtor RegExp(), convertendo-o em objeto RegExp.

Retorno

string a primeira ocorrência de regexp a posição de início da subcadeia correspondente.

Comentário:Se não encontrar nenhuma subcadeia correspondente, retorna -1.

Explicação

search() O método busca na string string na string para buscar com regexp subcadeia correspondente, e retorna a posição do primeiro caractere da subcadeia correspondente. Se não encontrar nenhuma subcadeia correspondente, retorna -1.

search() O método não executa a busca global, ele ignora o sinalizador g. Ele também ignora regexp a propriedade lastIndex, e sempre começa a pesquisa do início da string, o que significa que sempre retorna string da primeira ocorrência do match.

Métodos de busca de expressão regular

No JavaScript, a busca de texto de expressão regular pode ser feita de diferentes maneiras.

Ao usar o padrão como expressão regular, essas são as métodos mais comuns:

Exemplo Descrição
text.match(padrão) Método de string match()
text.search(padrão) Método de string search()
padrão.exec(text) Método de expressão regular exec()
padrão.test(text) Método de expressão regular test()

Suporte do navegador

search() é uma característica do ECMAScript1 (ES1).

Todos os navegadores suportam completamente ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

String do JavaScript

Métodos da String do JavaScript

Pesquisa de String do JavaScript