aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/headers/delete/index.html
blob: 12c52da4c08d7b929eac41e47a1a086bfc3495dc (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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
---
title: Headers.delete()
slug: Web/API/Headers/delete
translation_of: Web/API/Headers/delete
---
<p>{{APIRef("Fetch")}}{{ SeeCompatTable() }}</p>

<p><strong><code>delete()</code></strong> 方法可以从Headers对象中删除指定header.</p>

<p>下列原因将会导致该方法抛出一个<span style="line-height: 19.0909080505371px;">{{jsxref("TypeError")}}:</span></p>

<ul>
 <li><span style="line-height: 19.0909080505371px;">header名在HTTP header中是不存在的.</span></li>
 <li><span style="line-height: 19.0909080505371px;"><span style="line-height: 19.0909080505371px;">header被锁定了.<span style="line-height: 19.0909080505371px;"><span style="line-height: 19.0909080505371px;"></span></span></span></span></li>
</ul>

<div class="note">
<p style="line-height: 19.0909080505371px;"><strong>Note:</strong>出于安全原因, 部分头信息只能被用户代理控制. 这些头信息包括 {{Glossary("Forbidden_header_name", "forbidden header names", 1)}}  和 {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}}.</p>
</div>

<p style="line-height: 19.0909080505371px;"><strong style="font-size: 2.14285714285714rem; font-weight: 700; letter-spacing: -1px; line-height: 30px;">Syntax</strong></p>

<pre class="brush: js">myHeaders.delete(name);</pre>

<h3 id="Parameters">Parameters</h3>

<dl>
 <dt><em>name</em></dt>
 <dd>需删除的HTTP header名称.</dd>
</dl>

<h3 id="Returns">Returns</h3>

<p>Void.</p>

<h2 id="Example">Example</h2>

<p>创建一个空的Headers对象:</p>

<pre class="brush: js">var myHeaders = new Headers(); // Currently empty</pre>

<p>可以通过append()方法添加header:</p>

<pre class="brush: js">myHeaders.append('Content-Type', 'image/jpeg');
myHeaders.get('Content-Type'); // Returns 'image/jpeg'
</pre>

<p>可以通过delete()方法删除已有header:</p>

<pre class="brush: js">myHeaders.delete('Content-Type');
myHeaders.get('Content-Type'); // Returns null, as it has been deleted</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Fetch','#dom-headers-delete','delete()')}}</td>
   <td>{{Spec2('Fetch')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<p>{{ CompatibilityTable() }}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatChrome(42) }}<br>
    {{ CompatChrome(41) }} behind pref<br>
     </td>
   <td>{{ CompatGeckoDesktop(39)}}<br>
    34 behind pref</td>
   <td>{{ CompatNo }}</td>
   <td>
    <p>29<br>
     28 behind pref</p>
   </td>
   <td>{{ CompatNo }}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
   <td>{{ CompatNo }}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also">See also</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li>
 <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li>
 <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li>
</ul>