Verwendung

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 }) => {};

Konstruktoren

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

Parameter

NameTypErforderlichBeschreibung
urlstring | URLJa—
protocolsstring | string[]Nein—

Rückgabe

WebSocket

Eigenschaften und Methoden 19

NameTypErforderlichBeschreibung
prototypeschreibgeschütztWebSocketJa—
CONNECTINGschreibgeschützt0Ja—
OPENschreibgeschützt1Ja—
CLOSINGschreibgeschützt2Ja—
CLOSEDschreibgeschützt3Ja—
urlschreibgeschütztstringJa—
readyStateschreibgeschützt0 | 2 | 1 | 3Ja—
protocolschreibgeschütztstringJaThe subprotocol the server chose, once open.
bufferedAmountschreibgeschütztnumberJaAlways 0: bytes are not counted on their way out.
extensionsschreibgeschütztstringJa—
binaryType"arraybuffer"JaOnly 'arraybuffer': there is no Blob.
onopen(event: WebSocketEvent) => voidJa—
onmessage(event: WebSocketEvent) => voidJa—
onerror(event: WebSocketEvent) => voidJa—
onclose(event: WebSocketEvent) => voidJa—
addEventListener(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void) => voidJa—
removeEventListener(type: WebSocketEvent["type"], listener: (event: WebSocketEvent) => void) => voidJa—
send(data: string | ArrayBuffer | ArrayBufferView) => voidJa—
close(code?: number, reason?: string) => voidJa—
onopen — Methodensignaturen

Signaturen

ts
(event: WebSocketEvent): void

Parameter

NameTypErforderlichBeschreibung
eventWebSocketEventJa—

Rückgabe

void

onmessage — Methodensignaturen

Signaturen

ts
(event: WebSocketEvent): void

Parameter

NameTypErforderlichBeschreibung
eventWebSocketEventJa—

Rückgabe

void

onerror — Methodensignaturen

Signaturen

ts
(event: WebSocketEvent): void

Parameter

NameTypErforderlichBeschreibung
eventWebSocketEventJa—

Rückgabe

void

onclose — Methodensignaturen

Signaturen

ts
(event: WebSocketEvent): void

Parameter

NameTypErforderlichBeschreibung
eventWebSocketEventJa—

Rückgabe

void

addEventListener — Methodensignaturen

Signaturen

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

Parameter

NameTypErforderlichBeschreibung
type"close" | "open" | "error" | "message"Ja—
listener(event: WebSocketEvent) => voidJa—

Rückgabe

void

removeEventListener — Methodensignaturen

Signaturen

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

Parameter

NameTypErforderlichBeschreibung
type"close" | "open" | "error" | "message"Ja—
listener(event: WebSocketEvent) => voidJa—

Rückgabe

void

send — Methodensignaturen

Signaturen

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

Parameter

NameTypErforderlichBeschreibung
datastring | ArrayBuffer | ArrayBufferView<ArrayBufferLike>Ja—

Rückgabe

void

close — Methodensignaturen

Signaturen

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

Parameter

NameTypErforderlichBeschreibung
codenumberNein—
reasonstringNein—

Rückgabe

void

Generiert aus den öffentlichen TypeScript-Deklarationen: Signaturen, Props und Standardwerte stammen aus der geprüften Quelle, Beschreibungen aus deren JSDoc. Kein Standardwert ist erfunden.