文档:writeln() 方法

警告: 强烈建议不要使用 document.writeln() 方法。

正如 HTML 规范本身警告

此方法的行为非常特殊。在某些情况下,此方法会影响 HTML 解析器 在运行时的状态,导致 DOM 不对应于文档的源代码(例如,如果写入的字符串是字符串 "<plaintext>" 或 "<!--")。在其他情况下,调用可能会先清除当前页面,就像 document.open() 被调用一样。在更多情况下,该方法被简单地忽略,或者抛出异常。用户代理被 明确允许避免执行通过此方法插入的 script 元素。更糟糕的是,此方法的确切行为在某些情况下可能取决于网络延迟,这会导致非常难以调试的故障。由于所有这些原因,强烈建议不要使用此方法。因此,请避免使用 document.writeln() - 如果可能的话,请更新任何仍在使用它的现有代码。

将文本字符串后跟换行符写入文档。

语法

js
writeln(line)

参数

  • line 是包含一行文本的字符串。

返回值

无 (undefined).

示例

js
document.writeln("<p>enter password:</p>");

注释

document.writelndocument.write 相同,但会添加换行符。

注意: document.writeln(与 document.write 一样)在 XHTML 文档中不起作用(您将在错误控制台中收到 "操作不支持" (NS_ERROR_DOM_NOT_SUPPORTED_ERR) 错误)。如果打开带有 .xhtml 文件扩展名的本地文件或以 application/xhtml+xml MIME 类型提供的任何文档,则会出现这种情况。您可以在 W3C XHTML 常见问题解答 中找到更多信息。

规范

规范
HTML 标准
# dom-document-writeln-dev

浏览器兼容性

BCD 表格仅在浏览器中加载