umbraco-playwright-testhelpers

Provide Playwright fixtures and helpers for Umbraco backoffice end-to-end testing.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-playwright-testhelpers-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-playwright-testhelpers
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-playwright-testhelpers
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-playwright-testhelpers-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the repetitive boilerplate of setting up and driving Umbraco backoffice E2E tests by providing ready-made Playwright fixtures and helpers.

Core Features & Use Cases

  • Drop-in Playwright fixtures: Use shared fixtures to get an authenticated, configured API helper and a UI helper in your tests.
  • Programmatic backoffice operations: Create, fetch, publish, and clean up content, document types, data types, and media through API helpers.
  • UI navigation and editor interactions: Navigate sections, operate tree views, interact with buttons/menus/locators, and perform common editor workflows (including culture switching and uploads).
  • Stable constants and utilities: Reuse ConstantHelper for consistent selectors/action names and use Alias/JSON helpers for robust assertions and parsing.

Quick Start

Install the package and use its extended Playwright test to access umbracoApi and umbracoUi fixtures in a single E2E test file.

Frequently Asked Questions about umbraco-playwright-testhelpers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Playwright E2E tests for Umbraco backoffice automation?

To write Playwright E2E tests for Umbraco, use drop-in fixtures to get authenticated API and UI helpers. This streamlines navigating sections, creating content types, and asserting editor workflows without repetitive boilerplate.

Can I create Umbraco content and document types programmatically in E2E tests?

Yes, you can create, fetch, publish, and clean up Umbraco content, document types, data types, and media programmatically. API helpers execute CSRF-aware calls to perform automated setup and teardown workflows.

What is the best way to handle authenticated login and UI navigation in Umbraco testing?

The best way to handle authenticated login and UI navigation in Umbraco testing is using provided UI helpers and ConstantHelper. They manage stable selectors, tree views, and editor interactions like culture switching.

Does this testing approach support automated setup and teardown for Umbraco media?

Yes, this testing approach supports automated setup and teardown for Umbraco media. API helpers manage CRUD actions for media, while UI helpers handle uploads and editor interactions.

How do I parse JSON and manage assertions for Umbraco API responses in Playwright?

To parse JSON and manage assertions for Umbraco API responses in Playwright, use built-in JSON parsing utilities and Alias helpers. These ensure robust validation of API helper outputs during backoffice test execution.

Are there limitations when using Playwright fixtures for Umbraco backoffice workflows?

Limitations when using Playwright fixtures for Umbraco workflows include reliance on deterministic helper methods for CRUD actions and stable constants. Tests require consistent selectors and CSRF-aware API calls to function reliably.