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 коротких урока на телефоне.





