[ Leksykon ] [ JavaScript ] [ Tablice ] [ Metody ] [ Właściwości ] [ Array() ]

Array.prototype.includes()

[_] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [K] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Y] [Z]

 

Przykłady:

const tablicaA = [1, 2, 3, 4, 5];
console.log(tablicaA.includes(5));
// true

  

const tablicaB = ['A', 'B', 'C'];
console.log(tablicaB.includes('B'));
// true
console.log(tablicaB.includes('X'));
// false

 

const tablicaA = [1, 2, 3, 4, NaN];
console.log(tablicaA.includes(3, -1)); // false
console.log(tablicaA.includes(3, 2)); // true
console.log(tablicaA.includes(NaN)); // true
console.log(tablicaA.includes("3")); // false

 

const tablicaA = [1, 2, 3, , NaN];
console.log(tablicaA.includes(3, -100)); // true
console.log(tablicaA.includes(undefined)); // true

 

const tablicaA = {
 length: 3,
 0: 2,
 1: 3,
 2: 4,
 3: 5,
};
console.log(Array.prototype.includes.call(tablicaA, 2));
// true
console.log(Array.prototype.includes.call(tablicaA, 5));
// false

 

  

Opis:
Metoda Array.includes() instancji Array określa, czy tablica zawiera określoną wartość wśród swoich wpisów, zwracaną true lub false. Pierwszy parametr wartość do wyszukania. Drugi parametr opcjonalny indeks od zera, od którego należy rozpocząć wyszukiwanie. Indeks ujemny odliczany jest od końca tablicy, jeśli parametr opcjonalny < 0 używany jest parametr opcjonalny + array.length. Jednak w tym przypadku tablica jest nadal przeszukiwana od przodu do tyłu. Jeśli parametr opcjonalny < -array.length lub from Index zostanie pominięte, 0 zostanie użyte, powodując przeszukanie całej tablicy. Jeżeli parametr opcjonalny >= array.length, tablica nie jest przeszukiwana i false jest zwracana. Wartość zwracana wartość logiczna, która występuje true, jeśli wartość zostanie znaleziona w tablicy lub części tablicy wskazanej przez indeks, jeśli został określony.

Jeśli chcesz znaleźć:

- pierwszy pasujący element, użyj Array.find()
- indeks ostatniego pasującego elementu w tablicy, użyj Array.findLastIndex()
- indeks wartości, użyj Array.indexOf(). Jest podobny do Array.findIndex(), ale zamiast używać funkcji testującej, sprawdza każdy element pod kątem równości z wartością.
- czy wartość istnieje w tablicy, użyj Array.includes(). Ponownie sprawdza każdy element pod kątem równości z wartością, zamiast używać funkcji testującej.
- jeśli jakikolwiek element spełnia podaną funkcję testującą, użyj Array.some().

Linki: