JS метод Array.indexOf()

Опис

Метод indexOf() пропонує простий спосіб визначення позиції елемента в масиві. Він порівнює searchElement з елементами масиву, використовуючи строгий принцип рівності — такий самий, як і у оператора ===. Цікаво, що значення NaN при такому порівнянні завжди вважається нерівним будь-якому іншому значенню, навіть самому собі. Отже, при спробі знайти NaN метод indexOf() завжди поверне -1.

Основна робота методу полягає в тому, що він повертає індекс першого входження searchElement у масив, або -1, якщо такого елемента немає. Таким чином, легко визначити, чи містить масив певний елемент, порівнюючи результат indexOf() з -1.

Приклад:

let fruits = ["apple", "banana", "cherry"];
let index = fruits.indexOf("banana");
console.log(index); // 1

У цьому прикладі ми шукаємо індекс елемента banana в масиві fruits. Метод indexOf() повертає значення 1, оскільки banana є другим елементом масиву (індексація починається з 0).

Нотатка:	Метод `indexOf()` приймає другий необов'язковий параметр `fromIndex`, який визначає початкову позицію для пошуку. Якщо цей параметр не вказано, пошук автоматично почнеться з нульового індексу. Якщо вам потрібно розпочати пошук, скажімо, з третьої позиції, ви можете використовувати наступний синтаксис: `myArray.indexOf('apple', 2)`.
Нотатка:	Важливо пам'ятати, що `indexOf()` використовує строгу рівність (`===`) для порівняння елементів. Це означає, що він порівнює значення елементів за типом та значенням. Для ілюстрації: якщо у вашому масиві є елемент з числовим значенням `5`, запит `myArray.indexOf('5')` поверне результат `-1`, адже хоча числове `5` та рядкове `'5'` можуть виглядати однаково, вони є різними типами даних.
Нотатка:	Важливо пам'ятати, що `indexOf()` порівнює елементи за їхніми значеннями, а не за їхніми посиланнями. Тому, наприклад, при пошуку об'єкта в масиві об'єктів, `indexOf()` не зможе знайти об'єкт, навіть якщо його вміст ідентичний шуканому, якщо вони є різними об'єктами в пам'яті.
Нотатка:	Зверніть увагу на те, що при великих масивах або частих операціях пошуку може бути ефективніше використовувати структури даних, які спеціально розроблені для цих цілей, такі як хеш-таблиці або дерева пошуку.
Нотатка:	`indexOf()` є універсальним методом, що вимагає наявності властивості `length` та інших властивостей з цілочисельними ключами в `this`.
Нотатка:	Зверніть увагу, що `indexOf()` ігнорує порожні слоти в розріджених масивах.

Синтаксис

indexOf(searchElement)
indexOf(searchElement, fromIndex)

Параметри

*searchElement: Елемент, який потрібно знайти в масиві.
fromIndex: Індекс, з якого почати пошук, перетворений у ціле число.

Від'ємний індекс рахується з кінця масиву - якщо fromIndex < 0, використовується fromIndex + array.length. Зверніть увагу, що в цьому випадку масив все ще проглядається з переду назад.

Якщо fromIndex < -array.length або fromIndex пропущено, використовується 0, що спричинює пошук по всьому масиву.

Якщо fromIndex >= array.length, масив не проглядається, і повертається -1.

Return

integer: Індекс першого елемента (який дорівнює searchElement) в масиві. Повертає -1, якщо елемент не знайдено.

Переглядачі

Переглядач
	1	1.5	3	9.5	12

Переглядач
	37	18	4	1

Переглядач
	0.10.0	1.0

Приклади

У цьому прикладі ми використовуємо метод indexOf() для пошуку індексу певного елемента в масиві. Метод indexOf() повертає перший індекс входження шуканого елемента або -1, якщо елемент не знайдено.


  See the Pen <a href="https://codepen.io/css_in_ua/pen/QWJMbPW">
  Untitled</a> by css.in.ua (<a href="https://codepen.io/css_in_ua">@css_in_ua</a>)
  on <a href="https://codepen.io">CodePen</a>.

Приклад використовує indexOf() для пошуку значень у масиві.

const array = [2, 9, 9];
array.indexOf(2); // 0
array.indexOf(7); // -1
array.indexOf(9, 2); // 2
array.indexOf(2, -1); // -1
array.indexOf(2, -3); // 0

У цьому прикладі ми знаходимо всі входження елемента "a" у масиві array і зберігаємо їх індекси в indices. В результаті виводимо масив індексів [0, 2, 4].

const indices = [];
const array = ["a", "b", "a", "c", "a", "d"];
const element = "a";
let idx = array.indexOf(element);
while (idx !== -1) {
  indices.push(idx);
  idx = array.indexOf(element, idx + 1);
}
console.log(indices);
// [0, 2, 4]

У цьому прикладі ми використовуємо indexOf() для пошуку значення undefined у масиві [1, , 3]. Оскільки між другим і третім елементами є пустий слот, пошук повертає значення -1. Ви можете скопіювати цей код для використання у своєму довіднику.

console.log([1, , 3].indexOf(undefined)); // -1

У цьому прикладі ми використовуємо метод indexOf() на об'єкті arrayLike, який не є масивом. Ми використовуємо call() для виклику методу indexOf() на об'єкті arrayLike, як будто це метод масиву. Метод indexOf() повертає індекс першого входження шуканого елемента. У нашому випадку, ми шукаємо значення 2 і 5. Оскільки об'єкт arrayLike має властивість length, рівну 3, пошук за межами довжини об'єкта повертає значення -1.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 4,
  3: 5, // ігнорується indexOf(), оскільки length дорівнює 3
};
console.log(Array.prototype.indexOf.call(arrayLike, 2));
// 0
console.log(Array.prototype.indexOf.call(arrayLike, 5));
// -1

JS довідник

JavaScript

Наповнення JS розділу