初級

push()の戻り値は追加後の配列ではなく新しい要素数

Array.prototype.pushは追加後の配列ではなく、追加後の要素数（数値）を返します。戻り値を配列として扱おうとすると、数値にはない配列のプロパティやメソッドでエラーや予期しない結果になります。

なぜエラーが出ないのか

出力: undefined

（エラーなし）

JavaScriptは何も報告しません。文法として正しいためです

出力: undefined

実際の挙動 — 期待した結果と食い違っている箇所

見つけ方

エラーが出ないので、出力を目で確かめるか、コードを目で追うしかありません。この種の誤りが最も発見が遅れます

このエラーが出る典型パターン

 1  function addItem(cart, item) {
 2    return cart.push  (item);
                     ^
 3  }
 4  const cart = [];
 5  const updatedCart = addItem(cart, "apple");
 6  console.log(updatedCart.length);

 1  function addTag(tags, tag) {
 2    return tags.push  (tag);
                     ^
 3  }
 4  const tags = [];
 5  const updated = addTag(tags, "news");
 6  console.log(updated.length);

 1  function addUser(users, user) {
 2    return users.push  (user);
                      ^
 3  }
 4  const users = [];
 5  const updated = addUser(users, "Al");
 6  console.log(updated.length);

よくある誤解

「配列に追加するメソッドは更新後の配列を返すはず」という思い込みは、pushには当てはまりません。配列そのものを返してほしい場合はconcat()のような非破壊的なメソッドを使います。

まとめ

push()の戻り値は追加後の配列ではなく新しい要素数は初級でつまずきやすい項目です。上の3パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• 関数がreturn文を書き忘れてundefinedを返してしまう計算結果を変数に入れても、return文で明示的に返さない限り、関数はundefinedを返します。
• length はメソッドでなくプロパティという原因配列や文字列の要素数はlengthというプロパティで取得します。