WebSocket: send() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebSocket.send()-Methode stellt die angegebenen Daten in die Warteschlange, um sie über die WebSocket-Verbindung an den Server zu übertragen. Dabei wird der Wert von bufferedAmount um die Anzahl der Bytes erhöht, die zum Speichern der Daten erforderlich sind. Falls die Daten nicht gesendet werden können (zum Beispiel, weil sie zwischengespeichert werden müssen, der Puffer jedoch voll ist), wird der Socket automatisch geschlossen. Der Browser wirft eine Ausnahme, wenn Sie send() aufrufen, während die Verbindung im CONNECTING-Zustand ist. Rufen Sie send() auf, während die Verbindung im CLOSING- oder CLOSED-Zustand ist, werden die Daten vom Browser stillschweigend verworfen.

Syntax

send(data)

Parameter

data

Die Daten, die an den Server gesendet werden sollen. Diese können einen der folgenden Typen haben:

string: Ein Text-String. Der String wird im UTF-8-Format in den Puffer aufgenommen und der Wert von bufferedAmount wird um die Anzahl der Bytes erhöht, die für die Darstellung des UTF-8-Strings erforderlich sind.
ArrayBuffer: Sie können die zugrunde liegenden Binärdaten eines typisierten Array-Objekts senden; seine Binärdateninhalte werden in die Warteschlange im Puffer gestellt, wodurch der Wert von bufferedAmount um die erforderliche Anzahl von Bytes erhöht wird.
Blob: Wenn Sie ein Blob angeben, werden die Rohdaten des Blobs zur Übertragung in einem binären Frame in die Warteschlange gestellt (der Blob.type wird ignoriert). Der Wert von bufferedAmount wird um die Byte-Größe dieser Rohdaten erhöht.
TypedArray oder ein DataView: Sie können jedes JavaScript Typed Array Objekt als Binär-Frame senden; seine Binärdateninhalte werden in die Warteschlange im Puffer gestellt, wobei der Wert von bufferedAmount um die erforderliche Anzahl von Bytes erhöht wird.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidStateError DOMException: Ausgelöst, wenn WebSocket.readyState CONNECTING ist.

Spezifikationen

Specification
WebSockets Standard # ref-for-dom-websocket-send①

Browser-Kompatibilität

BCD tables only load in the browser