umbraco-playwright-testhelpers

Provide Playwright fixtures and helpers for Umbraco backoffice E2E testing.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-playwright-testhelpers-albanistrefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-playwright-testhelpers
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/testing/umbraco-playwright-testhelpers
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-playwright-testhelpers-albanistrefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Umbraco E2E tests often become slow and brittle because teams need to repeatedly handle Playwright setup, authentication, fixture data creation, UI navigation, and consistent selectors across many test cases.

Core Features & Use Cases

  • Playwright fixtures for agents: Provides an extended test with umbracoApi and umbracoUi fixtures so tests can set up and verify state consistently.
  • API helpers for fast setup/teardown: Supplies ApiHelpers with entity-specific sub-helpers for content, document types, data types, media, templates, users, translations, webhooks, and more.
  • UI helpers for realistic backoffice flows: Enables robust navigation and interactions (tree operations, editors, clicking, notifications, file upload, and drag-and-drop) using helper methods and constants.
  • Constants for stable selectors/actions: Offers ConstantHelper mappings for common sections, actions, and button label keys to reduce selector drift.

Quick Start

Use the umbraco-playwright-testhelpers skill to set up a Playwright test that creates required Umbraco entities via umbracoApi, then verifies the UI using umbracoUi against your backoffice instance.

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 reliable Playwright E2E tests for an Umbraco backoffice?

Playwright E2E tests for an Umbraco backoffice require consistent authentication, deterministic content setup via API helpers, and reusable UI selectors. Using extended test fixtures with umbracoApi and umbracoUi allows tests to set up and verify state without brittleness.

What is the best way to automate Umbraco content setup and teardown in Playwright?

Automating Umbraco content setup and teardown uses API helpers to manage entities like document types, media, and users directly. This bypasses slow UI interactions, ensuring fast and deterministic test state preparation and cleanup for your workflows.

How do I prevent selector drift when navigating the Umbraco backoffice in automated tests?

Preventing selector drift during Umbraco backoffice navigation relies on a ConstantHelper that maps common sections, actions, and button label keys. Using these stable constants for UI helper interactions reduces test breakage from frequent interface updates.

Can I use Playwright fixtures to handle authentication for Umbraco test scenarios?

Playwright fixtures can handle consistent authentication for Umbraco test scenarios by providing an extended test fixture. This setup injects umbracoApi and umbracoUi helpers automatically, ensuring reliable login and state management across content and settings workflows.

Does this testing approach support drag-and-drop and file uploads in the Umbraco UI?

This testing approach supports drag-and-drop and file uploads in the Umbraco UI through dedicated UI helpers. These helpers enable robust backoffice interactions, including tree operations, editor navigation, clicking, and notification handling for realistic test flows.

Why do my Umbraco E2E tests become slow and brittle across multiple test cases?

Umbraco E2E tests become slow and brittle when teams repeatedly handle Playwright setup, fixture data creation, and UI navigation manually. Using API helpers for fast setup and reusable selectors for UI navigation eliminates this overhead and stabilizes test execution.