XMLDocument インターフェイス load メソッド (DOM)

[18] XMLDocument インターフェイスの load メソッドは、 fetch を行い、文書の内容を得られた XML文書によって置き換えられるものです。

仕様書

処理

[20] 必須の第1引数を USVString として解釈します。
[21] 入口設定群オブジェクトのAPI基底URLに対して最初の引数の URLの解決を行います。
[22] 解決に失敗したら、
1. [23] SyntaxError 例外を投げて停止します。
[24] 得られたURLが文脈オブジェクトと同じ起源でなければ、
1. [25] SecurityError 例外を投げて停止します。
[28] 文脈オブジェクトの子供をすべて削除します。
[29] 文脈オブジェクトの現在文書準備度を、 loading に設定します。
[72] 単純イベントを発火します。 >>30
単純イベント
イベント型
readystatechange
対象
文脈オブジェクト
[31] 真を返して停止します。

[32] 引き続き、並列に、次のような要求を fetch しなければなりません。 >>17

URL: 得られた URL
クライアント: 入口設定群オブジェクト
終点: subresource
同期フラグ: 設定する
モード: 同じ起源
credentialsモード: same-origin
URL credentials利用フラグ: 設定する

[33] fetch の応答のContent-Typeメタデータが XML MIME型の場合は、新しいXML構文解析器を作成し、新しい Document と関連付け、応答の本体をこのXML構文解析器により構文解析しなければなりません。 XML の整形式かつ名前空間整形式でない場合には、新しい文書からすべての子供を削除しなければなりません。 >>17

[34] fetch 後、次のようなタスクをタスクキューに追加しなければなりません >>17。

タスク

タスク源

処理

[35] 文脈オブジェクトの現在文書準備度を、 complete に設定します。
[36] 単純イベントを発火します。 >>30
単純イベント
イベント型
readystatechange
対象
文脈オブジェクト
[37] 新しい文書 (あれば) の子供を、すべて新しい DocumentFragment の子供とします。
[38] DocumentFragment を文脈オブジェクトに挿入します。
[39] 単純イベントを発火します。 >>30
単純イベント
イベント型
load
対象
文脈オブジェクト

[40] 名前空間整形式でない場合やエラーの場合は、文脈オブジェクトの文書は空になります。

[41] 一般にWebブラウザーは実際には XML 1.0 に厳密に従っておらず、エラーとするかそうでないかの条件が異なっています。ここでも XML 仕様ではなく、WebブラウザーにおけるXMLの動作に倣うものと思われます。

歴史

[1] DOM3LS WD にあったのと同じ or 似た意味の load メソッドは、 MSXML (not MSHTML) や Gecko で実装されています。

[2] Hawk's W3 Laboratory : XML : JavaScriptでXMLを扱う方法 (2009-01-04 12:36:07 +09:00 版) <http://web.archive.org/web/20060902115316/www.hawk.34sp.com/stdpls/xml/js_xml.html>

MSXML では、同期的に読み込みを行った場合、loadメソッドは読み込みの成否に応じて真偽値を返すので、parseErrorプロパティからIXMLDOMParseError オブジェクトにアクセスしてエラー情報を取り出すことができます。

ただしこの (async を false にする) 方法は古いバージョンのGeckoエンジンでは使用できません。私は最新のソースを追いかけているわけではないので正確には分かりませんが、Mozilla's DOM Sample Projectを参考にする限り、Mozilla 1.3.1 の段階ではasyncプロパティは存在しません。またNetscape 7.0では使用不可能なのを確認しています。
確実に使用できるのは onload イベントの中で処理を行う方法です。
さて、続いてエラー処理についてです。Geckoベースのブラウザの場合、エラー処理は少々複雑です。
まず読み込みそのものに(ファイルが見つからないなどの理由で)失敗した場合と、XMLのパースに失敗した場合とでエラー時の動作が異なります。更にその双方が、少なくとも一度仕様変更されています(もしかしたらもっと多いかも知れません)。先述したとおり私は細かくソースを追ってはいませんので、ここでは参考までに、Netscape 7.0での動作を旧仕様として、Mozilla Firefox 1.0PRの動作を新仕様として紹介しておきます。
まず旧仕様においては、読み込みそのものに失敗しても一切エラーは起こりませんので、documentElement が null であることから判断するしかありません。
次に、XMLのパースに失敗した場合、以下のようなXMLが読み込まれたものとして扱われます。エラーらしい動作は一切起こりません。
現実的にはルート要素の名前がparsererrorで、namespaceURIがhttp://www.mozilla.org/newlayout/xml/parsererror.xmlだったらエラーと判断することになるでしょう。ちなみにこの名前空間にどんな根拠があるのかは不明ですが、ソース中にも直書きしてあったりするので、ある程度は信頼できるものと思われます。
一方新仕様の場合、ファイルの読み込みそのものに失敗すると例外がthrowされるので、loadメソッドはtryブロックの中で実行する必要があります。
次に、XMLのパースに失敗した場合、以下のようなXMLが読み込まれたとして扱われます。やはりエラーらしい動作は起こりません。
要素名や名前空間は旧仕様と同じですが、よく見比べると微妙に書式が異なっています。この違いにどの程度の意味があるのかは分かりませんので、あくまで参考に留めておいてください。

[3] 同一起源方針の対象になっているみたいです。