Skip to content

docs(sdk): Clarify strict mode for callback error isolation - #19967

Open
sentry-junior[bot] wants to merge 2 commits into
masterfrom
docs/hooks-strict-mode-wording
Open

sentry-junior[bot] wants to merge 2 commits into
masterfrom
docs/hooks-strict-mode-wording

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Rewords the strict mode paragraph in the hooks spec's callback error isolation section.

The old wording said SDKs MUST NOT pass the event reporting a propagated callback error through the callback that failed. That reads as if SDKs have to remember which callback failed and skip it for the follow-up event, for example the one an uncaught exception handler creates. That adds complexity and is risky, since skipping before_send could send data it was meant to strip. The intent was to avoid reporting loops.

The paragraph now says that directly: in strict mode the callback failure propagates, and SDKs MUST prevent error loops caused by a failing callback and an uncaught exception handler. Also bumps the spec to 1.1.1 with a changelog entry.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

via alexander.dinauer.

--

View Junior Session [Sentry]

sentry-junior Bot and others added 2 commits October 14, 2026 03:49
Co-Authored-By: Alexander Dinauer <alexander.dinauer@sentry.io>
Co-Authored-By: Alexander Dinauer <alexander.dinauer@sentry.io>
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
develop-docs Ready Ready Preview Oct 14, 2026 8:55am UTC
1 Skipped Deployment
Project Deployment Actions Updated
sentry-docs Ignored Ignored Oct 14, 2026 8:55am UTC

Request Review

@github-actions github-actions Bot added sdk-develop-docs PRs touching develop-docs/sdk Priority: Normal Docs review has no urgent deadline labels Oct 14, 2026
@cursor

cursor Bot commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

Rollouts skipped this pull request: Documentation-only change in an application repo (Markdown/MDX files that do not ship to a deployed site).

Mention @change-monitor in a comment to monitor it anyway.

This branch was successfully deployed

1 active deployment
Preview – develop-docs — 2311af64 Deployed Oct 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants