Skip to content

Files

Latest commit

sampajanosampajano
Jun 10, 2025
70f2b59 · Jun 10, 2025

History

History
38 lines (24 loc) · 2.05 KB

streaming-roadmap.md

File metadata and controls

38 lines (24 loc) · 2.05 KB

Streaming Roadmap

This document describes the road-map for gRPC-Web to support different streaming features.

  • Server-streaming
  • Client-streaming and half-duplex streaming

Server-streaming

We will keep improving server-streaming in the following areas:

  • Fetch cancellation support - 2024
  • Performance improvements and whatwg Fetch/streams support, including service workers - 2024
  • Finalizing keep-alive support (via Envoy) - 2024+
  • Addressing runtime behavior gaps between Fetch and XHR - 2024+

Client-streaming and half-duplex streaming

We don’t plan to support client-streaming via Fetch/upload-streams (See Appendix on backgrounds on the Chrome Origin Trial). As a result, half-duplex bidi streaming won’t be supported via Fetch/streams either.

Client-streaming and half-duplex bidi streaming will be addressed when Full-duplex streaming is supported via WebTransport (see below).

Full-duplex streaming

Not planned.

Issues with WebSockets

We have no plan to support full-duplex streaming over WebSockets (over TCP or HTTP/2). We will not publish any experimental spec for gRPC over WebSockets either.

The main issue with WebSockets is its incompatibility with HTTP, i.e. the ubiquitous Web infrastructure. This means HTTP fallback is always needed. Recent IETF proposal to tunnel WebSockets over HTTP/2 is not widely implemented either.

Appendix

Chrome Origin Trial on upload-streaming

We worked on a Chrome Origin Trial to finalize the fetch/upload stream API spec (whatwg). One of the pending issues that blocks the final spec is to decide whether it is safe to enable upload-streaming over HTTP/1.1. We believe that upload-streaming should be enabled for both HTTP/2 and HTTP/1.1. Specifically for gRPC-Web, the server can't control the client deployment. As a result, if upload-streaming is only enabled over HTTP/2, a gRPC service will have to implement a non-streaming method as a fallback for each client-streaming method.