Pesquisa de String JavaScript
Métodos de pesquisa JavaScript
- String indexOf()
- String lastIndexOf()
- String começaCom()
- String terminaCom()
JavaScript String indexOf()
O indexOf()
método retorna o índice da (posição da) first
ocorrência de um texto especificado em uma string:
Exemplo
let str = "Please locate where 'locate' occurs!";
str.indexOf("locate");
Observação
JavaScript conta posições a partir de zero.
0 é a primeira posição em uma string, 1 é a segunda, 2 é a terceira, ...
String JavaScript lastIndexOf()
O lastIndexOf()
método retorna o índice da última
ocorrência de um texto especificado em uma string:
Exemplo
let str = "Please locate where 'locate' occurs!";
str.lastIndexOf("locate");
Ambos indexOf()
e lastIndexOf()
retornam -1 se o texto não for encontrado:
Exemplo
let str = "Please locate where 'locate' occurs!";
str.lastIndexOf("John");
Ambos os métodos aceitam um segundo parâmetro como a posição inicial para a pesquisa:
Exemplo
let str = "Please locate where 'locate' occurs!";
str.indexOf("locate", 15);
Os lastIndexOf()
métodos pesquisam para trás (do fim para o início), ou seja: se o segundo parâmetro for 15
, a pesquisa começa na posição 15 e pesquisa até o início da string.
Exemplo
let str = "Please locate where 'locate' occurs!";
str.lastIndexOf("locate", 15);
Pesquisa de string JavaScript()
O search()
método pesquisa uma string por um valor especificado e retorna a posição da correspondência:
Exemplo
let str = "Please locate where 'locate' occurs!";
str.search("locate");
Você Notou?
Os dois métodos, indexOf()
e search()
, são iguais?
Eles aceitam os mesmos argumentos (parâmetros) e retornam o mesmo valor?
Os dois métodos NÃO são iguais. Estas são as diferenças:
- O
search()
método não pode receber um segundo argumento de posição inicial. - O
indexOf()
método não pode receber valores de pesquisa poderosos (expressões regulares).
Você aprenderá mais sobre expressões regulares em um capítulo posterior.
JavaScript String match()
O método match() pesquisa uma string em busca de uma correspondência com uma expressão regular e retorna as correspondências como um objeto Array.
Exemplo 1
Pesquise uma string por "ain":
let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);
Leia mais sobre expressões regulares no capítulo JS RegExp .
Observação
Se uma expressão regular não incluir o modificador g (para realizar uma pesquisa global ), o método match() retornará apenas a primeira correspondência na string.
Sintaxe
string.match(regexp)
regexp | Required. The value to search for, as a regular expression. |
Returns: | An Array, containing the matches, one item for each match, or null if no match is found |
Exemplo 2
Execute uma pesquisa global, sem distinção entre maiúsculas e minúsculas, para "ain":
let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);
String JavaScript inclui()
O includes()
método retorna true se uma string contiver um valor especificado.
Exemplo
let text = "Hello world, welcome to the universe.";
text.includes("world");
Sintaxe
string.includes(searchvalue, start)
searchvalue | Required. The string to search for |
start | Optional. Default 0. Position to start the search |
Returns: | Returns true if the string contains the value, otherwise false |
JS Version: | ES6 (2015) |
Verifique se uma string inclui "world", iniciando a pesquisa na posição 12:
let text = "Hello world, welcome to the universe.";
text.includes("world", 12);
Suporte ao navegador
includes()
é um recurso ES6 (JavaScript 2015).
É suportado em todos os navegadores modernos:
Chrome | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes |
includes()
não é compatível com o Internet Explorer.
String JavaScript iniciaCom()
O startsWith()
método retorna true
se uma string começa com um valor especificado, caso contrário false
:
Exemplo
let text = "Hello world, welcome to the universe.";
text.startsWith("Hello");
Sintaxe
string.startsWith(searchvalue, start)
Valores de parâmetro
Parameter | Description |
---|---|
searchvalue | Required. The value to search for. |
start | Optional. Default 0. The position to start the search. |
Exemplos
let text = "Hello world, welcome to the universe.";
text.startsWith("world") // Returns false
let text = "Hello world, welcome to the universe.";
text.startsWith("world", 5) // Returns false
let text = "Hello world, welcome to the universe.";
text.startsWith("world", 6) // Returns true
Observação
O startsWith()
método diferencia maiúsculas de minúsculas.
Suporte ao navegador
startsWith()
é um recurso ES6 (JavaScript 2015).
É suportado em todos os navegadores modernos:
Chrome | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes |
startsWith()
não é compatível com o Internet Explorer.
String JavaScript terminaCom()
O endsWith()
método retorna true
se uma string termina com um valor especificado, caso contrário false
:
Exemplo
Verifique se uma string termina com "Doe":
var text = "John Doe";
text.endsWith("Doe");
Sintaxe
string.endswith(searchvalue, length)
Valores de parâmetro
Parameter | Description |
---|---|
searchvalue | Required. The value to search for. |
length | Optional. The length to search. |
Verifique os 11 primeiros caracteres de uma string que termina com "world":
let text = "Hello world, welcome to the universe.";
text.endsWith("world", 11);
Observação
O endsWith()
método diferencia maiúsculas de minúsculas.
Suporte ao navegador
endsWith()
é um recurso ES6 (JavaScript 2015).
É suportado em todos os navegadores modernos:
Chrome | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes |
endsWith()
não é compatível com o Internet Explorer.
Referência de string completa
Para uma referência completa de String, acesse nosso:
Referência de string JavaScript completa .
A referência contém descrições e exemplos de todas as propriedades e métodos de string.