XMLSerializer.serializeToString()

構文

引数

XML 表現を構築する DOM ツリーまたはサブツリーのルートとして用いる Node です。

返値

指定された DOM ツリーの XML 表現が入った文字列です。

例外

指定された rootNode が対応しているノード型でないとき投げられます。ルートノードは Node または Attr でなければなりません。

ツリーが正常にシリアライズできなかったとき投げられます。おそらくコンテンツの XML シリアライズ対応に関する問題が原因です。

HTML のシリアライズを要求されたが、コンテンツが良い形式でないため成功しなかったとき投げられます。

使用法の注意点

対応しているノード型

指定するルートノードとその全ての子孫は、XML シリアライズのアルゴリズムに対応しているものでなければなりません、ルートノード自身は、Node または Attr のオブジェクトでなければなりません。

ルートノードの子孫では、Node と Attr に加えて以下の型も利用可能です。

• DocumentType
• Document
• DocumentFragment
• Element
• Comment
• Text
• ProcessingInstruction
• Attr

これ以外の型が見つかった場合、TypeError 例外が投げられます。

結果の XML に関する注意点

serializeToString() から出力される XML について、注意するべき点がいくつかあります。

• XML シリアライズにおいては、Element および Attr のノードの namespaceURI は常にそのままシリアライズされます。すなわち、指定されている prefix やデフォルト名前空間は消されたり変更されたりする可能性があります。
• 結果の XML は HTML パーサーに対応しています。
• HTML 名前空間にある子ノードを持たない (すなわち、空タグを表している) 要素は、空要素タグ ("<someelement/>") ではなく開始タグと終了タグ ("<someelement></someelement>") を用いてシリアライズされます。

仕様書

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

• XML のパースとシリアライズ
• HTML にシリアライズする : Element.innerHTML と Element.outerHTML
• HTML や XML をパースして DOM ツリーを生成する : DOMParser