Drop-in fetch() replacement for Node.js, powered by Chromium's Cronet networking stack.

Get HTTP/2, HTTP/3 (QUIC), and Brotli compression out of the box. Falls back to globalThis.fetch on unsupported platforms.

npm install cronet-fetch

Platform-specific native binaries are installed automatically via optionalDependencies.

Supported platforms:

On unsupported platforms, cronet-fetch transparently falls back to Node's built-in fetch.

import { fetch, Request, Headers } from "cronet-fetch";

const res = await fetch("https://example.com");
const text = await res.text();

import { fetch, initEngine } from "cronet-fetch";

initEngine({
  enableQuic: true,
  enableHttp2: true,
  enableBrotli: true,
  userAgent: "my-app/1.0",
});

const res = await fetch("https://example.com");

const res = await fetch("https://example.com", {
  proxy: "http://proxy:8080",
});

import { usingCronet } from "cronet-fetch";

if (usingCronet) {
  console.log("Using Chromium Cronet (HTTP/3, QUIC, Brotli)");
} else {
  console.log("Falling back to native fetch");
}

When Cronet binaries aren't available, a warning is logged. Suppress it with:

CRONET_FETCH_SILENT=1 node app.js

cronet-fetch          TypeScript Fetch API (drop-in replacement)
  └─ cronet-node      Node.js native addon (napi-rs)
       └─ cronet      Safe Rust wrapper
            └─ cronet-sys   Raw FFI bindings (bindgen)
                 └─ libcronet.{so,dylib}   Chromium Cronet shared library

• Rust (stable)
• Node.js >= 18
• For Cronet itself: Chromium build toolchain (~100GB disk, 30-60 min build)

# Place libcronet in the expected location:
#   packages/cronet-sys/lib/Darwin-arm64/libcronet.dylib   (macOS ARM64)
#   packages/cronet-sys/lib/Linux-x86_64/libcronet.so      (Linux x64)

cargo build -p cronet-node --release

# Build TypeScript
cd packages/cronet-fetch && npm install && npm run build

# macOS
./scripts/fetch-and-build.sh

# Linux (Docker)
./scripts/build-cronet-linux.sh
docker build --platform linux/amd64 -f docker/Dockerfile.cronet-node-linux -t cronet-node-linux .

See scripts/ for more build options.

MIT