Spec-Zone.ru › Web APIs

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

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

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

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

Метод Document.open() открывает документ для записи.

Это влечёт некоторые побочные эффекты. Например:

  • Все обработчики событий, которые в настоящее время зарегистрированы в документе, узлах внутри документа или окне документа, удаляются.
  • Все существующие узлы удаляются из документа.

Синтаксис

open()

Параметры

Нет.

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

Экземпляр объекта Document.

Примеры

Следующий простой код открывает документ, заменяет его содержимое несколькими HTML-фрагментами и снова закрывает его.

document.open();
document.write("<p>Hello world!</p>");
document.write("<p>I am a fish</p>");
document.write("<p>The number is 42</p>");
document.close();

Примечания

Автоматический вызов document.open() происходит при вызове document.write() после загрузки страницы.

Безопасность содержимого

Этот метод подчиняется той же политике одного происхождения, что и другие свойства, и не работает, если это изменит происхождение документа.

Метод document.open() с тремя аргументами

Существует менее известная и мало используемая версия метода document.open() с тремя аргументами, которая является псевдонимом для Window.open() (см. его страницу для получения подробной информации).

Этот вызов, например, открывает github.com в новом окне с установленным свойством opener в null.

document.open("https://www.github.com", "", "noopener=true");

Метод document.open() с двумя аргументами

Браузеры раньше поддерживали версию метода document.open() с двумя аргументами с подписью:

document.open(type, replace);

Где type определял MIME-тип данных, которые вы записываете (например, text/html). И заменяет ли (т.е. строка "replace"), указывал, что запись в историю для нового документа заменит текущую запись в истории документа, в который происходит запись.

Эта форма устарела; она не вызовет ошибки, а вместо этого перенаправляет на document.open() (т.е. эквивалентна её вызову без аргументов). Теперь поведение по замене истории всегда происходит.

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
open 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 объектов.

См. также

  • Document
  • Window.open()

© 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/open

Spec-Zone.ru

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