JavaScript Array includes()

includes() 方法用于检查一个 数组 是否包含指定的元素。

示例

// defining an array
let languages = ["JavaScript", "Java", "C"];

// checking whether the array contains 'Java' let check = languages.includes("Java");
console.log(check); // Output: true

includes() 语法

includes() 方法的语法是:

arr.includes(valueToFind, fromIndex)

这里,arr 是一个数组。


includes() 参数

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

  • searchValue - 要搜索的值。
  • fromIndex (可选) - 开始搜索的数组位置。默认为 0

注意: 对于负值,搜索从 array.length + fromIndex 开始(从后往前计数)。例如,-1 表示最后一个元素。


includes() 返回值

includes() 方法返回:

  • 如果 searchValue 在数组的任何位置找到,则返回 true
  • 如果 searchValue 在数组的任何位置都未找到,则返回 false

示例 1:使用 includes() 方法

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

// checking whether the array contains 'C' let check1 = languages.includes("C");
console.log(check1); // true
// checking whether the array contains '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"];

// checking whether the array contains 'Python' let check1 = languages.includes("Python");
console.log(check1); // true
// checking whether the array contains 'python' let check2 = languages.includes("python");
console.log(check2); // false

输出

true
false

在这里,对于 searchValue 'Python'includes() 方法返回 true;对于 'python',则返回 false

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


示例 3:includes() 配合两个参数使用

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

// second argument specifies position to start the search let check1 = languages.includes("Java", 2);
console.log(check1); // false
// the search starts from third last element 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 Array indexOf()

你觉得这篇文章有帮助吗?

我们的高级学习平台,凭借十多年的经验和数千条反馈创建。

以前所未有的方式学习和提高您的编程技能。

试用 Programiz PRO
  • 交互式课程
  • 证书
  • AI 帮助
  • 2000+ 挑战