blob: 0a6d0977ff0c3d2767dae5b54fb778267569cab2 (
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
137
138
139
140
141
142
143
144
145
|
---
title: CloseEvent
slug: WebSockets/WebSockets_reference/CloseEvent
tags:
- WebSockets
translation_of: Web/API/CloseEvent
---
<p>{{ draft() }}</p>
<p>當 WebSocket 連線關閉時，客戶端會收到一個 <code>CloseEvent</code>，由 <code>WebSocket</code> 物件 <code>onclose</code> 屬性表示的監聽器接收。</p>
<h2 id="Attributes" name="Attributes">屬性</h2>
<table class="standard-table">
<tbody>
<tr>
<td class="header">屬性</td>
<td class="header">形態</td>
<td class="header">描述</td>
</tr>
<tr>
<td><code>code</code></td>
<td><code><a href="/en/unsigned_long" title="en/unsigned long">unsigned long</a></code></td>
<td>WebSocket 伺服器給予的連線關閉代碼。「狀態代碼」列有所有可能值。</td>
</tr>
<tr>
<td><code>reason</code></td>
<td>{{ domxref("DOMString") }}</td>
<td>表示伺服器關閉連線的原因，這因不同的伺服器與子協定而定。</td>
</tr>
<tr>
<td><code>wasClean</code></td>
<td><code>boolean</code></td>
<td>表示連線關閉情況是否乾淨。</td>
</tr>
</tbody>
</table>
<h2 id="狀態代碼">狀態代碼</h2>
<p>以下列有所有合法的狀態代碼。</p>
<table class="standard-table">
<tbody>
<tr>
<td class="header">狀態代碼</td>
<td class="header">描述</td>
</tr>
<tr>
<td>0-999</td>
<td><strong>尚未使用的保留值。</strong></td>
</tr>
<tr>
<td>1000</td>
<td>正常關閉，連線成功地達到建立時的目標。</td>
</tr>
<tr>
<td>1001</td>
<td>端點去離，伺服器故障或是瀏覽器從開啟連線的頁面離去的情形。</td>
</tr>
<tr>
<td>1002</td>
<td>因協定錯誤造成連線被端點消滅。</td>
</tr>
<tr>
<td>1003</td>
<td>因端點接收不能處理的資料形態（舉例來說，文字端點收到二進制資料）而消滅連線。</td>
</tr>
<tr>
<td>1004</td>
<td>端點收到過大的資料幀而消滅連線。</td>
</tr>
<tr>
<td>1005</td>
<td><strong>保留值。</strong>表示意外地未給予狀態代碼的情形。</td>
</tr>
<tr>
<td>1006</td>
<td><strong>保留值。</strong>用以表示在預期收到狀態代碼的情形下不正常（即未送關閉幀）的連線關閉。</td>
</tr>
<tr>
<td>1007-1999</td>
<td><strong>保留以作為未來的 WebSocket 標準之用。</strong></td>
</tr>
<tr>
<td>2000-2999</td>
<td><strong>保留以作為 WebSocket 擴展之用。</strong></td>
</tr>
<tr>
<td>3000-3999</td>
<td>程式庫與框架使用的值，應用程式<strong>可不</strong>使用。</td>
</tr>
<tr>
<td>4000-4999</td>
<td>應用程式使用的值。</td>
</tr>
</tbody>
</table>
<h2 id="參見">參見</h2>
<ul>
<li><a href="/zh_tw/WebSockets/WebSockets_reference/WebSocket" title="zh tw/WebSockets/WebSockets reference/WebSocket"><code>WebSocket</code></a></li>
</ul>
<h2 id="瀏覽器兼容">瀏覽器兼容</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>功能</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>基本支援</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatNo() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>功能</th>
<th>Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>基本支援</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatNo() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
</tr>
</tbody>
</table>
</div>
<h3 id="Gecko_備註">Gecko 備註</h3>
<p>此時此刻，Gecko 送至監聽器的 "close" 事件僅是簡單事件。</p>
<p>{{ languages ( {"en": "en/WebSockets/WebSockets_reference/CloseEvent"} ) }}</p>
|
