next-rsc-error-handler

next-rsc-error-handler

Webpack plugin that allow to handle RSC errors on the server side.

This plugin requires all the client components to be marked with 'use client;'

Get started

• Install the dependency npm i next-rsc-error-handler
• In your next config add the plugin:

import { rscErrorHandler } from "next-rsc-error-handler";

const withRscErrorHandler = rscErrorHandler({
  componentName: /^_?[A-Z]/, // optional, defaults to /^[A-Z]/
});

export default withRscErrorHandler({
  // next config here
});

• Add global-server-error.js in your root folder with following content:

/** @type {import('next-rsc-error-handler').GlobalServerError} */
export default function onGlobalServerError(err, ctx) {
  // handling here
}

Alternatively, you can use global-server-error.ts with:

import { type GlobalServerErrorContext } from 'next-rsc-error-handler';

export default function onGlobalServerError(err: unknown, ctx: GlobalServerErrorContext) {
  // handling here
}

License

Apache-2.0