Método String includes() do JavaScript

definição e uso

se a string contiver a string especificada,includes() o método retornará true.

de outra forma retorna false.

includes() o método distingue entre maiúsculas e minúsculas.

instância

Exemplo 1

Verificar se a string contém "world":

let text = "Hello world, welcome to the universe.";
let result = text.includes("world");

Experimente você mesmo

let text = "Hello World, welcome to the universe.";
let result = text.includes("world", 12);

Experimente você mesmo

Exemplo 2

A partir da posição 12:

let text = "Hello world, welcome to the universe.";
let result = text.includes("world", 12);

Experimente você mesmo

sintaxe

string.includes(searchvalue, start)

parâmetros

parâmetros descrição
searchvalue obrigatório. A string a ser pesquisada.
start opcional. A posição de início. O valor padrão é 0.

valor de retorno

tipo descrição
booleano se a string contiver esse valor, então truecaso contrário, é false.

suporte do navegador

includes() é uma característica do ECMAScript6 (ES6).

Todos os navegadores modernos suportam ES6 (JavaScript 2015):

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
suporta suporta suporta suporta suporta

Internet Explorer 11 (ou versões mais antigas) não suporta includes().

Páginas relacionadas

String JavaScript

Métodos da String JavaScript

Pesquisa de String JavaScript