在JavaScript中,includes()
是一个数组(Array)和字符串(String)对象的方法,用于确定一个数组是否包含一个特定的值,或者一个字符串是否包含一个特定的子串。如果找到该值或子串,则返回 true
;否则返回 false
。
数组中的 includes()
对于数组,includes()
方法用于判断一个数组是否包含一个指定的值,根据情况,如果需要,可以指定开始搜索的位置。
语法:
javascript复制代码
arr.includes(valueToFind[, fromIndex]) |
valueToFind
:必需。需要查找的元素值。fromIndex
:可选。从该索引处开始查找valueToFind
。如果为负值,则按升序从array.length + fromIndex
的索引开始搜寻。即使整个数组已经被搜索,fromIndex
仍然会被当作有效位置。如果省略该参数,则整个数组都会被搜索。
示例:
javascript复制代码
const array1 = [1, 2, 3, 4, 5]; | |
console.log(array1.includes(3)); // 输出: true | |
console.log(array1.includes(6)); // 输出: false | |
// 使用 fromIndex | |
console.log(array1.includes(3, 3)); // 输出: false | |
console.log(array1.includes(3, -1)); // 输出: true |
字符串中的 includes()
对于字符串,includes()
方法用于判断一个字符串是否包含另一个字符串,或者是否包含指定的子串。
语法:
javascript复制代码
str.includes(searchString[, position]) |
searchString
:必需。要查找的字符串。position
:可选。开始搜索的位置。如果省略该参数,则从头开始搜索。
示例:
javascript复制代码
const str = 'Hello, world!'; | |
console.log(str.includes('world')); // 输出: true | |
console.log(str.includes('universe')); // 输出: false | |
// 使用 position | |
console.log(str.includes('world', 7)); // 输出: false | |
console.log(str.includes('world', 0)); // 输出: true |
includes()
方法对于不区分大小写的搜索是不适用的。如果你需要进行不区分大小写的搜索,你需要先将字符串转换为全部大写或全部小写,然后再使用 includes()
方法。
javascript复制代码
const str = 'Hello, World!'; | |
const search = 'world'; | |
console.log(str.toLowerCase().includes(search.toLowerCase())); // 输出: true |
请注意,includes()
方法不会改变原数组或原字符串,它只是返回一个布尔值来指示是否找到了指定的值或子串。