HTMLAllCollection

インスタンスプロパティ

HTMLAllCollection.length 読取専用

集合内のアイテムの数を返します。

インスタンスメソッド

HTMLAllCollection.item()

コレクション内の指定したオフセットに位置する要素、または id 属性または name 属性に指定した値を持つ要素を返します。要素が見つからない場合は null を返します。

HTMLAllCollection.namedItem()

指定された文字列名と id または name 属性が一致する、集合内の最初の要素、または一致する要素がない場合は null を返します。

JavaScript での使用法

インデックスでのアクセス

上記のメソッドに加えて、HTMLAllCollection の要素には整数のインデックスや 文字列のプロパティ名でアクセスすることができます。HTML の id 属性は : や . を有効な文字として格納することができるので、プロパティへのアクセスにブラケット記法を使用する必要があります。ここで i は整数、整数を格納する文字列、または id を表す文字列です。

関数として呼び出す

HTMLAllCollection オブジェクトは呼び出し可能です。引数なし、または undefined で呼び出された場合は null を返します。それ以外の場合は、同じ引数を指定された item() メソッドと同じ値を返します。

特殊な型変換の挙動

歴史的な理由から、document.all は以下のように undefined のように振る舞うオブジェクトです。

• undefined と null は緩い等価です。
• 論理値コンテキストでは偽値です。
• typeof は "undefined" です。

これらの特別な動作によって、次のようなコードを保証します。

if (document.all) {
  // おそらく IE。特別なロジックを提供
}
// おそらく現在のブラウザー

互換性のために document.all を実装しているブラウザーでコードを実行しても、現行のブラウザー動作を提供し続けます。

しかし、他のすべてのコンテキストでは document.all はオブジェクトのままです。例えば次の通りです。

• これは undefined や null と厳密等価ではありません。
• ヌル値合体演算子 (??) やオプショナルチェーン演算子 (?.) の左辺に使用しても、式が短絡することはありません。

仕様書

ブラウザーの互換性

関連情報

• HTMLCollection