.open()
書き込み(document.write)のために、ドキュメントをオープンの状態にします。
文法
document.open();
例
// 下記の例でドキュメントの内容は、
// open()の最初期化によって上書きされます。
document.write("<html><p>remove me</p></html>");
document.open();
// ドキュメントは空です。
注意事項
もし対象にドキュメントが存在する場合、このメソッドはそれをクリアします。(上記の例を参照)
また、ページの読み込み後のdocument.write時に、
自動的にdocument.open()
の呼び出しが発生しますが、
これはW3C仕様に定義されていません。
このメソッドをwindow.open()と混同しないでください。
document.open
は現在のドキュメントへの上書きまたは追記を許可する一方で、
window.open()は、現在のドキュメントのそのままに、
新しいウインドウを開く手段を提供します。
window
はグローバルオブジェクトであるため、open(...)
だけを書いて呼び出すと、
window.open(...)
を呼び出したのと同じことになります。
開いたドキュメントは、document.close()を使用することで閉じることが可能です。
Gecko 1.9注意点
Gecko 1.9から、このメソッドは他のプロパティと同様に同一生成元ポリシーの対象となり、 もしドキュメントの供給先を変更すると、動作しなくなります。
Gecko 1.9.2注意点
Gecko 1.9.2からは、document.open()
は、スタックされているものから取得する代わりに、
主要(principal)なドキュメント使用するURIを使用します。(翻訳に自信なし)
結果として、wrappedJSObject
を使用したとしても、
Chromeから信頼されていないドキュメントへ、document.write()
を呼び出すことは出来なくなりました。(翻訳に自信なし)
principalについての詳細は、 基本的なセキュリティの確認を参照してください。
仕様
© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
- 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
- MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。