.createProcessingInstruction()

新しい処理命令ノードを作成し、それを返します。

文法

pinode = document.createProcessingInstruction(target, data)
引数 説明
target 処理命令ノードの一部を対象とする参照を指定します。(<?target ... ?>)
data ノードに追加されるデータを含む文字を指定します。
戻り値
pinode ProcessingInstructionノードが返ります。

var docu = new DOMParser().parseFromString('<xml></xml>',  "application/xml")

var pi = docu.createProcessingInstruction('xml-stylesheet', 'href="mycss.css" type="text/css"');

docu.insertBefore(pi, docu.firstChild);

alert(new XMLSerializer().serializeToString(docu));
// 表示: <?xml-stylesheet href="mycss.css" type="text/css"?><xml/>

スローされる例外

NOT_SUPPORTED_ERR
Gecko 9 (Firefox 9.0 / Thunderbird 9.0 / SeaMonkey 2.6)、またはそれ以前で、 HTMLドキュメント上で処理命令ノードを作成しようとするとスローされます。 Gecko 10.0 (Firefox 10.0 / Thunderbird 10.0 / SeaMonkey 2.7)とそれ以降で、 HTMLドキュメント上でこのメソッドを使用することが可能です。
DOM_INVALID_CHARACTER
不正な処理命令対象を追加(XML名にするだけでなく、いずれかのケースで"xml"文字の組み合わせが必要)、 または一連の処理命令を閉じる"?>"が、データの一部として追加しようとすると、スローされます。 そのため、ユーザーから提供されるエスケープされないデータは、このような状況でエスケープ無しに安全に取り扱うことが出来ません。

仕様

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。