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: Dieses Feature ist verfügbar in Web Workers.

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

js
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