document.all 是 IE 時代最常被寫進教學的 DOM 集合。它確實方便,但也藏著幾個足以讓程式莫名回傳 undefined 的陷阱。以下把用法與地雷一次講清楚。
一、它是頁面內所有元素的集合。document.all(0) 代表文件中的第一個元素,document.all.length 是元素總數。
二、可以用來判斷是否為 IE。非 IE 瀏覽器長年不支援這個屬性,因此 if (document.all) { alert("is IE!"); } 成為經典的瀏覽器嗅探寫法(但這 also 是 UA 判斷之外的一種「特性偵測」)。
三、可以用 name 或 id 直接取值。只要元素設了 id="bbb",就能寫成 document.all.bbb。
<input name="aaa" value="aaa">
<input id="bbb" value="bbb">
<script>
alert(document.all.aaa.value); // 依 name 取值
alert(document.all.bbb.value); // 依 id 取值
</script>
name 本來就允許重複(例如多選興趣的 checkbox 群組)。此時 document.all.aaa 會變成集合,必須用 (0)、(1) 取值:
<input name="aaa" value="a1">
<input name="aaa" value="a2">
<input id="bbb" value="bbb">
<script>
alert(document.all.aaa(0).value); // a1
alert(document.all.aaa(1).value); // a2
alert(document.all.bbb(0).value); // 失敗:bbb 不是集合
</script>
注意最後一行——id 理應唯一,所以它不是集合,加索引反而出錯。這就是「同一個名字,有時是物件、有時是集合」造成的混亂來源。
<input id="aaa" value="a1">
<input id="aaa" value="a2">
<script>
alert(document.all.aaa.value); // undefined
</script>
雖然規格上 id 應該唯一,但頁面很長、id 由後端程式動態產生,或是多人協作時,重名仍會發生。一旦重名,document.all.aaa.value 就變成 undefined,而且不會報錯,只會安靜地壞掉,非常難查。
<script>
alert(document.all("aaa", 0).value);
alert(document.all("aaa", 1).value);
alert(document.all("bbb", 0).value);
alert(document.all("ccc", 0).value);
</script>
把索引寫死,就不必去猜「這個名字到底是單一物件還是集合」,程式行為變得一致可預期。
現代專案請改用標準 API:document.getElementById("id") 取單一元素、document.getElementsByName("name") 或 document.querySelectorAll("[name='aaa']") 取群組、document.querySelector("#id .cls") 做選擇。這些方法的回傳型別固定,不會有上述的歧義;而 document.all 已在多數現代瀏覽器中被標記為 legacy,僅為相容性保留。