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'
。