HOWTO · JavaScript

JSON オブジェクトを JavaScript 配列に変換する

この記事では、JSON オブジェクトを JavaScript 配列に変換する方法について学習します

このページの内容

JSONはテキスト形式です。データがJSONテキストなら、プロパティを選択したり配列を作成したりする前に JSON.parse() で解析し、JavaScriptの値に変換します。すでにJavaScriptオブジェクトがある場合は解析を省き、キーと値のペア、値だけ、または独自に選択した要素など、必要な形の配列を選びます。これらの操作はプロパティから配列を作るもので、あらゆるオブジェクトを自動的に配列へ変換するわけではありません。

JavaScriptの配列は、インデックス付きの要素を持つオブジェクトです。配列の位置は0から始まりますが、オブジェクトの列挙メソッドが返すプロパティ名は文字列です。たとえば、数値のように見えるキーを持つオブジェクトでも、エントリーでは文字列のキーが返されます。

JSONテキストをJavaScriptオブジェクトに変換する

有効なJSON文字列を JSON.parse() に渡します。テキストの内容に応じて、結果はオブジェクト、配列、または別のJSON値になります。この例ではオブジェクトを解析し、そのフィールドからエントリーの配列を作ります。

次の例を実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

const jsonText = '{"name":"Ada","role":"engineer"}';
const person = JSON.parse(jsonText);
const entries = Object.entries(person);
console.log(entries);
[ [ 'name', 'Ada' ], [ 'role', 'engineer' ] ]

入力が不正なJSONの場合、解析時に SyntaxError がスローされます。アプリケーションにデータが入る時点で検証するか、エラーを処理してください。すでにオブジェクトである値に JSON.parse() を呼び出さないでください。詳しくは JSON.parse() のリファレンスを参照してください。

オブジェクトを Object.entries() でキーと値のペアに変換する

各要素にプロパティ名と値の両方を含める場合は、Object.entries(object) を使います。これは [key, value] のような2要素の配列からなる配列を返します。対象は、オブジェクト自身が持つ列挙可能な文字列キーのプロパティです。継承したプロパティやシンボルキーのプロパティは含まれません。数値のように見えるプロパティ名も、返されるペアでは文字列です。

後続の処理でラベルと値を一緒に表示したり、各ペアを変換したりするなど、両方が必要な場合に便利です。エントリー配列については、JavaScript array entriesも参照してください。

オブジェクトを Object.values() で値の配列に変換する

キーが不要な場合は Object.values(object) を使います。オブジェクト自身が持つ列挙可能な文字列キーのプロパティの値を、Object.entries() と同じプロパティ順で返します。結果は [key, value] のペアの配列ではなく、値だけの一次元配列です。値だけを処理または表示する場合に選びます。値とキーの対応関係を保つ必要がある場合は Object.entries() を使います。

たとえば、name と role プロパティを持つオブジェクトなら、Object.values(object) は名前と役割の値を含む配列を返します。ここでは操作の説明をしており、実行結果を観測したとは述べていません。詳しくは Object.values() のリファレンスを参照してください。

独自の反復処理に for...in を使う

for...in ループは、プロトタイプチェーンを通じて継承したものも含め、列挙可能な文字列キーのプロパティを反復処理します。反復中に独自の処理が必要な場合に使います。オブジェクト自身のプロパティだけを結果に含めるには、各要素を追加する前に Object.hasOwn() で確認します。このガードにより、継承した列挙可能なプロパティが追加されるのを防げます。

このセクションのコードと表示されるラベルや出力は英語のままです。

const object = { name: 'Ada', role: 'engineer' };
const entries = [];

for (const key in object) {
  if (Object.hasOwn(object, key)) {
    entries.push([key, object[key]]);
  }
}

console.log(entries);
[ [ 'name', 'Ada' ], [ 'role', 'engineer' ] ]

このループは、ガードで確認した自分自身のプロパティについて、Object.entries() と同じ種類のペアを作りながら、処理中に要素を絞り込んだり変換したりできます。ガードがなければ、継承した列挙可能なプロパティも追加されることがあります。通常のペア変換には、意図が明確で短い Object.entries() が適しています。反復の動作については for...in のリファレンスを参照してください。

必要な配列の形を選ぶ

まず入力の種類を確認します。JSONテキストは JSON.parse() で解析し、すでにあるオブジェクトはそのまま使います。次に結果を選びます。ペアには Object.entries()、値だけなら Object.values()、反復中に独自の絞り込みや変換を行うなら、所有プロパティを確認するガードとともに for...in を使います。組み込みの2つのメソッドは、どちらもオブジェクト自身が持つ列挙可能な文字列キーのプロパティを選びます。ガードのない for...in は、継承した列挙可能な文字列キーのプロパティも対象にします。これらのメソッドはいずれもシンボルキーのプロパティを含みません。この違いを理解しておけば、意図しない要素の追加を防ぎ、後続の処理が必要とするデータに合った配列を作れます。