JavaScript - 数组 includes() 方法

JavaScript 数组 includes() 方法用于检查数组中是否存在特定元素。它返回一个布尔值:如果在数组中找到该元素，则返回 true;如果不存在，则返回 false。此方法区分字符串的大小写，并检查对象引用。

如果我们为该方法传入一个负数"fromIndex"，则从后往前搜索。例如，-1 表示最后一个元素。

语法

以下是 JavaScript 数组 includes() 方法的语法 -

array.includes(searchElement, fromIndex);

参数

此方法接受两个参数。下文将对此进行描述。

• searchElement − 您在数组中搜索的元素。
• fromIndex − 数组中开始搜索的索引。如果未指定，则从数组的开头开始搜索。

返回值

如果在数组中找到搜索元素，则此方法返回"true"，否则返回"false"。

示例

示例 1

在下面的示例中，我们使用 JavaScript 数组的 includes() 方法在指定数组中搜索元素"Dinosaur"。

<html>
<body>
   <p id="demo"></p>
   <script>
      const animals = ["Lion", "Cheetah", "Tiger", "Elephant", "Dinosaur"]
      let result = animals.includes("Dinosaur");
      document.getElementById("demo").innerHTML = result;
   </script>
</body>
</html>

输出

执行程序后，includes() 方法返回"true"，因为元素 Dinosaur 存在于指定数组中。

true

示例 2

在下面的示例中，我们在指定数组中搜索元素"Wolf"-

<html>
<body>
   <p id="demo"></p>
   <script>
      const animals = ["Lion", "Cheetah", "Tiger", "Elephant", "Dinosaur"]
      let result = animals.includes("Wolf");
      document.getElementById("demo").innerHTML = result;
   </script>
</body>
</html>

输出

执行程序后，includes() 方法返回"false"，因为元素"Dinosaur"不存在于指定的数组中。

false

示例 3

这里，我们检查指定的数组是否包含元素"Elephant"，从索引位置 2 开始 -

<html>
<body>
   <p id="demo"></p>
   <script>
      const animals = ["Lion", "Cheetah", "Tiger", "Elephant", "Dinosaur"]
      let result = animals.includes("Elephant", 2);
      document.getElementById("demo").innerHTML = result;
   </script>
</body>
</html>

输出

程序返回 true，因为元素"Elephant"位于索引位置 2 之后。

true

示例 4

这里，我们检查指定数组是否包含元素"Cheetah"，从索引位置 3 开始 -

<html>
<body>
   <p id="demo"></p>
   <script>
      const animals = ["Lion", "Cheetah", "Tiger", "Elephant", "Dinosaur"]
      let result = animals.includes("Cheetah", 3);
      document.getElementById("demo").innerHTML = result;
   </script>
</body>
</html>

输出

程序返回"false"，因为元素"Cheetah"位于索引位置 3 之后。

false