for (variable in object)
statement
variable 通常是以 var 宣告的變數。在迴圈體內部,物件的每個「屬性名稱」會作為字串被指派給 variable——注意是屬性名稱,而不是屬性值。
有幾個屬性不會被 for-in 枚舉出來:被標記為唯讀、永久(不可刪除)或不可枚舉的屬性。所有使用者自訂的屬性原則上都可以枚舉,但許多內部屬性(包括所有內部方法)都是不可枚舉的。此外,物件可以繼承其他物件的屬性,那些被繼承而來的使用者自訂屬性也能被 for-in 枚舉——這一點在實務上是 bug 的常見來源。
一般的 for (var i = 0; i < len; i++) 情境,多半都能改用 for-in。例如:
var a = ["a", "b", "c"];
for (var el in a) {
alert(a[el]);
}
這段程式碼會逐一取出 a 的所有元素,當然也可以寫成傳統的索引迴圈:
for (var i = 0, len = a.length; i < len; i++) {
alert(a[i]);
}
但有些情況傳統寫法就不見得可行,例如:
var a = { "first": 1, "second": 2, "third": 3 };
for (var key in a) {
alert(key + " = " + a[key]);
}
這時就只能靠 for-in 來窮舉了。
要判斷某個屬性是否能被 for-in 看到,可以用 propertyIsEnumerable:
object.propertyIsEnumerable(propname)
propname 是一個字串,代表物件屬性的名稱。若 object 具有名為 propname 的非繼承屬性,且該屬性可枚舉,則回傳 true。
要特別理解的是:for-in 只能走訪「可枚舉」的屬性,而並非物件的所有屬性都可枚舉。透過 JavaScript 程式碼新增的屬性是可枚舉的,內部物件的預先定義屬性(如方法)通常不可枚舉。而 propertyIsEnumerable() 不會檢查原型鏈,因此它只適用於物件自身的屬性,無法判斷繼承屬性的可枚舉性。
var o = new Object();
o.x = 3.14;
o.propertyIsEnumerable("x"); // true
o.propertyIsEnumerable("y"); // false,沒有這個屬性
o.propertyIsEnumerable("toString"); // false,繼承而來
Object.prototype.propertyIsEnumerable("toString"); // false,不可枚舉
不要用 for-in 遍歷陣列。for-in 枚舉的是索引字串,而且順序在規範上並不保證;更麻煩的是,若有人為 Array.prototype 擴充了方法,那些擴充屬性也會被枚舉出來。遍歷陣列請一律使用 traditional for 迴圈,或 ES5 之後的 forEach、map、filter。
遍歷物件時,記得用 hasOwnProperty 過濾。這是最實用的一條防護:
for (var key in obj) {
if (!obj.hasOwnProperty(key)) continue;
// 只處理物件自身的屬性
}
现代寫法則可改用 Object.keys(obj)、Object.entries(obj),一次就取得自身可枚舉屬性,不必再手動過濾。