blob: b6951d94a0ce251022b12496086b7db1871435ba (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
---
title: Document.domain
slug: Web/API/Document/domain
tags:
- API
- DOM
- Document
- 参考
- 同源策略
- 属性
- 跨域
translation_of: Web/API/Document/domain
---
<div>{{ApiRef}}</div>
<p>{{domxref("Document")}} 接口的 <strong><code>domain</code></strong> 属性获取/设置当前文档的原始域部分，常用于<a href="/en-US/docs/Web/Security/Same-origin_policy">同源策略</a>。</p>
<p>如果成功设置此属性，则原始端口的端口部分也将设置为 <code>null</code>.</p>
<h2 id="语法">语法</h2>
<pre class="syntaxbox">var <var>domainString</var> = <var>document</var>.domain;
<var>document</var>.domain = <var>domainString</var>;</pre>
<h3 id="值">值</h3>
<p>当前文档来源的域部分.</p>
<h3 id="异常">异常</h3>
<dl>
<dt>安全错误</dt>
<dd>已尝试在以下情况之一下设置域：
<ul>
<li>文件在html中的iframe元素里</li>
<li>该文件没有参考上下文</li>
<li>该文档的有效域为null</li>
<li>给定值不等于文档的有效域（或者它不是该域的可注册域后缀）</li>
<li>The {{httpheader('Feature-Policy/document-domain','document-domain')}} {{HTTPHeader("Feature-Policy")}}一启用</li>
</ul>
</dd>
</dl>
<h2 id="例子">例子</h2>
<h3 id="获取域名">获取域名</h3>
<p>对于URI http://developer.mozilla.org/en-US/docs/Web，此示例将currentDomain设置为字符串“ developer.mozilla.org”。</p>
<pre class="brush:js">var currentDomain = document.domain;</pre>
<h3 id="关闭窗口">关闭窗口</h3>
<p>如果文档（例如www.example.xxx/good.html）的域为“ www.example.xxx”，则本示例将尝试关闭窗口。</p>
<pre class="brush:js">var badDomain = "www.example.xxx";
if (document.domain == badDomain) {
// 这只是一个示例 - 有时 window.close() 是没有效果的
window.close();
}
</pre>
<h2 id="规范">规范</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">规范</th>
<th scope="col">状态</th>
<th scope="col">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('HTML WHATWG','origin.html#relaxing-the-same-origin-restriction','Document.domain')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
<div class="hidden">此页面上的兼容性表是根据结构化数据生成的。如果您想贡献数据，请查看https://github.com/mdn/browser-compat-data并向我们发送请求请求</div>
<div>{{Compat("api.Document.domain")}}</div>
<h3 id="Firefox_备注">Firefox 备注</h3>
<p>如果当前文档的域无法识别，那么 domain 属性会返回 null。但这个表现在 Firefox 62 时发生了更改——详见 {{bug(819475)}} 中的讨论。</p>
<p>在<a href="/en-US/docs/XPCOM_Interface_Reference/nsIEffectiveTLDService#getBaseDomain.28.29">根域名</a>范围内，Mozilla 允许你把 domain 属性的值设置为它的上一级域。例如，在 developer.mozilla.org 域内，可以把 domain 设置为 "mozilla.org" 但不能设置为 "mozilla.com" 或者"org"。</p>
<p>Mozilla 会区分 <code>document.domain</code> 属性 <strong>从没有被设定过值 </strong>和 <strong>被显示的设定为跟该文档的 URL 的 domain 一致的值</strong>，尽管这两种状况下，该属性会返回同样的值。两个文档，只有在 <code>document.domain</code> 都被设定为同一个值，表明他们打算协作；或者都没有设定 <code>document.domain</code> 属性并且URL的域是一致的 (<a href="https://mxr.mozilla.org/mozilla-central/source/caps/src/nsScriptSecurityManager.cpp#1003">如何判断一致</a>)，这两种条件下，一个文档才可以去访问另一个文档。如果没有这个特殊的策略，每一个站点都会成为他的子域的 XSS 攻击的对象（例如，<a class="link-https" href="https://bugzilla.mozilla.org" rel="freelink">https://bugzilla.mozilla.org</a> 可以被来自 <a class="link-https" href="https://bug*.bugzilla.mozilla.org" rel="freelink">https://bug*.bugzilla.mozilla.org</a> 站点的 bug 附件攻击）。</p>
<h2 id="参见">参见</h2>
<ul>
<li><a href="/en-US/docs/Web/Security/Same-origin_policy">Same origin policy for JavaScript</a></li>
</ul>
|
