`for...in` 是 JavaScript 遍歷**物件可列舉屬性** (含繼承) 的標準迴圈。本文詳細說明語法、適用對象、原型鏈遍歷行為、陣列使用陷阱、現代替代方案,幫你正確選擇遍歷工具。
for (var key in object) {
// key: 屬性名稱 (字串)
// object[key]: 屬性值
}
function Student(name, age) {
this.name = name;
this.age = age;
}
Student.prototype.school = "台大"; // 原型屬性
var stu = new Student("內馬爾", 20);
for (var prop in stu) {
console.log(prop + ": " + stu[prop]);
}
// 輸出順序不保證:
// name: 內馬爾
// age: 20
// school: 台大 ← 繼承自原型也會被遍歷!
var arr = [1, 3, 5, 7, 9];
for (var i in arr) {
console.log(i + ": " + arr[i]);
}
// 輸出:
// "0: 1"
// "1: 3"
// "2: 5"
// "3: 7"
// "4: 9"
// 注意:i 是字串 "0", "1"...
// 且可能包含繼承/自訂屬性!
| 特性 | for...in | 備註 |
|---|---|---|
| 遍歷目標 | 物件所有**可列舉**屬性 (含繼承) | 不可列舉屬性 (如 Array.length) 不會出現 |
| 鍵類型 | 永遠是**字串** | 陣列索引也是字串 "0", "1"... |
| 順序保證 | **無順序保證** (現代引擎大致按建立順序,但不可依賴) | ES2015+ 規範:整數索引升序、其它建立順序 |
| 原型鏈 | **會遍歷繼承屬性** | 需配合 hasOwnProperty 過濾 |
| 適用對象 | ✅ 普通物件 ❌ 陣列 (有更好選項) | 陣列請用 for...of / forEach / for 迴圈 |
var arr = ['a', 'b', 'c'];
arr.customProp = 'custom'; // 陣列也是物件,可加屬性
Array.prototype.extra = 'fromProto'; // 原型污染
for (var i in arr) {
console.log(i, arr[i]);
}
// 可能輸出 (順序不定):
// "0" "a"
// "1" "b"
// "2" "c"
// "customProp" "custom"
// "extra" "fromProto" ← 災難!
var obj = {a:1, b:2, c:3};
for (var k in obj) {
if (k === 'b') delete obj[k];
console.log(k);
}
// 輸出可能:a, b, c (b 被刪除後仍可能遍歷到 c 或跳過)
// 行為跨瀏覽器不一致
for (var key in obj) {
if (Object.prototype.hasOwnProperty.call(obj, key)) {
// 僅處理自身屬性
console.log(key, obj[key]);
}
}
// 現代簡寫 (ES2022)
for (const key of Object.keys(obj)) { /* ... */ } // 僅自身可列舉
for (const key of Object.getOwnPropertyNames(obj)) { /* ... */ } // 包含不可列舉
for (const key of Reflect.ownKeys(obj)) { /* ... */ } // 包含 Symbol
| 需求 | 推薦方案 | 語法 |
|---|---|---|
| 遍歷物件自身可列舉屬性 | Object.keys() + forEach/for...of | `Object.keys(obj).forEach(k => ...)` |
| 遍歷物件所有自身屬性 (含不可列舉) | Object.getOwnPropertyNames() | `Object.getOwnPropertyNames(obj).forEach(...)` |
| 遍歷物件自身屬性 (含 Symbol) | Reflect.ownKeys() | `Reflect.ownKeys(obj).forEach(...)` |
| 遍歷陣列 (需索引) | for...of + entries() | `for (const [i, v] of arr.entries())` |
| 遍歷陣列 (只需值) | for...of / forEach | `for (const v of arr)` / `arr.forEach(v => ...)` |
| 需中斷/返回的陣列遍歷 | for...of | `for (const v of arr) { if (cond) break; }` |
| 映射/過濾/縮減 | map/filter/reduce | `arr.map(fn)`, `arr.filter(fn)` |
const obj = {a: 1, b: 2};
const arr = ['x', 'y', 'z'];
// for...in: 遍歷「鍵」 (物件屬性名 / 陣列索引字串)
for (const key in obj) console.log(key); // "a", "b"
for (const idx in arr) console.log(idx); // "0", "1", "2" (字串!)
// for...of: 遍歷「值」 (可迭代物件的迭代器)
for (const val of arr) console.log(val); // "x", "y", "z"
// for (const val of obj) // TypeError: obj is not iterable
// 物件要用 for...of 需配合 Object.entries/values/keys
for (const [k, v] of Object.entries(obj)) console.log(k, v);
const obj = {a:1,b:2,c:3,d:4,e:5};
const arr = [1,2,3,4,5];
// 物件遍歷
console.time('for...in'); for(let i=0;i<1e6;i++) for(let k in obj); console.timeEnd('for...in'); // ~120ms
console.time('Object.keys+forEach'); for(let i=0;i<1e6;i++) Object.keys(obj).forEach(k=>{}); console.timeEnd('Object.keys+forEach'); // ~80ms
// 陣列遍歷
console.time('for...in arr'); for(let i=0;i<1e6;i++) for(let k in arr); console.timeEnd('for...in arr'); // ~200ms
console.time('for...of'); for(let i=0;i<1e6;i++) for(let v of arr); console.timeEnd('for...of'); // ~40ms
console.time('forEach'); for(let i=0;i<1e6;i++) arr.forEach(v=>{}); console.timeEnd('forEach'); // ~35ms
console.time('for loop'); for(let i=0;i<1e6;i++) for(let j=0;j