javascript 配列の先頭に値を追加する

作成日 2020.09.01
更新日 2022.10.27
javascript
javascript

javascriptでunshiftメソッドを使用して、配列の先頭に値を追加するサンプルコードを記述してます。逆に最後に追加する場合はpushメソッドを使用します。

1. 環境
2. unshiftメソッド使い方
3. 最後に追加
4. サンプルコード

環境

OS windows11 pro 64bit
Apache 2.4.43
ブラウザ chrome 106.0.5249.103

Javascript サンプル集はこちら

unshiftメソッド使い方

unshiftメソッドを使うと、配列の先頭に複数の値を追加することが可能です。
※戻り値は、追加後の配列の要素数が返ります。

Array.unshift(値, 値...)

unshiftメソッド使い方

const arr = [1, 2, 3];

const num = arr.unshift(4, 5, 6);

console.log(arr);
//結果 [4, 5, 6, 1, 2, 3] ← 値が先頭に追加される

console.log(num); // 追加後の配列の数
//結果 6

配列自体を追加することもできます。

const arr = [1, 2, 3];

const num = arr.unshift([1,2,3]);

console.log(arr);

console.log(num);
//結果 4

最後に追加

逆に最後に追加する場合は「push」を使用します。

const arr = [1, 2, 3];

const num = arr.push(4, 5, 6);

console.log(arr);
//結果 [1, 2, 3, 4, 5, 6]

console.log(num); // 追加後の配列の数
//結果 6

サンプルコード

以下は、「追加」ボタンをクリックすると、ランダムに生成した値を配列の先頭に追加して表示するサンプルコードとなります。

※cssには「uikit」を使用してます。

<!DOCTYPE html>
<html lang="ja">

<head>
  <meta charset="utf-8">
  <title>mebeeサンプル</title>
  <!-- UIkit CSS -->
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/uikit@3.5.5/dist/css/uikit.min.css" />

  <!-- UIkit JS -->
  <script src="https://cdn.jsdelivr.net/npm/uikit@3.5.5/dist/js/uikit.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/uikit@3.5.5/dist/js/uikit-icons.min.js"></script>
</head>
<style>
  .main {
    margin: 0 auto;
    margin-top: 80px;
    display: flex;
    flex-direction: column;
    align-items: center;
    font-size: 20px;
  }
</style>
<script>

  function hoge() {

    //ランダムな9までの3個の配列を生成
    let arr = [];
    let num = 10;
    let length = 3;
    for (let i = 0; i < length; i++) {
      arr.push(Math.floor(Math.random() * num));
    }

    // 乱数を表示
    disp(arr, "txt");

    // 配列の先頭に乱数を追加する
    arr.unshift(Math.floor(Math.random() * num));

    // 乱数が追加された配列を表示
    disp(arr, "txt2");

  }

  //フロントに表示する関数
  function disp(arr, id) {

    let text = [];
    for (let i = 0; i < arr.length; i++) {
      text.push('<li>' + arr[i] + '</li>');
    }
    //innerHTMLを使用して表示    
    document.getElementById(id).innerHTML = text.join('');

  }

</script>

<body>
  <div class="main">
    <div class="uk-light uk-background-secondary uk-padding">

      <div class="uk-placeholder">
        <ul id="txt2" class="uk-list uk-list-square"></ul>
      </div>

      <ul id="txt" class="uk-list uk-list-square"></ul>

      <p uk-margin>
        <button class="uk-button uk-button-danger" onclick="hoge()">追加</button>
      </p>

    </div>
  </div>
</body>

</html>

配列の先頭に値が追加されていることが確認できます。