本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Object.keys() / values() / entries()

オブジェクトのキー・値・組を配列で取り出します。継承したものや列挙できないものは入りません。数字に見えるキーが先に来る理由、配列に戻す方法まで実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

オブジェクトの中身を配列として取り出します。 オブジェクトには map() も filter() も無いので、まず配列にします。

example.js

const scores = { math: 80, english: 95 };

console.log(Object.keys(scores));
console.log(Object.values(scores));
console.log(Object.entries(scores));
固定例の期待出力 · Node 24.22.3
[ 'math', 'english' ]
[ 80, 95 ]
[ [ 'math', 80 ], [ 'english', 95 ] ]
表示用コードUTF-8 · LF

上のコードは書き換えて実行できます。項目を1つ足してみてください。

使い分け

返るもの 使う場面
Object.keys() キーの配列 名前だけ要る。件数を数える
Object.values() 値の配列 合計・最大など、値だけ要る
Object.entries() [キー, 値] の配列 両方要る(いちばん多い)
example.js

const scores = { math: 80, english: 95, science: 70 };

console.log(Object.keys(scores).length);
console.log(Object.values(scores).reduce((sum, n) => sum + n, 0));

for (const [name, score] of Object.entries(scores)) {
  console.log(`${name}: ${score}`);
}
固定例の期待出力 · Node 24.22.3
3
245
math: 80
english: 95
science: 70
表示用コードUTF-8 · LF

entries() は [キー, 値] の配列を返すので、分割代入で受け取ると読めます。

入らないもの

Object.keys() が返すのは、そのオブジェクト自身が持つ、 列挙できる、文字列のキーだけです。3つとも条件です。

受け継いだものは入らない

example.js

const parent = { p: 1 };
const child = Object.create(parent);
child.c = 2;

console.log(Object.keys(child));
console.log('p' in child);
console.log(child.p);
固定例の期待出力 · Node 24.22.3
[ 'c' ]
true
1
表示用コードUTF-8 · LF

child.p は読めるのに、Object.keys() には入りません。 「読めるかどうか」と「自身が持っているか」は別です。

for...in は受け継いだものも回します。だから配列にも使ってはいけません。

列挙できないものは入らない

example.js

const obj = Object.defineProperty({ a: 1 }, 'b', { value: 2, enumerable: false });

console.log(Object.keys(obj));
console.log(obj.b);
console.log(Object.getOwnPropertyNames(obj));
固定例の期待出力 · Node 24.22.3
[ 'a' ]
2
[ 'a', 'b' ]
表示用コードUTF-8 · LF

隠したいときは enumerable: false、全部見たいときは getOwnPropertyNames() です。

Symbol のキーは入らない

example.js

const s = Symbol('id');
const obj = { a: 1, [s]: 2 };

console.log(Object.keys(obj));
console.log(Object.getOwnPropertySymbols(obj).length);
console.log(obj[s]);
固定例の期待出力 · Node 24.22.3
[ 'a' ]
1
2
表示用コードUTF-8 · LF

Symbol は「うっかり列挙されない」ための道具でもあります。

順序

数字に見えるキーが先に、小さい順で並びます。そのあとが書いた順です。

example.js

const obj = { b: 1, 2: 2, a: 3, 1: 4 };

console.log(Object.keys(obj));
固定例の期待出力 · Node 24.22.3
[ '1', '2', 'b', 'a' ]
表示用コードUTF-8 · LF

b より先に 1 と 2 が来ています。書いた順にはなりません。

順序に依存する処理を書かないでください。 順番が要るなら Map か配列を使います。

example.js

const m = new Map([['b', 1], [2, 2], ['a', 3]]);

console.log([...m.keys()]);
固定例の期待出力 · Node 24.22.3
[ 'b', 2, 'a' ]
表示用コードUTF-8 · LF

Map は入れた順を保ちます。キーに数値も使えます。

配列や文字列に使うと

添字が文字列で返ります。 配列に使う理由はほぼありません。

example.js

console.log(Object.keys([10, 20]));
console.log(Object.keys('abc'));
console.log([...[10, 20].keys()]);
console.log([...[10, 20].entries()]);
固定例の期待出力 · Node 24.22.3
[ '0', '1' ]
[ '0', '1', '2' ]
[ 0, 1 ]
[ [ 0, 10 ], [ 1, 20 ] ]
表示用コードUTF-8 · LF

配列の添字が欲しいなら array.keys()(数値で返る)か entries() を使ってください。

配列からオブジェクトに戻す

Object.fromEntries() が entries() の逆です。

example.js

console.log(Object.fromEntries([['a', 1], ['b', 2]]));
console.log(Object.fromEntries(new Map([['a', 1]])));
固定例の期待出力 · Node 24.22.3
{ a: 1, b: 2 }
{ a: 1 }
表示用コードUTF-8 · LF

**「配列にして、加工して、戻す」**が定型です。

example.js

const scores = { math: 80, english: 95, science: 70 };

const passed = Object.fromEntries(
  Object.entries(scores).filter(([, score]) => score >= 80),
);

const doubled = Object.fromEntries(
  Object.entries(scores).map(([name, score]) => [name, score * 2]),
);

console.log(passed);
console.log(doubled);
固定例の期待出力 · Node 24.22.3
{ math: 80, english: 95 }
{ math: 160, english: 190, science: 140 }
表示用コードUTF-8 · LF

オブジェクトに filter() や map() は無いので、この形で代わりにします。

分割代入で先頭を空けておくのは「1つ目は使わない」という書き方です。読み飛ばす意図が伝わります。

null や undefined を渡すと落ちる

javascript失敗・注意の例

console.log(Object.keys(null));
固定例の期待出力 · Node 24.22.3
TypeError: Cannot convert undefined or null to object
表示用コードUTF-8 · LF

通信の結果をそのまま渡すと、ここで落ちます。

example.js

const data = null;

console.log(Object.keys(data ?? {}));
console.log(Object.keys(data ?? {}).length === 0);
固定例の期待出力 · Node 24.22.3
[]
true
表示用コードUTF-8 · LF

?? {} を挟むだけで防げます。

結合と複製の話は オブジェクトを結合する にまとめてあります。

鍵に文字列以外を使いたくなったら、オブジェクトではなく Map の出番です。数値の 1 と文字列の '1' を別の鍵として持てます。 → Map と Set

出典

この教材の原文(Markdown・別タブ)