document.all (DOM)

[15] document.all は、文書中のすべての要素を含むコレクションです。このオブジェクトは IE4 DOM の一部であり、現在では廃止状態とされています >>14 が、 Webブラウザーが実装しなければならない >>14 機能の一つとされており、すべての Webブラウザーが対応しています。

仕様書

`Document` オブジェクト `all` 属性 (DOM)

[16] Document インターフェイスの all 属性は、 HTMLAllCollection オブジェクトを返す読み取り専用のIDL属性です。このオブジェクトは当該 Document を根とし、すべての要素に一致するフィルターを持つものでなければなりません。 >>14

[37] この属性は、毎回同じオブジェクトを返します (SameObject)。つまり文書にはちょうど1つだけ all オブジェクトが存在します。

`HTMLAllCollection` インターフェイス (DOM)

[23] HTMLAllCollection オブジェクトは、 document.all IDL属性で用いられるコレクションです。

[58] HTML Standard は HTMLAllCollection がコレクションだと (なぜか) 明記はしていませんが、 HTMLCollection と似ている >>13 とし、コレクションの用語を使って規定されています。

[27] HTMLAllCollection インターフェイスは文書環境で JavaScriptに晒されています >>13。

[38] このオブジェクトは生きており、DOM木に対する変更が即時反映されます。

[45] かつては HTMLCollection を継承していましたが、現在は独立しています >>44。

メンバー

[24] HTMLAllCollection には、継承するものも含めて次のメンバーがあります。

[57] length IDL特性以外は、すべて、索引や名前で要素を取得するものです。つまり、次のような方法で要素にアクセスできます。

JavaScript 束縛

[94] HTMLAllCollection インターフェイスを実装するオブジェクトは、 legacy platform object です HTML Standard。

[59] HTMLAllCollection オブジェクトには、 JavaScript にて他のプラットフォームオブジェクトとは異なる特別な取り扱いが規定されています。すなわち、 HTMLAllCollection オブジェクトは、 IsHTMLDDA 内部スロットを持ちます HTML Standard。

[17] document.all オブジェクトに JavaScript ToBoolean() 演算を適用すると、偽を返さなければなりません。 >>14

[18] document.all オブジェクトに JavaScript の抽象等値性比較 (== や != の演算子) を適用すると、undefined や null と同じように振る舞わなければなりません。 >>14

[19] === や !== に関しては、普通のオブジェクトと同じように振る舞います。

[20] document.all オブジェクトに JavaScript の typeof 演算子を適用すると、文字列 undefined を返さなければなりません。 >>14

[21] これらの要件は、通常のオブジェクトの動作とは異なりますが、歴史的経緯のために必要 >>14 とされています。

[22] かつて document.all は IE のみが実装していたため、 IE であるかどうかの判別に用いられることがありました。すなわち、

if (document.all) {
  // for IE
} else {
  // for non-IE
}

... で IE 以外の近代的ブラウザーは後者が実行される必要がありました。一方で、 IE のみに対応していて document.all が実装されていなければ動作しない Webサイトも存在していました。この両方のパターンに対応するため、 document.all オブジェクトは条件式においては undefined と同じように動作する実装がなされました。現在では IE も近代的ブラウザーと HTML Standard に従っています。

索引による要素へのアクセス

[61] HTMLAllCollection の supported property indices は、 HTMLCollection の場合と同じです >>13。つまり、 [ 0, 当該コレクションにより表現される要素の数 - 1 ] の範囲の整数です >>60。

[62] 従って、 n を 0 以上、文書中の要素数 - 1 の整数とするとき、 document.all [ n ] が存在し、それ以外の整数 n については存在しません。

[78] HTMLAllCollection の indexed getter は、次のようにしなければなりません >>13。

[79] get the "all"-indexed element を実行した結果を返します。ただしコレクションは文脈オブジェクト、 索引は与えられた索引とします。

[67] HTMLAllCollection コレクションと索引索引について get the "all"-indexed element とは、次のようにすることです >>13。

[68] コレクションに含まれる要素で索引番目のものがあれば、
1. [69] コレクションに含まれる要素で索引番目のものを返します。
[70] それ以外なら、
1. [71] null を返します。

[66] HTMLAllCollection インターフェイスの length IDL属性は、取得時、文脈オブジェクトであるコレクションにより表現される要素の数を返さなければなりません >>13。

名前による要素へのアクセス

[35] HTMLAllCollection の supported property names は、コレクションにより表現される要素の名前 (あれば) のリストです >>13。

[65] 従って、 s を要素の名前とするとき、 document.all [ s ] が存在します。

[33] HTMLAllCollection における要素の名前とは、 name 属性値と ID のことをいいます。

[34] ただし name 属性が用いられるのは「all」名前付き要素 ("all"-named elements) に限られます。「all」名前付き要素とは、 HTML の

... です >>13。

[40] このリストはブラウザーによって相違がありますが、 HTML Standard は広めにとっているようです。コメントに「keygen?」ともあります >>39。

[36] ただし空文字列は名前とはみなされません。

