Umbraco E2e Testing

Umbraco E2E Testing

End-to-end testing for Umbraco backoffice extensions using Playwright and @umbraco-cms/acceptance-test-helpers. This approach tests against a real running Umbraco instance, validating complete user workflows.

Critical: Use Testhelpers for Core Umbraco

Use @umbraco-cms/acceptance-test-helpers for core Umbraco operations:

Package	Purpose	Why Required
@umbraco-cms/acceptance-test-helpers	UI and API helpers	Handles auth, navigation, core entity CRUD
@umbraco/json-models-builders	Test data builders	Creates valid Umbraco entities with correct structure

Why use testhelpers for core Umbraco?

• Umbraco uses data-mark instead of data-testid - testhelpers handle this
• Auth token management is complex - testhelpers manage STORAGE_STAGE_PATH
• API setup/teardown requires specific payload formats - builders ensure correctness
• Selectors change between versions - testhelpers abstract these away

// WRONG - Raw Playwright for core Umbraco (brittle)
await page.goto('/umbraco');
await page.fill('[name="email"]', 'admin@example.com');