The close
event is fired when a connection with a WebSocket
is closed.
Bubbles | No |
Cancelable | No |
Interface | CloseEvent
|
Event handler property | onclose
|
Examples
You might want to know when the connection has been closed so that you can update the UI or, perhaps, save data about the closed connection. Given that you have a variable called exampleSocket
that refers to an opened WebSocket
, this handler would handle the situation where the socket has been closed.
exampleSocket.addEventListener('close', (event) => {
console.log('The connection has been closed successfully.');
)};
You can perform the same actions using the event handler property, like this:
exampleSocket.onclose = function (event) {
console.log('The connection has been closed successfully.');
};
Specifications
Specification | Status |
---|---|
HTML Living StandardThe definition of 'WebSocket close' in that specification. | Living Standard |
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
close event
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support Yes |
IE
? |
Opera
Full support Yes |
Safari
? |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support Yes |
Opera Android
? |
Safari iOS
? |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
See also
- WebSocket: error event
- WebSocket: message event
- WebSocket: open event
- Writing WebSocket client applications
WebSocket: close event by Mozilla Contributors is licensed under CC-BY-SA 2.5.