Skip to content

Conversation

@BYK
Copy link
Member

@BYK BYK commented Dec 31, 2025

Before submitting a pull request, please take a look at our
Contributing guidelines and verify:

  • If you've added code that should be tested, please add tests.
  • Ensure your code lints and the test suite passes (yarn lint) & (yarn test).
  • Link an issue if there is one related to your pull request. If no issue is linked, one will be auto-generated and linked.

Closes #issue_link_here

This PR documents key learnings and best practices for E2E testing within the Sentry JavaScript SDKs, focusing on common pitfalls and setup requirements.

Why these changes?
To improve the developer experience for E2E testing by providing clear guidance on Verdaccio setup, the critical .npmrc file, bundler-specific behaviors, and debugging strategies, thereby reducing common issues and debugging time.

What was changed?

  • CONTRIBUTING.md: Added a new section "Running E2E Tests Locally" with prerequisites, step-by-step instructions, and troubleshooting.
  • CLAUDE.md & .cursor/rules/sdk_development.mdc: Added an "E2E Testing" section under "Development Guidelines," explaining Verdaccio, .npmrc requirements, how to run single tests, and common pitfalls.
  • dev-packages/e2e-tests/README.md: Expanded existing documentation with detailed .npmrc explanations, a comprehensive troubleshooting guide, and notes on bundler-specific environment variable handling (Webpack, Vite, Next.js) and import.meta.env behavior.

Open in Cursor Open in Web

Closes #18651 (added automatically)

@cursor
Copy link

cursor bot commented Dec 31, 2025

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

Co-authored-by: burak.kaya <burak.kaya@sentry.io>
@cursor cursor bot force-pushed the cursor/e2e-testing-documentation-updates-9b87 branch from f866733 to 36807c8 Compare December 31, 2025 21:34
@BYK BYK marked this pull request as ready for review January 1, 2026 07:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

E2E testing documentation updates

3 participants