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
# ref-for-dom-websocket-binarytype①

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
binaryType

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support