Errors and custom spans

The SDK captures uncaught errors. Report an error explicitly when your application catches it and you still need it in Interfere.

Browser errors

Choose your framework’s browser entry point:

import { capture } from "@interfere/next/instrument-client";

try {
  await saveDraft();
} catch (error) {
  capture(error);
  throw error;
}

import { capture } from "@interfere/vite/init";

try {
  await saveDraft();
} catch (error) {
  capture(error);
  throw error;
}

Here, saveDraft is your application’s operation. Keep its existing error handling after reporting the error.

Server errors

Import captureError from your framework’s server entry point:

Framework	Import
Next.js	`@interfere/next/server`
TanStack Start	`@interfere/vite/server`
NestJS	`@interfere/nest`
Node.js	`@interfere/node`

import { captureError } from "@interfere/node";

try {
  await fulfillOrder();
} catch (error) {
  captureError(error);
  throw error;
}

Custom spans

Wrap application work to record its duration and outcome. In the Next.js browser SDK, use span:

import { span } from "@interfere/next/instrument-client";

await span("checkout.submit", () => submitOrder());

In Node.js and NestJS, use withSpan:

import { withSpan } from "@interfere/node";

await withSpan("checkout.fulfill", () => fulfillOrder());

Next.js proxy

Wrap your existing proxy handler with withInterfereProxy. The wrapper reports thrown errors with request context and rethrows them.

proxy.ts

import { withInterfereProxy } from "@interfere/next/server";
import { NextResponse } from "next/server";

export default withInterfereProxy(() => NextResponse.next());

export const config = { matcher: ["/((?!_next/static).*)"] };

Replace NextResponse.next() with your existing proxy logic.

Next.js server actions

Wrap an action’s work with withInterfereServerAction to record its name and outcome. Its args option records argument types, not values. Thrown errors reach the onRequestError handler from your server instrumentation.

import { withInterfereServerAction } from "@interfere/next/server";

export async function validateEmail(formData: FormData) {
  "use server";
  return withInterfereServerAction(
    "validateEmail",
    () => {
      const email = formData.get("email");
      if (typeof email !== "string" || !email.includes("@")) {
        throw new Error("Enter a valid email address");
      }
      return email;
    },
    { args: [formData] },
  );
}

Getting started

Product

Settings

Compliance

SDKs

Developer tools

Errors and custom spans

Browser errors

Server errors

Custom spans

Next.js proxy

Next.js server actions

​Browser errors

​Server errors

​Custom spans

​Next.js proxy

​Next.js server actions

Browser errors

Server errors

Custom spans

Next.js proxy

Next.js server actions