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 reiht die angegebenen Daten zur Übertragung an den Server über die WebSocket-Verbindung ein und erhöht den Wert von bufferedAmount um die Anzahl der Bytes, die benötigt werden, um die Daten zu enthalten. Wenn die Daten nicht gesendet werden können (zum Beispiel, weil sie zwischengespeichert werden müssen, aber der Puffer voll ist), wird der Socket automatisch geschlossen. Der Browser löst eine Ausnahme aus, wenn Sie send() aufrufen, während die Verbindung im CONNECTING-Status ist. Wenn Sie send() aufrufen, während die Verbindung im CLOSING- oder CLOSED-Status ist, verwirft der Browser die Daten ohne Benachrichtigung.

Syntax

send(data)

Parameter

data

Die Daten, die an den Server gesendet werden sollen. Sie können einer der folgenden Typen sein:

string: Ein Textstring. 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 zur Darstellung des UTF-8-Strings benötigt werden.
ArrayBuffer: Sie können die zugrunde liegenden Binärdaten, die von einem typisierten Array-Objekt verwendet werden, senden; seine Binärdateninhalte werden in den Puffer eingereiht und erhöhen den Wert von bufferedAmount um die erforderliche Anzahl an Bytes.
Blob: Wenn Sie ein Blob angeben, wird die rohe Daten des Blobs in einem Binärrahmen zur Übertragung eingereiht (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 beliebige JavaScript typisierte Array-Objekt als Binärrahmen senden; seine Binärdateninhalte werden in den Puffer eingereiht, 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 # ref-for-dom-websocket-send①