Browser SDK

Error monitoring for Bun

A Bun-native package shipped as TypeScript source — Bun loads it directly, no build step. It hooks uncaught exceptions and unhandled rejections on the process.

Frameworks Bun runtimeRequires Bun 1.0+Package @errorgap/bunSource ↗Package ↗Agent guide ↗

On this page

Install
Configure
Trigger a test error
Verify

Install

bun add @errorgap/bun

Configure

In your entry file (e.g. index.ts):

import { Errorgap } from "@errorgap/bun";

Errorgap.init({
  endpoint:    process.env.ERRORGAP_ENDPOINT,
  projectSlug: process.env.ERRORGAP_PROJECT_SLUG,
  apiKey:      process.env.ERRORGAP_API_KEY,
  environment: process.env.NODE_ENV ?? "production",
});

init hooks process.uncaughtException and process.unhandledRejection.

Keep the key in an environment variable (or your framework's secret store) — never commit it to source control.

Trigger a test error

throw new Error("Errorgap test error");

Verify

Verify the connection

Confirm your key and endpoint reach errorgap before wiring anything else — send one event straight to the ingestion API:

bash

curl -sS -X POST "$ERRORGAP_ENDPOINT/api/projects/$ERRORGAP_PROJECT_SLUG/notices" \
  -H "content-type: application/json" \
  -H "x-errorgap-project-key: $ERRORGAP_API_KEY" \
  -d '{"errors":[{"type":"ErrorgapInstallTest","message":"Errorgap install verification"}]}'

A 201 with a group_id means ingestion works (202 = received but sampled; 401 = wrong key). Then trigger the test error above through the SDK. Your onboarding screen's Verify step checks the stack off automatically once the first event lands — it polls every three seconds.

Next: the full ingestion API, or browse every SDK.