CloseEvent: свойство code
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Примечание: Эта функция доступна в Web Workers.
Только для чтения code свойство интерфейса CloseEvent возвращает код закрытия соединения WebSocket, указывающий причину закрытия соединения.
Значение
Целое число код закрытия соединения WebSocket в диапазоне 1000 - 4999, указывающий причину закрытия соединения.
| Код состояния | Значение | Описание |
|---|---|---|
0–999
| Не используется. | |
1000 | Нормальное завершение | Соединение успешно завершило цель, для которой оно было создано. |
1001 | Отход | Конечная точка покидает соединение, либо из-за сбоя сервера, либо потому что браузер переходит на другую страницу, открывшую соединение. |
1002 | Ошибка протокола | Конечная точка закрывает соединение из-за ошибки протокола. |
1003 | Неподдерживаемые данные | Соединение закрывается, поскольку конечная точка получила данные типа, который она не может принять. (Например, только текстовая конечная точка получила двоичные данные.) |
1004 | Зарезервировано | Зарезервировано. Возможно, значение будет определено в будущем. |
1005 | Код статуса не получен | Зарезервировано. Указывает, что код состояния не был предоставлен, хотя он ожидался. |
1006 | Аномальное завершение | Зарезервировано. Указывает, что соединение было закрыто аномально (то есть без отправки фрейма закрытия), когда ожидался код состояния. |
1007 | Недействительные данные полезной нагрузки фрейма | Конечная точка закрывает соединение, потому что получено сообщение, содержащее несогласованные данные (например, данные, не являющиеся UTF-8, в текстовом сообщении). |
1008 | Нарушение политики | Конечная точка закрывает соединение, потому что она получила сообщение, нарушающее ее политику. Это общий код состояния, используемый, когда коды 1003 и 1009 не подходят. |
1009 | Сообщение слишком большое | Конечная точка закрывает соединение, потому что получен фрейм данных, который слишком большой. |
1010 | Обязательные расширения | Клиент закрывает соединение, потому что ожидал, что сервер договорится об одном или нескольких расширениях, но сервер этого не сделал. |
1011 | Внутренняя ошибка | Сервер закрывает соединение, так как столкнулся с непредвиденным условием, помешавшим ему выполнить запрос. |
1012 | Перезапуск службы | Сервер закрывает соединение, так как выполняется перезапуск. |
1013 | Попробуйте позже | Сервер закрывает соединение из-за временного состояния, например, из-за перегрузки и отбрасывания некоторых клиентов. |
1014 | Плохой шлюз | Сервер действовал как шлюз или прокси и получил недопустимый ответ от сервера вышестоящего уровня. Это аналогично коду состояния HTTP 502. |
1015 | TLS-рукопожатие | Зарезервировано. Указывает, что соединение было закрыто из-за сбоя в выполнении TLS-рукопожатия (например, сертификат сервера не может быть проверен). |
1016–2999
| Для определения будущими пересмотрами спецификации протокола WebSocket и для определения спецификациями расширений. | |
3000–3999
| Для использования библиотеками, фреймворками и приложениями. Эти коды статуса зарегистрированы непосредственно в IANA. Интерпретация этих кодов не определена протоколом WebSocket. | |
4000–4999
| Для частного использования, и поэтому не может быть зарегистрирован. Такие коды могут использоваться по предварительной договоренности между приложениями WebSocket. Интерпретация этих кодов не определена протоколом WebSocket. |
Примеры
В следующем примере выводится значение code в консоль.
WebSocket.onclose = (event) => {
console.log(event.code);
};
Спецификации
| Спецификация |
|---|
| WebSocket # ref-for-dom-closeevent-code② |
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
code |
15 | 12 | 8 | 12.1 | 6 | 18 | 8 | 12.1 | 6 | 1.0 | 4.4 |
См. также
- RFC 6455 (спецификация протокола WebSocket)
- Регистр кодов закрытия WebSocket (IANA)
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent/code
