umbraco-e2e-testing
Installation
SKILL.md
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-markinstead ofdata-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