logo

String JavaScript inclui()

A sequência JavaScript inclui() O método é usado para determinar se a substring especificada está ou não presente na string fornecida. É um método que diferencia maiúsculas de minúsculas. Ele retorna o valor booleano, ou verdadeiro ou falso . Ele retorna verdadeiro se a string contém a substring especificada e retorna falso se não.

Isso não altera o valor da string original.

Sintaxe

A sintaxe a seguir representa o inclui() método:

 string.includes(searchValue, start); 

Valores de parâmetros

Os valores dos parâmetros deste método são definidos da seguinte forma:

valor de pesquisa: É um parâmetro obrigatório. É a substring a ser pesquisada.

começar: É um parâmetro opcional. Representa a posição onde iniciar a busca na string. Seu valor padrão é 0. Quando for omitido, a busca começará a partir da posição inicial da string, ou seja, de 0 .

Vamos entender o inclui() método usando alguns exemplos.

Exemplo 1

É um exemplo simples para determinar se a string fornecida contém a substring especificada. Aqui estamos declarando uma variável str e atribuindo um valor de string 'Bem-vindo ao javaTpoint.com' para isso. Então usamos o inclui() método para determinar se a substring fornecida (' para ') está presente ou não.

Aqui não estamos definindo a posição para iniciar a busca. Assim, a busca começará a partir da posição inicial da string.

 <h3> This is an example of using the JavaScript string includes() method. </h3> let str = &apos;Welcome to the javaTpoint.com&apos;; document.write(&apos; <b> The given string is: </b> &apos;, str); document.write(&apos; <br>&apos;); let res = str.includes(&apos;the&apos;, 10); document.write(&apos; <b> The result of str.includes(&apos;the&apos;, 10) is : </b> &apos;, res); 

Saída

String JavaScript inclui()