[63] 順序は木順で、重複する場合は最初の方が採用されます >>13。

[64] id と name の両方がある要素があれば、 id が先に現れたと考えます >>13。

[29] HTMLAllCollection の namedItem メソッドと named getter は、次のようにしなければなりません >>13。

[80] 名前を、第1引数を文字列として解釈した結果に設定します。
[30] 名前について get the "all"-named element(s) を実行した結果を返します。 コレクションは、文脈オブジェクトとします。

[72] HTMLAllCollection コレクションと名前名前について get the "all"-named element(s) とは、次のようにすることです >>13。

[73] 名前が空文字列なら、 null を返してここで停止します。
[74] 部分コレクションを、新しい HTMLCollection に設定します。
根
コレクションの根 (文書)
フィルター
当該節点が "all"-named elements で name 属性が名前と等しいか、要素で ID が名前と等しいなら、真
[75] 部分コレクションに含まれる節点の数により、
[81] 0個の場合
null を返します。
[76] 1個の場合
部分コレクションに含まれる要素を返します。
[77] それ以外の場合
部分コレクションを返します。

[31] つまり、同じ名前の要素の個数により、要素が返されたり、 HTMLCollection が返されたりします。 (ここで HTMLAllCollection ではなく HTMLCollection であることにも注意。)

[32] なお、同じ条件の HTMLCollection を返すことになっても、毎回同じオブジェクトを返すことは求められていないようです。

`item` メソッドと legacycaller

[25] HTMLAllCollection の item メソッドは、次のようにしなければなりません >>13。

[26] 名前を、第1引数を省略可能な文字列と解釈した結果に設定します。
[97] 名前が省略されている場合、
1. [98] null を返します。
[99] それ以外の場合、
1. [95] 文脈オブジェクトと名前について get the "all"-indexed or named element(s) した結果を返します。

[83] HTMLAllCollection オブジェクトの Call は、this、引数リストについて、次のようにします >>13。

[100] 引数リストのサイズが 0 か、 引数リスト [ 0 ]] が undefined の場合、
1. [101] null を返します。
[105] それ以外の場合、
1. [102] 名前を、 引数リスト [ 0 ] を DOMString に変換した結果に設定します。
2. [103] 結果を、文脈オブジェクトと名前について get the "all"-indexed or named element(s) した結果に設定します。
3. [104] 結果を JavaScript値に変換した結果を返します。

[106] 文脈オブジェクトの結果が返され、 this は無視されます。

[96] HTMLAllCollection コレクションと名前について get the "all"-indexed or named element(s) するには、次のようにします >>13。

[86] 名前が配列索引特性名の場合、
1. [84] 索引を、名前に ToUint32 を適用した結果に設定します。
2. [85] コレクションと索引について get the "all"-indexed element を実行した結果を返します。
[87] それ以外の場合、
1. [82] コレクションと名前について get the "all"-named element(s) を実行した結果を返します。

[88] つまり item メソッドは引数によって indexed getter のように動作したり、 named getter のように動作したりします。

歴史

IE4

[49] document.all は IE4 DOM で追加されました。 Netscape DOM0 の document.links や document.forms などに対して、すべての種別の要素、という意味で「all」と命名されたものと思われます。

[51] その後標準化された DOM1 は document.all を含んでいませんでした。名前によって要素にアクセスする機能は、 getElementByName と getElementById という (Java の洗礼を受けたのか) 異様に長い名前のメソッドになりました。

00年代

[52] document.all は IE しか実装しませんでしたが、短く使いやすかったので、少なくない Webページがこれを使っていました。

[53] W3C はずっとこの現実を無視していましたが、 Webブラウザーは現実の Webサイトとの互換性の要求から、非標準でありながらも document.all を実装せざるを得なくなりました。

[54] Firefox は標準モードではこれを実装しないことで最後まで抵抗を続けましたが、奇癖モードでは実装せざるを得ませんでした。

[55] 一方で、IE のみが実装していた時代に、 document.all の有無で IE とそれ以外のWebブラウザーを分岐する悪習が広まっていました。 document.all を実装しなければならないが、 if (document.all) { ... } を実行してはならない、という難題でありましたが、 document.all オブジェクトは比較時に偽と評価される、との特例で解決されることとなりました。

[56] このような動作は本来 JavaScript では認められておらず、 document.all の他はかつて styleFloat メソッドで行われたくらいです。

[1] DOMNodeInserted と DOMNodeRemoved に似た仕組みを IE でも使えるようにして、セレクタの実行結果をキャッシュする - uupaaの開発日記 (2008-12-27 13:51:49 +09:00 版) http://d.hatena.ne.jp/uupaa/20081127/1227726901

DOMNodeInserted, DOMNodeRemoved
document.all.length でノード数を調べることで検出します。事前に作成されているコレクションを参照するため、かなり高速です。
このやり方では、挿入, 削除されたタイミングを動的に知ることはできません。
Firefoxの標準準拠モード以外なら、ほぼ全てのモダンブラウザで使えます。

[2] DSiブラウザで document.all は真になります・・・。