--- title: Document.write() slug: Web/API/Document/write tags: - API - DOM - Document - Method - Reference - write translation_of: Web/API/Document/write ---
{{ApiRef("DOM")}}

Document.write() メソッドは、テキストの文字列を {{domxref("document.open()")}} で開かれた文書ストリームに書き込みます。

注: document.write() は文書のストリームに書き込みを行うため、閉じられた (読み込み済みの) 文書で document.write() を呼び出すと、自動的に document.open() が呼び出され、文書はクリアされます。

構文

document.write(markup);

引数

markup
文書に書き込まれるテキストを含む文字列です。

例

<html>

<head>
  <title>書き込み例</title>

  <script>
    function newContent() {
      document.open();
      document.write("<h1>新しい内容では、古い内容は削除されます！</h1>");
      document.close();
    }
  </script>
</head>

<body onload="newContent();">
  <p>元の文書コンテンツ。</p>
</body>

</html>

{{EmbedLiveSample("Syntax")}}

注

出力したテキストは文書構造モデルにおいて構文解析されます。上記の例では、 h1 要素は文書中の一つのノードになります。

{{domxref("document.open()")}} を呼び出さずに読み込まれた文書へ書き込みを行うと、自動的に document.open() の呼び出しが実行されます。一度出力し終わったとき、ブラウザーにページの読み込みの終了を伝えるために、 {{domxref("document.close()")}} を呼び出すことが推奨されます。

document.write() の呼び出しがインラインの HTML の <script> タグ内で行われた場合、 document.open() は呼び出されません。次に例を示します。

<script>
  document.write("<h1>Main title</h1>")
</script>
注: document.write() および {{domxref("document.writeln")}} は、 XHTML 文書では動作しません (エラーコンソールに "Operation is not supported" [NS_ERROR_DOM_NOT_SUPPORTED_ERR] エラーが表示されます)。これは、 .xhtml の拡張子を持つローカルファイルを開いたり、何らかの文書が application/xhtml+xml の {{Glossary("MIME type", "MIME タイプ")}}で提供されたときに発生します。詳細は W3C XHTML FAQ で確認することができます。
注: document.write は deferred または asynchronous のスクリプト内では無視され、エラーコンソールに "A call to document.write() from an asynchronously-loaded external script was ignored" などのメッセージが表示されます。
注: Edge のみ、document.write() を {{HTMLElement("iframe")}} 内で複数回呼び出すと、 SCRIPT70: Permission denied エラーが発生します。
注: Chrome 55 からは、キャッシュされていない HTTP の場合、document.write() を通じて挿入された <script> 要素は実行されなくなります。これが成立するのに必要な条件の一覧については、document.write() に対する介入をご覧ください。

仕様書

仕様書 状態 備考
{{SpecName("HTML WHATWG", "#dom-document-write", "document.write(...)")}} {{Spec2("HTML WHATWG")}}
{{SpecName("DOM2 HTML", "html.html#ID-75233634", "document.write(...)")}} {{Spec2("DOM2 HTML")}}

ブラウザーの互換性

{{Compat("api.Document.write")}}

関連情報