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.

WebSocket.binaryType プロパティは、この WebSocke 接続によって受信されているバイナリーデータの型を制御します。

値

文字列です。

"blob"

バイナリーデータに Blob オブジェクトを使用します。これが既定値です。

"arraybuffer"

バイナリーデータに ArrayBuffer オブジェクトを使用します。

例

js
// WebSocket 接続を作成
const socket = new WebSocket("ws://localhost:8080");

// バイナリーの型を "blob" から "arraybuffer" に変更
socket.binaryType = "arraybuffer";

// メッセージを待ち受け
socket.addEventListener("message", (event) => {
  if (event.data instanceof ArrayBuffer) {
    // バイナリーフレーム
    const view = new DataView(event.data);
    console.log(view.getInt32(0));
  } else {
    // テキストフレーム
    console.log(event.data);
  }
});

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser