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 : propriété 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.

Note : Cette fonctionnalité est disponible via les Web Workers.

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

Valeur

Une chaîne de caractères :

"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", (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