← 返回首页
Array.prototype.includes() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Веб-технологии для разработчиков
  2. JavaScript
  3. Справочник по JavaScript
  4. Стандартные встроенные объекты
  5. Array
  6. Array.prototype.includes()
Theme
  • OS default
  • Light
  • Dark
Русский
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Array.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since август 2016 г..

Метод includes() экземпляров Array определяет, содержит ли массив определенное значение, возвращая true или false.

In this article

Интерактивный пример

const array1 = [1, 2, 3]; console.log(array1.includes(2)); // Expected output: true const pets = ["cat", "dog", "bat"]; console.log(pets.includes("cat")); // Expected output: true console.log(pets.includes("at")); // Expected output: false

Синтаксис

js
includes(searchElement) includes(searchElement, fromIndex)

Параметры

searchElement

Проверяемое значение.

fromIndex Необязательный

Индекс, с которого начинать поиск. Начинается с нуля и преобразуется в целое число.

  • При отрицательных значениях поиск производится с конца массива. Если -array.length <= fromIndex < 0, то будет применено значение fromIndex + array.length. Однако в этом случае поиск будет производится с начала массива.
  • Если fromIndex < -array.length или fromIndex не указан, то используется значение 0, то есть производится поиск по всему массиву.
  • Если fromIndex >= array.length, то поиск не производится и возвращается false.

Возвращаемое значение

Логическое значение, true если значение searchElement найдено в массиве (или части массива, если указан параметр fromIndex).

Описание

Метод includes() сравнивает searchElement с элементами массива используя алгоритм сравнения SameValueZero. Все нулевые значения считаются равными, независимо от знака (то есть -0 и 0 равны), но false не равно 0. Значение NaN доступно для поиска.

При использовании в разреженных массивах, метод includes() метод считает, что пустые позиции имеют значение undefined.

Метод includes() является универсальным, то есть может быть вызван не только у массивов, но и у массивоподобных объектов (у которых значение this имеет свойство length и свойства с целочисленными ключами).

Примеры

Использование includes()

js
[1, 2, 3].includes(2); // true [1, 2, 3].includes(4); // false [1, 2, 3].includes(3, 3); // false [1, 2, 3].includes(3, -1); // true [1, 2, NaN].includes(NaN); // true ["1", "2", "3"].includes(3); // false

fromIndex больше или равен длине массива

Если fromIndex больше или равен длине массива, то возвращается false. При этом поиск не производится.

js
const arr = ["a", "b", "c"]; arr.includes("c", 3); // false arr.includes("c", 100); // false

Вычисленный индекс меньше нуля 0

Если fromIndex отрицательный, то вычисляется индекс, начиная с которого будет производиться поиск элемента searchElement. Если вычисленный индекс меньше нуля, то поиск будет производиться во всём массиве.

js
// длина массива равна 3 // fromIndex равен -100 // вычисленный индекс равен 3 + (-100) = -97 const arr = ["a", "b", "c"]; arr.includes("a", -100); // true arr.includes("b", -100); // true arr.includes("c", -100); // true arr.includes("a", -2); // false

Использование includes() в разреженных массивах

Можно производить поиск undefined в разреженном массиве и получать true.

js
console.log([1, , 3].includes(undefined)); // true

Вызов includes() у объектов, не являющихся массивами

Метод include() считывает свойство length у this, а затем обращается к каждому свойству, ключ которого представляет собой неотрицательное целое число, меньшее length.

js
const arrayLike = { length: 3, 0: 2, 1: 3, 2: 4, 3: 1, // includes() не будет обращаться к этому элементу, потому что свойство length равно 3 }; console.log(Array.prototype.includes.call(arrayLike, 2)); // true console.log(Array.prototype.includes.call(arrayLike, 1)); // false

Спецификации

Specification
ECMAScript® 2027 Language Specification
# sec-array.prototype.includes

Совместимость с браузерами

Enable JavaScript to view this browser compatibility table.

Смотрите также

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 24 мар. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Стандартные встроенные объекты
  2. Array
  3. Конструктор
    1. Array()
  4. Статические методы
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. Статические свойства
    1. get Array[@@species]
  6. Методы экземпляра
    1. Array.prototype.at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. Array.prototype.every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. findLastIndex()
    12. Array.prototype.flat()
    13. Array.prototype.flatMap()
    14. Array.prototype.forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. Array.prototype.reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. Array.prototype.some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. Array.prototype.toLocaleString()
    32. Array.prototype.toReversed()
    33. Array.prototype.toSorted()
    34. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. Array.prototype.with()
    39. Array.prototype[@@iterator]()
  7. Свойства экземпляра
    1. Array.length
    2. Array.prototype[@@unscopables]
  8. Наследование
  9. Object/Function
  10. Статические методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  11. Статические свойства
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  12. Методы экземпляра
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. Свойства экземпляра
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.