From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/document/domain/index.html | 106 ++++++++++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 files/ru/web/api/document/domain/index.html (limited to 'files/ru/web/api/document/domain') diff --git a/files/ru/web/api/document/domain/index.html b/files/ru/web/api/document/domain/index.html new file mode 100644 index 0000000000..bd54dc1f83 --- /dev/null +++ b/files/ru/web/api/document/domain/index.html @@ -0,0 +1,106 @@ +--- +title: Document.domain +slug: Web/API/Document/domain +tags: + - API + - Document + - Domain + - HTML DOM + - Property + - Same Origin + - Same Origin Policy + - iframe +translation_of: Web/API/Document/domain +--- +
{{ApiRef}}
+ +
Свойство domain у {{domxref("Document")}} интерфейса получает/устанавливает доменную часть источника происхождения (origin) текущего документа, используется в политике ограничения домена (same origin policy).
+ +

Синтаксис

+ +
var domainString = document.domain;
+document.domain = string;
+ +

Значение

+ +

Доменная часть источника происхождения (origin) текущего документа.

+ +

Исключения

+ +
+
SecurityError
+
An attempt has been made to set domain under one of the following conditions: +
    +
  • The document is inside a sandboxed {{htmlelement("iframe")}}
    • +
  • The document has no browsing context
    • +
  • The document's effective domain is null
    • +
  • The given value is not equal to the document's effective domain (or it is not a registerable domain suffix of it)
    • +
  • The {{httpheader('Feature-Policy/document-domain','document-domain')}} {{HTTPHeader("Feature-Policy")}} is enabled
    • +
+
+
+ +

Examples

+ +

Getting the domain

+ +

For the URI http://developer.mozilla.org/en-US/docs/Web, this example sets currentDomain to the string "developer.mozilla.org".

+ +
var currentDomain = document.domain;
+ +

Closing a window

+ +

If a document, such as www.example.xxx/good.html, has the domain of "www.example.xxx", this example attempts to close the window.

+ +
var badDomain = "www.example.xxx";
+
+if (document.domain == badDomain) {
+  // Just an example: window.close() sometimes has no effect
+  window.close();
+}
+ +

Замечания

+ +

Свойство возвращает null если домен документа не может быть идентифицирован, хотя теперь это изменилось с Firefox 62 - смотри обсуждение в {{bug(819475)}}.

+ +

Mozilla позволит вам установить его в супердомен текущего значения, ограниченный его  базовым доменом. Например, на developer.mozilla.org возможно установить его как "mozilla.org" но не как  "mozilla.com" или "org".

+ +

Если это свойство успешно установленно, портовая часть источника так же уставнавливается на нуль.

+ +

Mozilla отличает свойство document.domain, которое никогда не было установлено от явно утановленного такого же домена как в URL документа, хотя свойство возвращает одинаковое значение в обоих случаях. Один документ разрешает доступ к другому, если они оба установили document.domain в одинаковое значение, указывая тем самым на их намерение сотрудничать или ни один из них не установил document.domain, а домены в URL-адресах одинаковые (реализация). Если бы не эта специальная политика, то каждый сайт будет подвержен XSS от своих поддоменов (для примера https://bugzilla.mozilla.org может быть атакован с помощью заведения багов (bug attachments) на https://bug*.bugzilla.mozilla.org).

+ +

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

+ + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('HTML WHATWG','origin.html#relaxing-the-same-origin-restriction','Document.domain')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML 5.2','browsers.html#relaxing-the-same-origin-restriction','Document.domain')}}{{Spec2('HTML 5.2')}} 
+ +

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

+ + + +

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

+ +

Смотрите также

+ + -- cgit v1.2.3-54-g00ecf