定義と使用方法

for...in文は、プロパティ（key）で反復処理できるオブジェクトのためのループ文です。
プロパティ（key）で反復処理できるオブジェクトであれば、どのようなオブジェクトでもfor...in文で処理することができます。つまり、オブジェクトから取り出したプロパティ（key）を基に動作するループを実行します。

プロパティ（key）で反復処理できるオブジェクトとは、列挙可能（enumerable）なプロパティ（key）を持つオブジェクトを指します。
代表的なものとして、一般的なオブジェクト（Plain objects）があります。

配列も列挙可能なプロパティ（key）を持っています。JavaScriptでは、配列のプロパティ名（key）はインデックス（整数）になります。

基本の例

次に、プロパティ（key）で反復処理できる一般的なオブジェクト（Plain object）をfor...in文で反復処理する例を示します。

for...in文を使用してオブジェクトのプロパティ（key）を反復処理する際、各反復ごとに変数には当該プロパティの名前が割り当てられます。これにより、プロパティ名を取得することができます。

JavaScript 
const person = {
    name: "John",
    age: 30,
    occupation: "Developer"
}; // オブジェクトリテラルで定義された一般的なオブジェクト（Plain object）

for (let key in person) {
    console.log(key); // プロパティ（key）の名前を出力
}
// 出力: "name" "age" "occupation"

構文

JavaScript 
for (variable in object) {
    // 実行するコード
}
  • variable：ループ内で現在反復処理中のプロパティ（key）を格納する変数の名前です。
  • object：ループで反復処理したいプロパティ名（key）で順に処理できるオブジェクトです。

特徴

for...in文はオブジェクトのプロパティ（key）を反復処理する機能を提供しますが、いくつかの重要な特徴を考慮する必要があります。以下では、for...in文の主な特徴について詳しく見ていきます。

オブジェクトのプロパティ（key）を反復処理

for...in文は、オブジェクトの列挙可能なプロパティ名（key）を反復処理します。そのため、ループごとに変数にはプロパティ名が文字列として代入されます。

プロパティ（key）を反復処理する順序は保証されません

プロパティ（key）を反復処理する順序は、エンジンの実装によって異なる場合があり、仕様上は保証されていません。ほとんどの場合は追加された順序に従いますが、常に一定であるとは仮定できません。

配列の反復処理には適していません

インデックスの順序が重要な配列を反復処理するために使用することは推奨されません。

配列には、一貫した順序で反復処理を行うfor文、for...of文、forEach()などのループを使用することが推奨されます。

注意してください！
for...in文は、symbolでキーが指定されたプロパティを無視します。

for...in文でオブジェクトの値（value）にアクセスする

for...in文はオブジェクトの列挙可能なプロパティ名（key）を反復処理するため、実際のプロパティの値（value）には直接アクセスしません。そのため、実際の値にアクセスするには、obj[key]の形式でアクセスする必要があります。

JavaScript 
const user = {
    name: "太郎",
    age: 30
};

for (let key in user) {
  console.log(key, ":", user[key]);  
}
/*
    出力:
    "name" : "太郎"
    "age" : 30
*/

有用性

for...in文の特徴を見てきたように、オブジェクトのプロパティ（key）を反復処理する機能を提供しますが、プロパティを反復処理する順序は保証されない点に注意する必要があります。つまり、配列の反復処理には適していません。

では、for...in文はどのような場合に使用するのが適しているでしょうか？

主に、for...in文はデータを操作するための反復処理というよりも、一般的なオブジェクト（Plain objects）の特定の値（value）を持つプロパティ（key）を確認するデバッグ用として使用されます。

仕様書

for...in文の仕様書
仕様書
for...in ECMAScript Language Specification
#sec-for-in-and-for-of-statements

ブラウザ互換性

for...in 文のブラウザ互換性
文
デスクトップ Chrome
Chrome
デスクトップデスクトップ Edge
Edge
デスクトップ Firefox
Firefox
Safari
Safari
for...in 1 12 1 1

参考資料

関連項目