JavaScript - Array includes() 方法



JavaScript Array includes() 方法用於陣列,檢查特定元素是否在陣列中。它返回一個布林值作為結果:“true”表示元素在陣列中找到,“false”表示元素不存在。此方法對於字串區分大小寫,並檢查物件引用。

如果我們為此方法提供一個負數的 "fromIndex",則搜尋從後往前開始。例如,-1 表示最後一個元素。

語法

以下是 JavaScript Array includes() 方法的語法:

array.includes(searchElement, fromIndex);

引數

此方法接受兩個引數。如下所述。

  • searchElement − 您在陣列中搜索的元素。
  • fromIndex − 陣列中開始搜尋的索引。如果未指定,則搜尋從陣列的開頭開始。

返回值

如果在陣列中找到搜尋元素,則此方法返回“true”,否則返回“false”。

示例

示例 1

在以下示例中,我們使用 JavaScript Array 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
廣告