JS includes()方法|极客笔记

JS includes()方法

1. 概述

在JavaScript中，includes()方法是一个用于判断一个数组或字符串是否包含指定元素的方法。该方法会返回一个布尔值，表示目标数组或字符串是否包含指定元素。本文将详细介绍includes()方法的用法、参数和返回值，并提供一些示例代码进行演示。

2. 语法

includes()方法的语法如下所示：

array.includes(searchElement, fromIndex)

其中，array表示需要进行判断的数组或字符串；searchElement表示要搜索的元素；fromIndex是一个可选参数，表示开始搜索的位置索引。

3. 参数

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

searchElement：要搜索的元素。
fromIndex：可选参数，表示开始搜索的位置索引。如果省略该参数，则从数组或字符串的头部开始搜索。若该参数为负数，则表示从末尾开始计算。

4. 返回值

includes()方法的返回值为一个布尔值，表示目标数组或字符串是否包含指定元素。如果包含指定元素，则返回true；反之，返回false。

5. 示例代码

接下来，我们将通过一些简单的示例代码来演示includes()方法的使用场景。

示例 1：数组中的使用

const fruits = ["apple", "banana", "orange", "grape"];

console.log(fruits.includes("banana"));  // true
console.log(fruits.includes("watermelon"));  // false
console.log(fruits.includes("apple", 1));  // false
console.log(fruits.includes("apple", -2));  // false

运行结果：

true
false
false
false

在示例中，fruits是一个包含多个水果名称的数组。我们调用includes()方法来判断数组中是否包含了特定的元素。第一个打印语句中，数组中确实包含了字符串”banana”，所以输出为true。而第二个打印语句中，数组中并不包含字符串”watermelon”，所以输出为false。第三个和第四个打印语句中，我们修改了fromIndex参数的值，从而改变了搜索的起始位置。在这两种情况下，都无法找到匹配的元素，所以最终输出也为false。

示例 2：字符串中的使用

const str = "Hello, world!";

console.log(str.includes("world"));  // true
console.log(str.includes("World"));  // false
console.log(str.includes("w", 7));  // false
console.log(str.includes("o", -3));  // false

运行结果：

true
false
false
false

在示例中，我们定义了一个字符串str。通过调用includes()方法，我们可以在字符串中判断是否包含某个子串。第一个打印语句中，字符串str中确实包含子串”world”，所以输出为true。但是，在第二个打印语句中，由于字符串的大小写敏感性，”world”与”World”并不相同，所以返回结果为false。

同时，在第三个和第四个打印语句中，我们也可以通过修改fromIndex参数的值来改变搜索起始位置。但无论如何设置，都无法匹配到指定的元素，所以输出始终为false。

示例 3：判断某个元素是否是NaN

const numbers = [1, 2, NaN, 4];

console.log(numbers.includes(NaN));  // true

运行结果：

true

在示例中，我们创建了一个包含数字和NaN的数组numbers。然后，我们调用includes()方法来判断数组中是否存在NaN。由于NaN无法通过常规的比较运算符进行精确的匹配，所以includes()方法提供了与NaN的比较支持，可以正确判断NaN是否包含在目标数组中。在本示例中，数组numbers中确实存在NaN，所以输出为true。