Javascript metodi includes(), sisältää() suomeksi, palauttaa tosiarvon, jos yksikin taulukon alkio vastaa annettua alkiota.

includes(alkio, alkaenIndeksiluvusta)

alkio muuttuja
alkaenIndeksiluvusta numero (valinnainen)

includes() etsii taulukosta alkiota, joka vastaa annettua alkiota. Kun samanlainen alkio tulee vastaan, palautetaan tosiarvo, true. Jos vastaavaa alkiota ei tule vastaan, palautetaan false.

> [1, 2, 3].includes(3)
true

> [1, 2, 3].includes(4)
false

Vertailu alkioiden kesken tehdään tiukan samankaltaisuuden perusteella kuten ’===’, joten esimerkiksi numero ja sama numero merkkijonona ei vastaa toisiaan. Myöskään kaksi saman tiedon sisältävää oliota ei vastaa toisiaan.

> ['1', '2', '3'].includes(1)
false

> [{ a: 1 }, { a: 2 } ].includes({ a: 1 })
false

includes() metodille voi antaa toisena parametrinä indeksiluvun, josta alkaen samanlaista alkiota etsitään. Jos parametrinä annetaan indeksiluku, joka on pidempi tai yhtä pitkä kuin taulukko itse, palautetaan suoraan false ilman etsintää.

Jos annettu indeksiluku on negatiivinen, sijainti, mistä etsintä aloitetaan, lasketaan taulukon lopusta. Esimerkiksi -1 vastaa taulukon viimeistä alkiota. -2 taulukon toiseksi viimeistä alkiota. Alkiota kuitenkin etsitään siitä indeksiluvusta taulukon loppuun päin.

> ['a', 'b', 'c'].includes('a', 5)
false

> ['a', 'b', 'c'].includes('a', 1)
false

> ['a', 'b', 'c', 'a'].includes('a', 1)
true

> ['a', 'b', 'c'].includes('a', -1)
false