✨ NextJS- add nextjs error boundary component by BeltranBulbarellaDD · Pull Request #4352 · DataDog/browser-sdk

BeltranBulbarellaDD · 2026-03-17T15:27:58Z

Motivation

Adds React error boundary to NextJS pages router.

Changes

Adds ErrorBoundary — a React error boundary component that wraps createErrorBoundary from @datadog/browser-rum-react, pre-wired to call addNextjsError.

Exports ErrorBoundaryFallback and ErrorBoundaryProps types alongside it.

Also adds @datadog/browser-rum-react as an optional peer dependency of rum-nextjs, and allows @datadog/browser-rum-react/internal through the disallow-side-effects ESLint rule.

Test instructions

Test app — new pages for both routers to exercise all error paths:

Scenario	Implementation
Pages Router client error	ErrorBoundary in `pages-router/error-test.tsx`
App Router client error	`error.tsx` segment boundary calling `addNextjsError`
App Router server error (with digest)	Server component throw → `error.tsx` calling `addNextjsError`
App Router global error	Root-level throw → `global-error.tsx` calling `addNextjsError`

Checklist

Tested locally
Tested on staging
Added unit tests for this change.
Added e2e/integration tests for this change.
Updated documentation and/or relevant AGENTS.md file

datadog-official · 2026-03-17T15:31:11Z

✅ Tests

🎉 All green!

❄️ No new flaky tests detected
🧪 All tests passed

🎯 Code Coverage (details)
• Patch Coverage: 100.00%
• Overall Coverage: 77.24% (-0.01%)

_{This comment will be updated automatically if new data arrives.

🔗 Commit SHA: 6d7f023 | Docs | Datadog PR Page | Was this helpful? React with 👍/👎 or give us feedback!}

cit-pr-commenter-54b7da · 2026-03-17T15:32:26Z

Bundles Sizes Evolution

📦 Bundle Name	Base Size	Local Size	𝚫%	Status
Rum	175.02 KiB	175.02 KiB	0.00%	✅
Rum Profiler	6.16 KiB	6.16 KiB	0.00%	✅
Rum Recorder	27.46 KiB	27.46 KiB	0.00%	✅
Logs	56.80 KiB	56.80 KiB	0.00%	✅
Rum Slim	130.66 KiB	130.66 KiB	0.00%	✅
Worker	23.63 KiB	23.63 KiB	0.00%	✅

🚀 CPU Performance

Pending...

🧠 Memory Performance

Pending...

🔗 RealWorld

BeltranBulbarellaDD · 2026-03-17T16:08:59Z

packages/rum-nextjs/src/domain/error/errorBoundary.spec.tsx

Since all these tests are the same for rum-react (except for the last one) should I remove them?

BeltranBulbarellaDD · 2026-03-17T16:09:57Z

package.json

    "build:docs:json": "typedoc --logLevel Verbose --json ./docs.json",
    "build:docs:html": "typedoc --out ./docs",
-    "pack": "yarn workspaces foreach --all --parallel --include '@datadog/*' exec yarn pack",
+    "pack": "yarn workspaces foreach --all --parallel --topological --include '@datadog/*' exec yarn pack",


This is required because rum-nextjs needs rum-react

I'm not sure about this... rum depends on rum-code which depends on core and that was not an issue before.

BeltranBulbarellaDD · 2026-03-17T16:21:24Z

test/e2e/playwright.base.config.ts

      stdout: 'pipe' as const,
      cwd: path.join(__dirname, '../apps/nextjs'),
-      command: isLocal ? 'yarn dev' : 'yarn start',
+      command: 'yarn start',


This is for 2 reasons:

So that StrictMode does not double-fires in dev mode.

The dev error overlay does not appear (ex)

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6d7f0239ab

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-03-18T20:06:29Z

packages/rum-nextjs/src/entries/main.ts

 export { DatadogAppRouter } from '../domain/nextJSRouter/datadogAppRouter'
 export { DatadogPagesRouter } from '../domain/nextJSRouter/datadogPagesRouter'
 export { addNextjsError } from '../domain/error/addNextjsError'
+export { ErrorBoundary } from '../domain/error/errorBoundary'


Avoid forcing rum-react on every rum-nextjs import

