logo

JavaScript String includes() Mètode

El mètode includes(). retorna true si una cadena conté una cadena especificada. En cas contrari, retorna false. El mètode includes() distingeix entre majúscules i minúscules i pot acceptar un paràmetre de posició inicial opcional, simplificant les cerques de subcadenes dins de les cadenes per a diverses aplicacions.

Nota: El mètode includes () distingeix entre majúscules i minúscules, és a dir, tractarà els caràcters en majúscules i en minúscules de manera diferent.



Sintaxi

string.includes(searchvalue, start)>

Paràmetres

  • valor de cerca: És la cadena en què es durà a terme la cerca.
  • començar: Aquesta és la posició des d'on es processarà la cerca
    (tot i que aquest paràmetre no és necessari si no s'esmenta, la cerca començarà des de l'inici de la cadena).

Valor de retorn



Retorna un booleà cert que indica la presència o un fals que indica l'absència.

Exemple 1: Comprovació de si hi ha una cadena en una altra cadena

El codi comprova si la cadena Geeks està present a la cadena Benvingut a techcodeview.com. A continuació, registra el resultat, que éstrue>, ja que Geeks és realment present a la cadena.



javascript
let str = 'Welcome to techcodeview.com.'; let check = str.includes('Geeks'); console.log(check);>

Sortida
true>

Exemple 2: Comprovació de la cadena que distingeix entre majúscules i minúscules

Aquí, el segon paràmetre no està definit, de manera que la cerca es farà des de l'índex inicial. Però com que aquest mètode distingeix entre majúscules i minúscules, tractarà les dues cadenes de manera diferent, per tant retornarà un fals booleà.

javascript
let str = 'Welcome to techcodeview.com.'; let check = str.includes('geeks'); console.log(check);>

Sortida
false>

Exemple 3: Comprovació d'una cadena a un índex concret

El codi comprova si el caràcter o està present a la cadena Benvingut a techcodeview.com. a partir de l'índex 17. Després registra el resultat, que ésfalse>, ja que o no està present a la subcadena a partir de l'índex 17.

javascript
let str = 'Welcome to techcodeview.com.'; let check = str.includes('o', 17); console.log(check);>

Sortida
true>

Exemple 4: Índex d'inici negatiu

Si l'índex calculat (índex inicial), és a dir, la posició des de la qual començarà la cerca, és inferior a 0, es cercarà tota la matriu.

javascript
let str = 'Welcome to techcodeview.com.'; let check = str.includes('o', -2); console.log(check);>

Sortida
true>

Navegadors compatibles:

  • Google Chrome
  • Edge
  • Internet Explorer
  • Firefox
  • Òpera
  • Safari