CloseEvent
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
當 WebSocket 連線關閉時,客戶端會收到一個 CloseEvent
,由 WebSocket
物件 onclose
屬性表示的監聽器接收。
屬性
屬性 | 形態 | 描述 |
---|---|---|
code |
unsigned long |
WebSocket 伺服器給予的連線關閉代碼。「狀態代碼」列有所有可能值。 |
reason |
DOMString |
表示伺服器關閉連線的原因,這因不同的伺服器與子協定而定。 |
wasClean |
boolean |
表示連線關閉情況是否乾淨。 |
狀態代碼
以下列有所有合法的狀態代碼。
狀態代碼 | 描述 |
---|---|
0-999 | 尚未使用的保留值。 |
1000 | 正常關閉,連線成功地達到建立時的目標。 |
1001 | 端點去離,伺服器故障或是瀏覽器從開啟連線的頁面離去的情形。 |
1002 | 因協定錯誤造成連線被端點消滅。 |
1003 | 因端點接收不能處理的資料形態(舉例來說,文字端點收到二進制資料)而消滅連線。 |
1004 | 端點收到過大的資料幀而消滅連線。 |
1005 | 保留值。表示意外地未給予狀態代碼的情形。 |
1006 | 保留值。用以表示在預期收到狀態代碼的情形下不正常(即未送關閉幀)的連線關閉。 |
1007-1999 | 保留以作為未來的 WebSocket 標準之用。 |
2000-2999 | 保留以作為 WebSocket 擴展之用。 |
3000-3999 | 程式庫與框架使用的值,應用程式可不使用。 |
4000-4999 | 應用程式使用的值。 |
參見
瀏覽器兼容
BCD tables only load in the browser