Firefox Tomorrow

web api event

WebSocket: close event

View on MDN ↗

Available in workers

The close event is fired when a connection with a WebSocket is closed.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener("close", (event) => { })

onclose = (event) => { }

Event type

A CloseEvent. Inherits from Event.

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 = (event) => {
  console.log("The connection has been closed successfully.");
};

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also