JavaScript - Array unshift() 方法

在 JavaScript 中，**Array.unshift()** 方法用於在陣列開頭新增一個或多個元素，並返回陣列的新長度。此方法會覆蓋現有陣列。

為了為新元素騰出空間，它透過將現有元素移到下一個（更高）索引來修改陣列。例如，如果我們考慮一個數組 arr = [1, 2, 3]；如果我們新增 arr.unshift(11,22)；那麼結果將是 [11,22,1,2,3]。

語法

以下是 JavaScript Array unshift() 方法的語法：

array.unshift(element1, element2, ...,elementN)

引數

此方法接受一個引數。下面描述了該引數：

**"element1…element"** 是將新增到陣列開頭的元素。

返回值

此方法將一個或多個元素新增到陣列的開頭。它修改原始陣列並返回陣列的新長度。

示例

示例 1

在以下示例中，我們使用 JavaScript Array unshift() 方法在陣列開頭新增新元素。

<html>
<body>
   <p id="demo1"></p>
   <p id="demo2"></p>
   <script>
      const animals = ["Tiger", "Elephant", "Dinosaur"];
      animals.unshift("Lion", "Cheetah");
      document.getElementById("demo1").innerHTML = animals;
      document.getElementById("demo2").innerHTML = animals.length;
   </script>
</body>
</html>

執行上述程式後，新元素將新增到陣列的開頭。此外，陣列的長度從 3 變為 5。

輸出

Lion,Cheetah,Tiger,Elephant,Dinosaur

5

示例 2

如果我們沒有向 unshift() 方法傳遞任何元素，則陣列的元素和長度保持不變。

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

陣列的長度和元素保持不變。

示例 3

這裡，子陣列 [1, 4] 被視為單個元素，並將其新增到 animals 陣列的開頭。結果，陣列的長度變為 6。

<html>
<body>
   <p id="demo1"></p>
   <p id="demo2"></p>
   <script>
      const animals = ["Lion", "Cheetah", "Tiger", "Elephant", "Dinosaur"];
      animals.unshift([1, 4]);
      document.getElementById("demo1").innerHTML = animals;
      document.getElementById("demo2").innerHTML = animals.length;
   </script>
</body>
</html>

輸出

正如我們在輸出中看到的，元素已新增到陣列的開頭，並且長度已覆蓋為 6。

1,4,Lion,Cheetah,Tiger,Elephant,Dinosaur

6

列印頁面