WebSocket.binaryType

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.

La propriété WebSocket.binaryType contrôle le type de données binaires reçues via la connexion WebSocket.

Syntaxe

js
var binaryType = aWebSocket.binaryType;

Valeur

Une chaîne de caractères DOMString ayant l'une de ces deux valeurs :

"blob"

Utilise des objets Blob pour les données binaires. Il s'agit de la valeur par défaut.

"arraybuffer"

Utilise des objets ArrayBuffer pour les données binaires.

Exemples

js
// On crée une connexion WebSocket connection.
const socket = new WebSocket("ws://localhost:8080");
// On change le type de données binaires de "blob" à "arraybuffer"
socket.binaryType = "arraybuffer";

// On écoute les différents messages
socket.addEventListener("message", function (event) {
  if (event.data instanceof ArrayBuffer) {
    // Frame de données binaires
    const view = new DataView(event.data);
    console.log(view.getInt32(0));
  } else {
    // Frame textuelle
    console.log(event.data);
  }
});

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser