JavaScriptTablice
Array.
Sprawdza, czy tablica zawiera podaną wartość.
- Zwraca
truealbofalse.- Zmienia oryginał
- Nie
Przykład
#JavaScript
const languages = ['HTML', 'CSS', 'JavaScript']
console.log(languages.includes('CSS'))
console.log(languages.includes('css'))
console.log([1, NaN].includes(NaN))Konsola
true
false
true
Definicja i zastosowanie
#Metoda includes() zwraca true, jeśli tablica zawiera wartość równą podanej, i false w przeciwnym razie. To najprostszy sposób na pytanie „czy ten element jest na liście?”.
Porównanie działa jak ===, z jednym wyjątkiem: includes() potrafi znaleźć NaN, czego nie umie indexOf(). Obiekty porównywane są przez referencję, więc [{ a: 1 }].includes({ a: 1 }) zwróci false.
Drugi, opcjonalny argument pozwala zacząć szukanie od podanego indeksu.
Składnia
#Składnia
array.includes(searchElement)
array.includes(searchElement, fromIndex)Parametry
#searchElement
dowolna wartość
Szukana wartość.fromIndex
opcjonalny
Indeks, od którego zacząć. Wartość ujemna liczy od końca.
Obsługa przeglądarek
#Szeroko dostępne
Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.
- Chrome
- Edge
- Firefox
- Safari
Dobre praktyki
#- Wielkość liter ma znaczenie. Przy porównywaniu tekstu wpisanego przez użytkownika najpierw ujednolić go, np.
toLowerCase(). - Przy bardzo częstym sprawdzaniu w dużym zbiorze szybszy jest
Seti jego metodahas().
Powiązane hasła
#- Array.prototype.indexOf()Zwraca indeks pierwszego wystąpienia wartości albo -1.
- Array.prototype.some()Sprawdza, czy przynajmniej jeden element spełnia warunek.
- String.prototype.includes()Sprawdza, czy napis zawiera podany fragment tekstu. Zwraca true albo false i rozróżnia wielkość liter.
- SetKolekcja unikalnych wartości: każda wartość może wystąpić w zbiorze tylko raz.
Widzisz błąd albo brakuje przykładu? Napisz do nas.