【JavaScript】Object.keys()の順序に注意が必要という話

JavaScriptでオブジェクトのキー配列取得したい…

そういう時は Object.keys() を使うのが鉄板です。

でもある時こんな疑問が浮かびました。

  • 返ってくるキーの順序は?
  • 定義した順番に返ってくるのか
  • それとも別の規則性がある?

キー配列の順序が気になったので、
Object.keys() のキー順序について調べました。

Object.keys()の基本的な概要・使い方

これは調べればいくらでも出てきます。

一番確実なのはMDNリファレンスを見ることですね。

▼ MDNにおけるObject.keys()の概要

Object.keys() メソッドは、指定されたオブジェクトが持つプロパティの 名前の配列を、通常のループで取得するのと同じ順序で返します。

引用元 : https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Object/keys

▼ 基本的な使い方コード例

このようなオブジェクトのキー配列を返すメソッド

使い方の注意点としてはオブジェクトに対して直接呼び出せないため、 Object.keys()  に直接オブジェクトを渡すような使い方をします。

そして解説で気になるのが次の箇所。

「通常のループで取得するのと同じ順序で」

ここが少し分からない所でした。

Object.keys()は配列に対しても使える

そしてこの Object.keys()  の面白い性質?について。

それは配列に対しても使えるってことです。

▼ このようなコードで考えてみる

インデックス番号の配列が返ってきました。

つまりJavaScript内部では ['red', 'green', 'blue']  というのは {0:'red', 1:'green', 2:'blue'}  というオブジェクトと等価(?)になってます。

これが Object.keys()  のキー順序に影響を与えます。

数字キーを含むオブジェクトは順序通りではない

ということで Object.keys()  の順序について。

基本的には定義した順序でキー配列が返ってきます。

でも前述したように数字キーの場合は例外です。

▼ 例えばこんなオブジェクトで試してみる

▼ 上記コードの出力結果

こういう感じでキーの順序は保持されてません。

というより配列として解釈された感じです。

だから数字に解釈されるキーを含む場合…

  • キー配列は定義した順序にならない
  • 数字キーは昇順で並び替えされる

こういう性質があることに要注意です。

文字列キーの場合は順序は保持される

一方の普通の文字列キーなら順序はキープされます。

▼ このようなコードを試してみる

▼ 上記コードの出力結果

文字列キーはそのまんまの順序が保持されます。

昇順で並び替えなんてされません、期待通りの動作。

だから文字列キーだけを含むオブジェクトなら、
返ってくるキー配列の順序は心配しなくていいってこと。

数字キーと文字列キーを両方含む時の順序は…?

数字キーと文字列キーの両方を含むオブジェクト

その場合どうなるかは気になるところです。

▼ だからこんなコードで確かめてみた

▼ 上記コードの出力結果

このような結果になりました。

もし Object.keys()  が常に順序通りと思ってるなら…

意図しない結果を引き起こすかもしれません。

返ってくるキーの順序はこうなる

結論としてはこうなります。

  • 数字キーが順序的には優先される
  • 数字キーは昇順として並び替えられる
  • 文字列キーは順序的に数字キーの後
  • 文字列キー同士の並びは影響されない

この挙動を知らないと、思わぬミスを引き起こします。

以上、 Object.keys()  の順序に注意が必要って話でした。

もしおかしな点があればご指摘ください。ではまた