JavaScript / コードを試す
Object.keys() / values() / entries()
オブジェクトのキー・値・組を配列で取り出します。継承したものや列挙できないものは入りません。数字に見えるキーが先に来る理由、配列に戻す方法まで実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
オブジェクトの中身を配列として取り出します。
オブジェクトには map() も filter() も無いので、まず配列にします。
const scores = { math: 80, english: 95 }; console.log(Object.keys(scores)); console.log(Object.values(scores)); console.log(Object.entries(scores));
[ 'math', 'english' ] [ 80, 95 ] [ [ 'math', 80 ], [ 'english', 95 ] ]
上のコードは書き換えて実行できます。項目を1つ足してみてください。
使い分け
| 返るもの | 使う場面 | |
|---|---|---|
Object.keys() |
キーの配列 | 名前だけ要る。件数を数える |
Object.values() |
値の配列 | 合計・最大など、値だけ要る |
Object.entries() |
[キー, 値] の配列 |
両方要る(いちばん多い) |
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}`); }
3 245 math: 80 english: 95 science: 70
entries() は [キー, 値] の配列を返すので、分割代入で受け取ると読めます。
入らないもの
Object.keys() が返すのは、そのオブジェクト自身が持つ、
列挙できる、文字列のキーだけです。3つとも条件です。
受け継いだものは入らない
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);
[ 'c' ] true 1
child.p は読めるのに、Object.keys() には入りません。
「読めるかどうか」と「自身が持っているか」は別です。
for...in は受け継いだものも回します。だから配列にも使ってはいけません。
列挙できないものは入らない
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));
[ 'a' ] 2 [ 'a', 'b' ]
隠したいときは enumerable: false、全部見たいときは getOwnPropertyNames() です。
Symbol のキーは入らない
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]);
[ 'a' ] 1 2
Symbol は「うっかり列挙されない」ための道具でもあります。
順序
数字に見えるキーが先に、小さい順で並びます。そのあとが書いた順です。
const obj = { b: 1, 2: 2, a: 3, 1: 4 }; console.log(Object.keys(obj));
[ '1', '2', 'b', 'a' ]
b より先に 1 と 2 が来ています。書いた順にはなりません。
順序に依存する処理を書かないでください。 順番が要るなら Map か配列を使います。
const m = new Map([['b', 1], [2, 2], ['a', 3]]); console.log([...m.keys()]);
[ 'b', 2, 'a' ]
Map は入れた順を保ちます。キーに数値も使えます。
配列や文字列に使うと
添字が文字列で返ります。 配列に使う理由はほぼありません。
console.log(Object.keys([10, 20])); console.log(Object.keys('abc')); console.log([...[10, 20].keys()]); console.log([...[10, 20].entries()]);
[ '0', '1' ] [ '0', '1', '2' ] [ 0, 1 ] [ [ 0, 10 ], [ 1, 20 ] ]
配列の添字が欲しいなら array.keys()(数値で返る)か entries() を使ってください。
配列からオブジェクトに戻す
Object.fromEntries() が entries() の逆です。
console.log(Object.fromEntries([['a', 1], ['b', 2]])); console.log(Object.fromEntries(new Map([['a', 1]])));
{ a: 1, b: 2 }
{ a: 1 }**「配列にして、加工して、戻す」**が定型です。
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);
{ math: 80, english: 95 }
{ math: 160, english: 190, science: 140 }オブジェクトに filter() や map() は無いので、この形で代わりにします。
分割代入で先頭を空けておくのは「1つ目は使わない」という書き方です。読み飛ばす意図が伝わります。
null や undefined を渡すと落ちる
console.log(Object.keys(null));TypeError: Cannot convert undefined or null to object
通信の結果をそのまま渡すと、ここで落ちます。
const data = null; console.log(Object.keys(data ?? {})); console.log(Object.keys(data ?? {}).length === 0);
[] true
?? {} を挟むだけで防げます。
結合と複製の話は オブジェクトを結合する にまとめてあります。
鍵に文字列以外を使いたくなったら、オブジェクトではなく Map の出番です。数値の 1 と文字列の '1' を別の鍵として持てます。
→ Map と Set