WebSocketsがCloseフレームに自動的に応答するようになりました

2026年4月7日 | Workers

Workersランタイムは、ピアからCloseフレームを受信した際に、自動的に相互のCloseフレームを送信するようになりました。readyStateは、closeイベントが発火する前にCLOSEDに遷移します。これはWebSocket仕様および標準的なブラウザの動作と一致します。

この変更は、2026-04-07以降の互換性日付を使用するWorkers（web_socket_auto_reply_to_close互換性フラグ経由）でデフォルトで有効になります。

closeイベントハンドラー内で手動でclose()を呼び出す既存のコードは引き続き動作します。WebSocketが既に閉じられている場合、その呼び出しは静かに無視されます。

const [client, server] = Object.values(new WebSocketPair());
server.accept();

server.addEventListener("close", (event) => {
  // readyStateは既にCLOSED — server.close()を呼び出す必要はありません。
  console.log(server.readyState); // WebSocket.CLOSED
  console.log(event.code); // 1000
  console.log(event.wasClean); // true
});

WebSocketプロキシのためのハーフオープンモード

自動クローズ動作は、Workerがクライアントとバックエンドの間に位置し、両側のクローズを独立して調整する必要があるWebSocketプロキシの動作を妨げる可能性があります。このユースケースをサポートするため、accept()に{ allowHalfOpen: true }を渡してください：

const [client, server] = Object.values(new WebSocketPair());
server.accept({ allowHalfOpen: true });

server.addEventListener("close", (event) => {
  // readyStateはここではまだCLOSINGで、他方の側で
  // クローズを調整する時間を与えます。
  console.log(server.readyState); // WebSocket.CLOSING
  
  // 準備ができたら手動でクローズします。
  server.close(event.code, "done");
});

詳細については、WebSockets Close behaviorを参照してください。