JavaScriptでオブジェクトの長さ（プロパティ数）を取得する方法

JavaScriptにおいて、オブジェクトには配列のような length プロパティが標準で用意されていません。そのため、オブジェクトの「長さ」、つまり保持しているプロパティの数を知りたい場合は、ひと工夫が必要です。

ここでは、次のような Student オブジェクトを例に説明していきます。

var studentObject = new Object();
studentObject["studentFirstName"] = "John";
studentObject["studentLastName"] = "Doe";
studentObject["studentAge"] = 22;
studentObject["studentCountryName"] = "US";
studentObject["studentCollegeName"] = "MIT";
studentObject["studentSubjectName"] = "JavaScript";

このオブジェクトの長さを求めてみましょう。

オブジェクトの長さを求める基本的な考え方

オブジェクトに含まれるキー（プロパティ名）を順番に調べ、キーが存在するたびにカウンター変数を1ずつ増やします。そして、for ループが完了した時点でカウンターの値を返せば、それがオブジェクトの長さとなります。

ポイントは、hasOwnProperty() メソッドを組み合わせることです。for...in ループはプロトタイプチェーン上のプロパティまで列挙してしまう可能性があるため、このメソッドで「そのオブジェクト自身が持つプロパティ」だけをカウント対象にすることで、正確な数を取得できます。

コード例

var studentObject = new Object();
studentObject["studentFirstName"] = "John";
studentObject["studentLastName"] = "Doe";
studentObject["studentAge"] = 22;
studentObject["studentCountryName"] = "US";
studentObject["studentCollegeName"] = "MIT";
studentObject["studentSubjectName"] = "JavaScript";
Object.findLength = function (stObject) {
    var counter = 0, k;
    for (k in stObject) {
        if (stObject.hasOwnProperty(k))
            counter++;
    }
    return counter;
};
var lengthOfStudentObject = Object.findLength(studentObject);
console.log("The length Student Object is=" + lengthOfStudentObject);

上記のプログラムを実行するには、次のコマンドを使用します。

node fileName.js.

ここでは、ファイル名を demo191.js としています。

実行結果

このプログラムを実行すると、次のような出力が得られます。

PS C:\Users\Amit\javascript-code> node demo191.js
The length Student Object is=6

6つのプロパティが正しくカウントされ、オブジェクトの長さとして「6」が出力されていることがわかります。

補足：Object.keys() を使うよりシンプルな方法

ES5以降の環境では、Object.keys() メソッドを使うことで、さらに簡潔にプロパティ数を取得できます。

var length = Object.keys(studentObject).length;
console.log(length); // 6

Object.keys() は、オブジェクト自身が持つ列挙可能なプロパティ名を配列として返します。その配列の length プロパティを参照するだけでプロパティ数がわかるため、可読性の面でもこちらの方法が推奨されます。独自の関数を定義する手間も不要になり、モダンなJavaScript開発では一般的にこちらが使われています。