Document: writeln() メソッド

警告: document.writeln() メソッドの使用は固く避けるべきです。

HTML 仕様書自体で次のように警告しています

このメソッドの挙動はとても特異です。場合によっては、このメソッドは構文解析の実行中に HTML パーサーの状態に影響を与え、結果として文書のソースに対応しない DOM を生成することがあります(例えば、書き込まれた文字列が "<plaintext>" や "<!--" であった場合など)。他にも、document.open() が呼び出されたかのように、最初に現在のページをクリアしてしまう場合もあります。さらに多くの場合、メソッドは単に無視されるか、例外が発生します。ユーザーエージェントは このメソッドで挿入された script 要素の実行を回避することが明確に許可されています。さらに悪いことに、このメソッドの正確な動作はネットワークの遅延に依存する場合があり、デバッグがとても難しい失敗につながる可能性があります。これらすべての理由から、このメソッドを使用することは固く推奨されません。 したがって、document.writeln() を使用するのはやめましょう。そして可能であれば、使用している既存のコードを更新しましょう。

テキストの文字列とその直後に続く改行文字を文書に書き込みます。

構文

js
writeln(line)

引数

  • line はテキストの行を含む文字列です。

返値

なし (undefined)。

document.writeln("<p>パスワードを入力してください:</p>");

メモ

document.writelndocument.write と同じですが、改行文字を追加します。

メモ: document.writeln は (document.write と同様に) XHTML 文書では動作しません (エラーコンソールに "Operation is not supported" [NS_ERROR_DOM_NOT_SUPPORTED_ERR] エラーが表示されます)。これは、 .xhtml の拡張子を持つローカルファイルを開いたり、何らかの文書が application/xhtml+xml の MIME タイプで提供されたときに発生します。詳細は W3C XHTML FAQ で確認することができます。

仕様書

Specification
HTML
# dom-document-writeln-dev

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
writeln
Accepts TrustedHTML instances

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.