CloseEvent: thuộc tính code
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.
Note: This feature is available in Web Workers.
Thuộc tính chỉ đọc code của giao diện CloseEvent trả về một mã đóng kết nối WebSocket cho biết lý do kết nối bị đóng.
Giá trị
Một mã đóng kết nối WebSocket kiểu số nguyên trong phạm vi 1000 - 4999, cho biết lý do kết nối bị đóng.
| Mã trạng thái | Ý nghĩa | Mô tả |
|---|---|---|
0–999 |
Không dùng. | |
1000 |
Đóng bình thường | Kết nối đã hoàn thành thành công mục đích mà nó được tạo ra. |
1001 |
Rời đi | Điểm cuối đang rời đi, hoặc do máy chủ gặp sự cố, hoặc do trình duyệt đang điều hướng khỏi trang đã mở kết nối. |
1002 |
Lỗi giao thức | Điểm cuối đang chấm dứt kết nối do lỗi giao thức. |
1003 |
Dữ liệu không được hỗ trợ | Kết nối đang bị chấm dứt vì điểm cuối nhận được dữ liệu có kiểu mà nó không thể chấp nhận. (Ví dụ: một điểm cuối chỉ hỗ trợ văn bản lại nhận dữ liệu nhị phân.) |
1004 |
Được dành riêng | Được dành riêng. Ý nghĩa có thể sẽ được định nghĩa trong tương lai. |
1005 |
Không nhận được trạng thái | Được dành riêng. Cho biết không có mã trạng thái nào được cung cấp dù đáng lẽ phải có. |
1006 |
Đóng bất thường | Được dành riêng. Cho biết một kết nối đã bị đóng bất thường (tức là không gửi khung đóng) trong khi lẽ ra phải có mã trạng thái. |
1007 |
Dữ liệu tải của khung không hợp lệ | Điểm cuối đang chấm dứt kết nối vì đã nhận được một thông điệp chứa dữ liệu không nhất quán (ví dụ: dữ liệu không phải UTF-8 trong một thông điệp văn bản). |
1008 |
Vi phạm chính sách | Điểm cuối đang chấm dứt kết nối vì đã nhận được một thông điệp vi phạm chính sách của nó. Đây là mã trạng thái tổng quát, được dùng khi các mã 1003 và 1009 không phù hợp. |
1009 |
Thông điệp quá lớn | Điểm cuối đang chấm dứt kết nối vì đã nhận được một khung dữ liệu quá lớn. |
1010 |
Thiếu phần mở rộng bắt buộc | Client đang chấm dứt kết nối vì nó mong đợi máy chủ thương lượng một hoặc nhiều phần mở rộng, nhưng máy chủ đã không làm vậy. |
1011 |
Lỗi nội bộ | Máy chủ đang chấm dứt kết nối vì gặp một điều kiện bất ngờ khiến nó không thể hoàn thành yêu cầu. |
1012 |
Khởi động lại dịch vụ | Máy chủ đang chấm dứt kết nối vì nó đang khởi động lại. |
1013 |
Thử lại sau | Máy chủ đang chấm dứt kết nối do một điều kiện tạm thời, ví dụ nó đang quá tải và đang ngắt bớt một số client. |
1014 |
Cổng kết nối lỗi | Máy chủ đang hoạt động như một gateway hoặc proxy và đã nhận được phản hồi không hợp lệ từ máy chủ thượng nguồn. Điều này tương tự với mã trạng thái HTTP 502. |
1015 |
Bắt tay TLS | Được dành riêng. Cho biết kết nối bị đóng do không thể thực hiện bắt tay TLS (ví dụ: không thể xác minh chứng chỉ máy chủ). |
1016–2999 |
Dành cho việc định nghĩa bởi các bản sửa đổi trong tương lai của đặc tả WebSocket Protocol, và bởi các đặc tả phần mở rộng. | |
3000–3999 |
Dành cho thư viện, framework và ứng dụng sử dụng. Các mã trạng thái này được đăng ký trực tiếp với IANA. Cách diễn giải các mã này không được giao thức WebSocket định nghĩa. | |
4000–4999 |
Dành cho sử dụng riêng tư nên không thể đăng ký. Các mã như vậy có thể được dùng theo thỏa thuận trước giữa các ứng dụng WebSocket. Cách diễn giải các mã này không được giao thức WebSocket định nghĩa. |
Ví dụ
Ví dụ sau ghi giá trị của code ra console.
js
WebSocket.onclose = (event) => {
console.log(event.code);
};
Thông số kỹ thuật
| Specification |
|---|
| WebSockets # ref-for-dom-closeevent-code② |
Khả năng tương thích với trình duyệt
Xem thêm
- RFC 6455 (đặc tả WebSocket Protocol)
- WebSocket Close Code Number Registry (IANA)