Can I use this for both API-level and UI-level testing?

Absolutely. It includes umbracoApi for fast data setup/teardown and umbracoUi for simulating real user interactions within the Umbraco management interface.

Do I need to install a specific package to use these helpers?

Yes, you should install @umbraco/playwright-testhelpers as a dev dependency in your project to use the fixtures and classes described in this skill.

Does it handle Umbraco backoffice authentication?

Yes, the helpers include built-in methods for logging into the backoffice and managing CSRF tokens automatically, simplifying the test setup process.

What is the main purpose of the Umbraco Playwright Test Helpers skill?

This skill provides a reference for using the @umbraco/playwright-testhelpers package to automate testing of the Umbraco backoffice using Playwright, covering both API and UI interaction patterns.

How do the fixtures work with standard Playwright tests?

The package exports an extended 'test' object that provides umbracoApi and umbracoUi as fixtures, which can be destructured directly in your test arguments.

Umbraco Playwright Test Helpers

Name: Umbraco Playwright Test Helpers
Author: umbraco

byumbraco

•

Security & Testing

Facilitates end-to-end testing for Umbraco CMS by providing specialized Playwright fixtures, API wrappers, and UI interaction helpers.

This skill provides comprehensive guidance and implementation patterns for the @umbraco/playwright-testhelpers package, enabling developers to write robust E2E tests for the Umbraco backoffice. It streamlines test setup via dedicated API helpers for content, media, and document types, while offering a rich set of UI helpers for navigating trees, interacting with editors, and managing notifications. By leveraging standardized fixtures and constants, it helps ensure high-quality Umbraco implementations through efficient, automated browser testing that mirrors real-world administrative workflows.

Key Features

01UI interaction utilities for backoffice navigation, tree operations, and editor management

02Specialized Playwright fixtures for injecting umbracoApi and umbracoUi into tests

03Automated authentication handling and CSRF token management for test environments

04Comprehensive API helpers for rapid setup of content, media, users, and document types

05Standardized ConstantHelper for reliable references to sections, actions, and buttons

061 GitHub stars

Use Cases

01Programmatically seeding complex test data via the Umbraco API before executing UI tests

02Automating regression tests for custom Umbraco backoffice extensions and property editors

03Verifying document type configurations and publishing workflows across different languages

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add umbraco/umbraco-cms-backoffice-skills umbraco-playwright-testhelpers

For use in Claude.ai and ChatGPT

Download Skill