JavaScript 数组的 includes() 方法详解

includes() 方法检查数组中是否包含指定元素。

示例

// 定义一个数组
let languages = ["JavaScript", "Java", "C"];

// 检查数组是否包含 'Java'
let check = languages.includes("Java");

console.log(check);

// 输出：true

includes() 语法

includes() 方法的语法为：

arr.includes(valueToFind, fromIndex);

这里，arr 是一个数组。

includes() 参数

includes() 方法可以接受 两个 参数：

• valueToFind- 要搜索的值。
• fromIndex（可选）- 开始搜索的数组中的位置。默认为 0。

注意： 对于负值，从 数组长度 + fromIndex 开始搜索（从后向前数）。例如，-1 表示最后一个元素。

includes() 返回值

includes() 方法返回：

• 如果在数组中找到 valueToFind，则返回 true。
• 如果在数组中没有找到 valueToFind，则返回 false。

示例 1：使用 includes() 方法

let languages = ["JavaScript", "Java", "C", "C++"];

// 检查数组是否包含 'C'
let check1 = languages.includes("C");

console.log(check1); // true

// 检查数组是否包含 'Ruby'
let check2 = languages.includes("Ruby");

console.log(check2); // false

输出

true
false

在上面的示例中，我们使用 includes() 方法检查 languages 数组是否包含元素 'C' 和 'Ruby'。

languages.includes("C") 返回 true，因为数组包含 'C'；languages.includes("Ruby") 返回 false，因为数组不包含 'Ruby'。

示例 2：区分大小写的 includes() 搜索

includes() 方法区分大小写。例如：

let languages = ["JavaScript", "Java", "C", "Python"];

// 检查数组是否包含 'Python'
let check1 = languages.includes("Python");

console.log(check1); // true

// 检查数组是否包含 'python'
let check2 = languages.includes("python");

console.log(check2); // false

输出

true
false

这里 includes() 方法对 'Python' 返回 true，而对 'python' 返回 false。

这是因为该方法区分大小写，将 'Python' 和 'python' 视为两个不同的字符串。

示例 3：带两个参数的 includes()

let languages = ["JavaScript", "Java", "C", "Python"];

// 第二个参数指定开始搜索的位置
let check1 = languages.includes("Java", 2);

console.log(check1); // false

// 从倒数第三个元素开始搜索
let check2 = languages.includes("Java", -3);

console.log(check2); // true

输出

false
true

在上面的示例中，我们在 include() 方法中传递了两个参数值。

languages.includes("Java", 2) 返回 false，因为方法从数组的 第二个 索引开始搜索时没有找到 'Java'。

在 languages.includes("Java", -3) 中，由于负参数 -3，方法从 倒数第三个 元素开始搜索 'Java'。

推荐阅读： JavaScript 数组 indexOf()