Umbraco Playwright Testhelpers

This is the official Playwright test helper package for Umbraco CMS, and it's genuinely well designed. You get two main fixtures: umbracoApi for fast backend setup via HTTP (content, document types, data types, media, users, the whole stack), and umbracoUi for clicking through the backoffice when you actually need to test the interface. The API helpers are idempotent with ensureNameNotExists patterns, so your tests clean up reliably. The UI helpers wrap Playwright locators with Umbraco-specific selectors like data-element attributes and section constants. If you're writing E2E tests for Umbraco extensions or custom implementations, this beats maintaining your own helper layer. It covers the repetitive stuff like CSRF tokens, tree navigation, and editor interactions.

skills.sh installs: 384
GitHub stars: 27
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add umbraco/umbraco-cms-backoffice-skills --skill umbraco-playwright-testhelpers --agent claude-code

Installs into .claude/skills of the current project.

Files

Umbraco Playwright Testhelpers

What is it?

@umbraco/playwright-testhelpers is the official Umbraco package that provides Playwright fixtures, API helpers, and UI helpers for writing E2E tests against an Umbraco backoffice instance.

Repository: https://github.com/umbraco/Umbraco.Playwright.Testhelpers

Installation

npm install @umbraco/playwright-testhelpers --save-dev

Related Skills

umbraco-e2e-testing - E2E test patterns using these helpers
umbraco-test-builders - JsonModels.Builders (used internally by testhelpers)
umbraco-testing - Master skill for testing overview

Package Exports

The package exports these main items:

import {
  test,              // Extended Playwright test with fixtures
  ApiHelpers,        // Direct API helper class
  UiHelpers,         // Direct UI helper class
  ConstantHelper,    // Constants for sections, actions, buttons
  AliasHelper,       // Alias generation utilities
  JsonHelper         // JSON parsing utilities
} from '@umbraco/playwright-testhelpers';