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

Array.prototype.findIndex()

[_] [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]

findIndex(callbackFn)
findIndex(callbackFn, thisArg)

Przykłady:

const tablica = [5, 10, 15, 20, 25];
const zadanie = (element) => element > 19;
console.log(tablica.findIndex(zadanie));
// 3

function zadanie(e) {
 if (e % 2 === 0 || e < 2) {
 return false;
 }
 for (let i = 3; i <= Math.sqrt(e); i += 2) {
 if (e % i === 0) {
 return false;
 }
 }
 return true;
}

console.log([1, 2, 3, 4, 5].findIndex(zadanie)); // 2
console.log([2, 4, 6, 8, 10].findIndex(zadanie)); // -1
console.log([1, 5, 9, 14, 15].findIndex(zadanie)); // 1

const tablica = [5, 10, , 20, 25];
const zadanie = (element) => element === undefined;
console.log(tablica.findIndex(zadanie));
// 2

const tablica = {
 length: 6,
 "-4": 0.7,
 0: 2,
 1: 8,
 2: 1.2,
 3: 9.5,
 4: 4,
};
console.log(
 Array.prototype.findIndex.call(tablica, (x) => !Number.isInteger(x)),
); // 2

Opis:
Metoda Array.findIndex() instancji Array zwraca indeks pierwszego elementu tablicy, który spełnia podaną funkcję testującą. Jeśli żaden element nie spełnia funkcji testującej, zwracane jest -1. Zobacz także find() metodę, która zwraca pierwszy element spełniający funkcję testującą (a nie jej indeks). Pierwszy parametr funkcja do wykonania dla każdego elementu tablicy. Powinien zwrócić wartość prawdziwą , wskazującą, że znaleziono pasujący element, lub wartość fałszywą w przeciwnym razie. Funkcja wywoływana jest z następującymi argumentami: Pierwszy argument bieżący element przetwarzany w tablicy. Drugi argument indeks bieżącego elementu przetwarzanego w tablicy. Trzeci argument tablica findIndex() została wywołana. Parametr drugi opcjonalny wartość, która ma być używana this podczas wykonywania pierwszego parametru. Wartość zwracana Indeks pierwszego elementu tablicy, który przeszedł test. W przeciwnym razie -1. findIndex() metoda iteracyjna. Wywołuje podaną funkcję raz dla każdego elementu tablicy w kolejności rosnącej, dopóki callbackFn nie zwróci wartości prawdziwej. findIndex() następnie zwraca indeks tego elementu i zatrzymuje iterację po tablicy. Jeśli callbackFn nigdy nie zwraca prawdziwej wartości, findIndex() zwraca -1. callbackFn jest wywoływana dla każdego indeksu tablicy, a nie tylko tych z przypisanymi wartościami. Puste miejsca w rzadkich tablicach zachowują się tak samo jak undefined. findIndex() nie mutuje tablicy, na której jest wywoływany, ale podaną funkcję, jak callbackFn można. Należy jednak pamiętać, że długość tablicy jest zapisywana przed pierwszym wywołaniem callbackFn. Dlatego: callbackFn nie odwiedzi żadnych elementów dodanych poza początkową długość tablicy w momencie findIndex() rozpoczęcia wywołania. Zmiany w już odwiedzonych indeksach nie powodują callbackFn ponownego wywołania ich. Jeśli istniejący, jeszcze nieodwiedzony element tablicy zostanie zmieniony przez callbackFn, jego wartość przekazana do callbackFn będzie wartością obowiązującą w momencie odwiedzenia tego elementu. Usunięte elementy są odwiedzane tak, jakby były undefined. Metoda findIndex() jest ogólna. Oczekuje tylko, że this wartość będzie miała length właściwość i właściwości z kluczem całkowitym.

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: