База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.includes: проверка за наличие на стойност

includes връща boolean дали диапазон от масива съдържа стойност според SameValueZero.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.includes(searchElement[, fromIndex])

array.includes(searchElement[, fromIndex]) търси от fromIndex и при първото съвпадение SameValueZero връща true. Така NaN е равно на NaN, а +0 на -0. Методът връща само boolean, не индекс.

fromIndex се отрязва до цяло число; отрицателен индекс брои от края, прекалено отрицателен започва от нула, а Infinity дава false. Дупките се четат като undefined и могат да съвпаднат. Методът е общ за array-like получатели и не ги променя; null/undefined хвърля TypeError. Примерът показва NaN, дупка и ограничено начало.

Примери

const values = [NaN, , 0];
console.log(values.includes(NaN));
console.log(values.includes(undefined));
console.log(values.includes(0, -1));
console.log(values.includes(NaN, 1));

Резултат

true
true
true
false

Източници