Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

WebSocket.binaryType

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 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