Skip to main content

Choosing a protocol

In addition to the Connect protocol, @connectrpc/connect-web ships with support for the gRPC-web protocol. If your backend does not support the Connect protocol, you can still use Connect clients to interface with it.

Connect​

The function createConnectTransport() creates a transport for the Connect protocol. It uses the fetch API for the actual network operations, which is widely supported in web browsers. The most important options for the Connect transport are as follows:

import { createConnectTransport } from "@connectrpc/connect-web";

const transport = createConnectTransport({
  // Requests will be made to <baseUrl>/<package>.<service>/method
  baseUrl: "https://demo.connectrpc.com",

  // By default, this transport uses the JSON format.
  // Set this option to true to use the binary format.
  useBinaryFormat: false,

  // Controls what the fetch client will do with credentials, such as
  // Cookies. The default value is "same-origin", which will not
  // transmit Cookies in cross-origin requests.
  credentials: "same-origin",

  // Interceptors apply to all calls running through this transport.
  interceptors: [],

  // By default, all requests use POST. Set this option to true to use GET
  // for side-effect free RPCs.
  useGet: false,
});

We generally recommend the JSON format for web browsers, because it makes it trivial to follow what exactly is sent over the wire with the browser's network inspector.

Connect supports optionally using HTTP GET requests for side-effect free RPC calls, to enable easy use of request caching and more. For more information on HTTP GET requests, see Get Requests.

gRPC-web​

The function createGrpcWebTransport() creates a Transport for the gRPC-web protocol. Any gRPC service can be made available to gRPC-web with the Envoy Proxy. ASP.NET Core supports gRPC-web with a middleware. Connect for Node and connect-go support gRCP-web out of the box.

import { createGrpcWebTransport } from "@connectrpc/connect-web";

const transport = createGrpcWebTransport({
  // Requests will be made to <baseUrl>/<package>.<service>/method
  baseUrl: "https://demo.connectrpc.com",

  // By default, this transport uses the binary format, because
  // not all gRPC-web implementations support JSON.
  useBinaryFormat: true,

  // Controls what the fetch client will do with credentials, such as
  // Cookies. The default value is "same-origin", which will not
  // transmit Cookies in cross-origin requests.
  credentials: "include",

  // Interceptors apply to all calls running through this transport.
  interceptors: [],
});