Что такое…

includes или indexOf — и почему проверка пускает гостя, а админа нет

Иллюстрация: лампочка «да/нет» и указатель на самый первый ящик

Смотри, вот баг, который выглядит как мистика. Есть проверка «пускать ли в админку»:

const roles = ["admin", "user"];
if (roles.indexOf(role)) {
  openAdminPanel();
}

Админ приходит — его не пускают. Заходит гость, которого в списке нет вообще, — пускают. Код работает ровно наоборот. И виновата не логика, а выбор метода.

Что делает каждый

Оба метода ищут значение в массиве или строке. Разница — в том, что они отвечают.

  • includes отвечает на вопрос «есть или нет». Возвращает true или false.
  • indexOf отвечает на вопрос «где». Возвращает номер позиции. А если не нашёл — -1.

Теперь баг становится понятен. У "admin" позиция 0 — он первый в списке. А 0 в условии считается ложью. Гостя нет в списке — indexOf вернул -1. А любое ненулевое число в условии — правда. Подробнее об этих «почти правдах» — в разборе булевых значений.

Мы проверили в Node 22: !!["admin","user"].indexOf("admin") даёт false, а для "guest" — true. Всё сходится.

Сравнение по пунктам

  • Что возвращает. includes: true или false. indexOf: позицию или -1.
  • Как читать в if. includes можно ставить в условие как есть. indexOf надо сравнивать: indexOf(x) !== -1. Забыл сравнение — получил баг выше.
  • Поиск NaN. [NaN].includes(NaN) — true. [NaN].indexOf(NaN) — -1, не находит. Это редкость, но в данных из таблиц NaN встречается.
  • Дырки в массиве. В массиве [, 1] есть пустое место. includes(undefined) его находит, indexOf(undefined) — нет.
  • Поиск в строке. Оба работают и со строками: "привет".includes("ив") — true, "привет".indexOf("ив") — 2. Пустую строку оба находят на нулевой позиции.
  • Возраст. indexOf есть с древних времён. includes у массивов появился в стандарте 2016 года и работает во всех современных браузерах.
  • Поиск объекта по полю. Не умеет никто. Оба сравнивают значение целиком. Для «найди пользователя с id 7» нужны find или some.

Кому что подойдёт

Вердикт без дипломатии:

  • Нужно «есть или нет» — бери includes. Это 9 случаев из 10. Код читается как фраза, и баг с нулём невозможен.
  • Нужна позиция — бери indexOf. Например, чтобы вырезать кусок строки до найденного места или удалить элемент по номеру. Но всегда сравнивай с -1.
  • Видишь if (arr.indexOf(x)) без сравнения — это баг. Даже если пока работает. Попроси ИИ заменить на includes.
Слабый промптПочему не работает проверка роли?
Сильный промптПроверка if (roles.indexOf(role)) пускает в админку гостей и не пускает admin. Объясни, почему так из-за возвращаемого значения indexOf, и перепиши проверку через includes. Найди в проекте все места, где результат indexOf используется в условии без сравнения с -1, и покажи их списком.

Последний пункт промпта — самый полезный. Такой баг редко живёт в одном месте: ИИ копирует свой же паттерн по всему проекту.

А если ищешь объект — some и find

Частая путаница: ИИ пишет users.includes({ id: 7 }) и удивляется, что всегда false. Два объекта равны, только если это один и тот же объект в памяти. Новый { id: 7 } — другой, даже с теми же полями.

Для поиска по полю есть пара похожих методов:

  • some — «есть ли хоть один такой». Аналог includes для объектов: users.some(u => u.id === 7) вернёт true или false.
  • find — «дай мне его». Вернёт сам объект или undefined.
  • findIndex — аналог indexOf: номер или -1. И та же ловушка с нулём в условии.

Логика выбора та же: нужен ответ «да/нет» — some, нужна сама запись — find.

includes работает быстрее indexOf?

Практически одинаково: оба просматривают массив по порядку. Если проверок тысячи на большом списке, быстрее будет Set с методом has — он находит значение без перебора.

Можно ли искать с определённой позиции?

Да, у обоих есть второй аргумент — с какого места начинать. arr.includes(x, 3) ищет начиная с четвёртого элемента.

Как проверить, есть ли ключ в объекте?

includes тут не поможет — он для значений. Для ключей есть Object.hasOwn(obj, "email"). Оператор "email" in obj тоже работает, но находит и унаследованное: "toString" in {} даёт true.

А как это выглядит в Python?

Там вопрос «есть или нет» задаётся оператором in: "admin" in roles. А позицию даёт roles.index("admin") — но если значения нет, Python не вернёт -1, а выбросит ошибку. Так что «перевёрнутой» проверки, как в JavaScript, там не случится.

А что с регистром букв?

Оба метода чувствительны к регистру: "Admin" и "admin" — разные строки. Приводи к одному виду перед сравнением, например через toLowerCase().

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →