XMLSerializer.serializeToString()

rootNode

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

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

TypeError

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

InvalidStateError DOMException

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

SyntaxError DOMException

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

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

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

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

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

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

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

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