e2e

E2E Test Runner Skill

This skill runs end-to-end tests for Sentry JavaScript SDK test applications. It ensures SDK packages are built before running tests.

Input

The user provides a test application name and optionally a variant:

• e2e-tests/test-applications/nextjs-app-dir (full path)
• nextjs-app-dir (just the app name)
• nextjs-app-dir --variant nextjs-15 (with variant)

Workflow

Step 1: Parse the Test Application Name

Extract the test app name from user input:

• Strip e2e-tests/test-applications/ prefix if present
• Extract variant flag if provided (e.g., --variant nextjs-15)
• Store the clean app name (e.g., nextjs-app-dir)

Step 2: Determine Which Packages Need Rebuilding

If the user recently edited files in packages/*, identify which packages were modified:

# Check which packages have uncommitted changes (including untracked files)
git status --porcelain | grep "^[ MARC?][ MD?] packages/" | cut -d'/' -f2 | sort -u

For each modified package, rebuild its tarball:

cd packages/<package-name>
yarn

Option C: User Specifies Packages

If the user says "I changed @sentry/node" or similar, rebuild just that package:

Step 3: Verify Test Application Exists

Check that the test app exists:

If it doesn't exist, list available test apps:

Ask the user which one they meant.

Step 4: Run the E2E Test

Navigate to the e2e-tests directory and run the test:

If a variant was specified:

Step 5: Report Results

After the test completes, provide a summary:

If tests passed:

If tests failed:

If package rebuild was needed:

Error Handling

• No tarballs found: Run yarn build && yarn build:tarball at repository root
• Test app not found: List available apps and ask user to clarify
• Packed tarballs missing: Run yarn build:tarball at the repo root, then yarn test:prepare in dev-packages/e2e-tests
• Build failures: Fix build errors before running tests

Common Test Applications

Here are frequently tested applications:

• nextjs-app-dir - Next.js App Router
• nextjs-15 - Next.js 15.x
• react-create-hash-router - React with React Router
• node-express-esm-loader - Node.js Express with ESM
• sveltekit-2 - SvelteKit 2.x
• remix-2 - Remix 2.x
• nuxt-3 - Nuxt 3.x

To see all available test apps:

Example Workflows

Example 1: After modifying @sentry/node

Example 2: First-time test run

Example 3: With variant

Tips

• Always rebuild after SDK changes: Tarballs contain the compiled SDK code
• Watch build output: Build errors must be fixed before testing

Integration with Development Workflow

This skill integrates with the standard SDK development workflow:

1. Make changes to SDK code in packages/*
2. Run /e2e <app-name> to test your changes
3. Fix any test failures

The skill automates the tedious parts of:

• Remembering to rebuild tarballs
• Navigating to the correct directory
• Running tests with the right flags