Utilisation

Keep a connection open

tsx
const socket = new WebSocket('wss://chat.example.com', ['v2']);

socket.onopen = () => socket.send(JSON.stringify({ hello: true }));
socket.onmessage = ({ data }) => console.log(data); // a string, or an ArrayBuffer
socket.onclose = ({ code, reason, wasClean }) => {};

Constructeurs

ts
(url: string | URL, protocols?: string | string[]): WebSocket

Paramètres

NomTypeRequisDescription
urlstring | URLOui—
protocolsstring | string[]Non—

Retourne

WebSocket

Propriétés et méthodes 19

NomTypeRequisDescription
prototypelecture seuleWebSocketOui—
CONNECTINGlecture seule0Oui—
OPENlecture seule1Oui—
CLOSINGlecture seule2Oui—
CLOSEDlecture seule3Oui—
urllecture seulestringOui—
readyStatelecture seule0 | 2 | 1 | 3Oui—
protocollecture seulestringOuiThe subprotocol the server chose, once open.
bufferedAmountlecture seulenumberOuiAlways 0: bytes are not counted on their way out.
extensionslecture seulestringOui—
binaryType"arraybuffer"OuiOnly 'arraybuffer': there is no Blob.
onopen(event: WebSocketEvent) => voidOui—
onmessage(event: WebSocketEvent) => voidOui—
onerror(event: WebSocketEvent) => voidOui—
onclose(event: WebSocketEvent) => voidOui—
addEventListener(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void) => voidOui—
removeEventListener(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void) => voidOui—
send(data: string | ArrayBuffer | ArrayBufferView) => voidOui—
close(code?: number, reason?: string) => voidOui—
onopen — signatures de méthode

Signatures

ts
(event: WebSocketEvent): void

Paramètres

NomTypeRequisDescription
eventWebSocketEventOui—

Retourne

void

onmessage — signatures de méthode

Signatures

ts
(event: WebSocketEvent): void

Paramètres

NomTypeRequisDescription
eventWebSocketEventOui—

Retourne

void

onerror — signatures de méthode

Signatures

ts
(event: WebSocketEvent): void

Paramètres

NomTypeRequisDescription
eventWebSocketEventOui—

Retourne

void

onclose — signatures de méthode

Signatures

ts
(event: WebSocketEvent): void

Paramètres

NomTypeRequisDescription
eventWebSocketEventOui—

Retourne

void

addEventListener — signatures de méthode

Signatures

ts
(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void): void

Paramètres

NomTypeRequisDescription
type"close" | "open" | "error" | "message"Oui—
listener(event: WebSocketEvent) => voidOui—

Retourne

void

removeEventListener — signatures de méthode

Signatures

ts
(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void): void

Paramètres

NomTypeRequisDescription
type"close" | "open" | "error" | "message"Oui—
listener(event: WebSocketEvent) => voidOui—

Retourne

void

send — signatures de méthode

Signatures

ts
(data: string | ArrayBuffer | ArrayBufferView): void

Paramètres

NomTypeRequisDescription
datastring | ArrayBuffer | ArrayBufferView<ArrayBufferLike>Oui—

Retourne

void

close — signatures de méthode

Signatures

ts
(code?: number, reason?: string): void

Paramètres

NomTypeRequisDescription
codenumberNon—
reasonstringNon—

Retourne

void

Généré depuis les déclarations TypeScript publiques : signatures, props et valeurs par défaut viennent de la source vérifiée, les descriptions de sa JSDoc. Aucune valeur par défaut n'est inventée.