All Topics
All Topics
Technology
Technology
AI
AI
Business
Business
Entertainment
Entertainment
News
News
Programming
Programming
Security
Security
Science
Science
Design
Design
Environment
Environment
Finance
Finance
Crypto
Crypto
Politics
Politics
Sports
Sports
Education
Education
Gaming
Gaming
Art
Art
Music
Music
Health
Health
Books
Books
Food
Food
Travel
Travel
Personal
Personal
Bluesky
Twitter

Workers - WebSocket binary messages now delivered as Blob by default

2mo ago

Source

CloudflareWorkers - WebSocket binary messages now delivered as Blob by defaultcloudflare.com
Snippet from the RSS feed
Binary frames received on a WebSocket are now delivered to the message event as Blob objects by default. This matches the WebSocket specification and standard browser behavior. Previously, binary frames were always delivered as ArrayBuffer . The binaryType property on WebSocket controls the delivery type on a per-WebSocket basis. This change has been active for Workers with compatibility dates on or after 2026-03-17 , via the websocket_standard_binary_type compatibility flag. We should have documented this change when it shipped but didn't. We're sorry for the trouble that caused. If your Worker handles binary WebSocket messages and assumes event.data is an ArrayBuffer , the frames will arrive as Blob instead, and a naive instanceof ArrayBuffer check will silently drop every frame. To opt back into ArrayBuffer delivery, assign binaryType before calling accept() . This works regardless of the compatibility flag: const resp = await fetch ( " , { headers : { Upgrade : "websocket" }, } ) ; const ws = resp . webSocket ; // Opt back into ArrayBuffer delivery for this WebSocket. ws . binaryType = "arraybuffer" ; ws . accept () ; ws . addEventListener ( "message" , ( event ) => { if ( typeof event . data === "string" ) { // Text frame. } else { // event.data is an ArrayBuffer because we set binaryType above. } } ) ; If you are not ready to migrate and want to keep ArrayBuffer as the default for all WebSockets in your Worker, add the no_websocket_standard_binary_type flag to your Wrangler configuration file . This change has no effect on the Durable Object hibernatable WebSocket webSocketMessage handler, which continues to receive binary data as ArrayBuffer . For more information, refer to WebSockets binary messages .

You might also wanna read

Comments

Sign in to join the conversation.

No comments yet. Be the first.