Re-exporting ErrorBoundary from the root entrypoint makes @datadog/browser-rum-react/internal a hard runtime dependency for all consumers, because both CJS and ESM need to resolve ../domain/error/errorBoundary when @datadog/browser-rum-nextjs is imported. That breaks existing integrations that only use DatadogAppRouter/addNextjsError and rely on @datadog/browser-rum-react being optional (as declared in peerDependenciesMeta), resulting in module-resolution failures unless they install rum-react.

Useful? React with 👍 / 👎.

BenoitZugmeyer · 2026-03-18T20:06:50Z

package.json

    "build:docs:json": "typedoc --logLevel Verbose --json ./docs.json",
    "build:docs:html": "typedoc --out ./docs",
-    "pack": "yarn workspaces foreach --all --parallel --include '@datadog/*' exec yarn pack",
+    "pack": "yarn workspaces foreach --all --parallel --topological --include '@datadog/*' exec yarn pack",


I'm not sure about this... rum depends on rum-code which depends on core and that was not an issue before.

BenoitZugmeyer · 2026-03-18T20:09:38Z

test/e2e/scenario/nextjsPlugin.scenario.ts

+            expect(customErrors[0].context).toMatchObject({
+              framework: 'nextjs',
+              nextjs: { digest: expect.any(String) },
+            })


suggestion:

expect(errorEvent.error.component_stack).toBeDefined()

BenoitZugmeyer · 2026-03-18T20:11:27Z

packages/rum-react/internal.d.ts

suggestion: this should not be needed. During development, the path points to the correct source, and for production builds the package.json is pointing to the right .d.ts file

BenoitZugmeyer · 2026-03-18T20:18:31Z

packages/rum-nextjs/package.json

    "@datadog/browser-rum-core": "6.31.0"
  },
  "peerDependencies": {
+    "@datadog/browser-rum-react": "6.31.0",


suggestion: @datadog/browser-rum-react should be a direct dependencies, not a peer dep or a dev dep. Customers should not need to install the react integration themselves

thomas-lebeau · 2026-03-19T08:35:03Z

.claude/skills/datadog-sdk-event-inspection/SKILL.md

sounds like this as nothing to with this PR

BeltranBulbarellaDD added 2 commits March 17, 2026 15:26

Add error boundary to Rum-Nextjs

fda52cb

Add e2e tests

48f6769

BeltranBulbarellaDD added 2 commits March 17, 2026 16:42

Disallow side effect from React, CI fixes

3cf211b

fix rum-react version

e0d3dee

BeltranBulbarellaDD commented Mar 17, 2026

View reviewed changes

Remove import

cd405c3

BeltranBulbarellaDD changed the title ~~Beltran.bulbarella/nextjs pages router error~~ ✨ NextJS- add nextjs error boundary component Mar 17, 2026

BeltranBulbarellaDD added 5 commits March 17, 2026 18:16

Add error boundary to Rum-Nextjs

f4aedea

build

676d170

add skill

bb905f7

Fix tests

c7e7ca7

format

6d7f023

BeltranBulbarellaDD marked this pull request as ready for review March 18, 2026 20:01

BeltranBulbarellaDD requested a review from a team as a code owner March 18, 2026 20:01

chatgpt-codex-connector bot reviewed Mar 18, 2026

View reviewed changes

BenoitZugmeyer reviewed Mar 18, 2026

View reviewed changes

thomas-lebeau reviewed Mar 19, 2026

View reviewed changes

.claude/skills/datadog-sdk-event-inspection/SKILL.md

Copy link

Collaborator

thomas-lebeau Mar 19, 2026 •

edited

Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sounds like this as nothing to with this PR

Conversation

BeltranBulbarellaDD commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Motivation

Changes

Test instructions

Checklist

Uh oh!

datadog-official bot commented Mar 17, 2026 • edited by datadog-datadog-prod-us1-2 bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cit-pr-commenter-54b7da bot commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundles Sizes Evolution

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

thomas-lebeau Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

BeltranBulbarellaDD commented Mar 17, 2026 •

edited

Loading

datadog-official bot commented Mar 17, 2026 •

edited by datadog-datadog-prod-us1-2 bot

Loading

cit-pr-commenter-54b7da bot commented Mar 17, 2026 •

edited

Loading

thomas-lebeau Mar 19, 2026 •

edited

Loading