Spec-Zone.ru › Web APIs

Документ: метод writeln()

Базовая линия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Показать полную совместимость
  • Отправить отзыв

Предупреждение: Использование метода document.writeln() настоятельно не рекомендуется.

Как предупрещает сам спецификация HTML:

У этого метода очень специфическое поведение. В некоторых случаях этот метод может повлиять на состояние парсера HTML во время его работы, что приведет к DOM, не соответствующему исходному документу (например, если записанная строка — это строка "<plaintext>" или "<!--"). В других случаях вызов может сначала очистить текущую страницу, как если бы был вызван document.open(). В ещё большем количестве случаев метод просто игнорируется или генерирует исключение. Агенты пользователей явным образом разрешено избегать выполнения script элементов, вставленных с помощью этого метода. Что ещё хуже, точное поведение этого метода в некоторых случаях может зависеть от задержки сети, что может привести к ошибкам, которые очень сложно отладить. По всем этим причинам использование этого метода настоятельно не рекомендуется. Поэтому избегайте использования document.writeln() — и по возможности обновите любой существующий код, который его всё ещё использует.

Записывает строку текста, за которой следует символ новой строки, в документ.

Синтаксис

writeln(line)

Параметры

line

Строка, содержащая строку текста.

Возвращаемое значение

Ничего (undefined).

Примеры

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

Примечания

document.writeln эквивалентен document.write, но добавляет символ новой строки.

Примечание: document.writeln (как и document.write) не работает в XHTML-документах (вы получите ошибку "Операция не поддерживается" (NS_ERROR_DOM_NOT_SUPPORTED_ERR) в консоли ошибок). Это происходит, если открывается локальный файл с расширением .xhtml или для любого документа, предоставленного с типом MIME application/xhtml+xml. Дополнительную информацию можно найти в FAQ по XHTML от W3C.

Спецификации

Спецификация
HTML
# dom-document-writeln-dev

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
writeln 45
1–45Поддерживается только для HTMLDocument, а не для всех Document объектов.
12 69
1–69Поддерживается только для HTMLDocument, а не для всех Document объектов.
51
≤12.1–51Поддерживается только для HTMLDocument, а не для всех Document объектов.
11
1–11Поддерживается только для HTMLDocument, а не для всех Document объектов.
45
18–45Поддерживается только для HTMLDocument, а не для всех Document объектов.
79
4–79Поддерживается только для HTMLDocument, а не для всех Document объектов.
47
≤12.1–47Поддерживается только для HTMLDocument, а не для всех Document объектов.
11
1–11Поддерживается только для HTMLDocument, а не для всех Document объектов.
5.0
1.0–5.0Поддерживается только для HTMLDocument, а не для всех Document объектов.
45
4.4–45Поддерживается только для HTMLDocument, а не для всех Document объектов.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/writeln

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API