playwright

Guide writing stable Playwright end-to-end tests with semantic locators and web-first assertions.

3|2|Updated Oct 9, 2025
One-click install
npx skills add https://github.com/ngx-signal-forms/ngx-signal-forms --skill playwright-ngx-signal-forms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playwright
Source: https://github.com/ngx-signal-forms/ngx-signal-forms/tree/main/.github/skills/playwright
Command: npx skills add https://github.com/ngx-signal-forms/ngx-signal-forms --skill playwright-ngx-signal-forms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Playwright E2E testing guidance helps teams write, refactor, and stabilize browser tests, addressing flakiness, maintainability, and accessibility validation in Playwright-driven workflows.

Core Features & Use Cases

  • Guidance for using semantic locators, web-first assertions, and descriptive test structure.
  • Best practices for organizing tests with test.describe, beforeEach, and test.step to improve readability and reliability.
  • Coverage of network mocking, accessibility-focused checks, and strategies to reduce flaky tests in real-world apps.

Quick Start

Create a basic Playwright test file following the minimal pattern example to demonstrate a stable end-to-end flow.

Frequently Asked Questions about playwright

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

FAQPage Schema
How do I fix flaky Playwright tests using web-first assertions?

Fix flaky Playwright tests by replacing manual waits with web-first assertions that auto-retry until elements reach an expected state, ensuring deterministic test execution without race conditions.

What is the best way to organize Playwright test files for maintainability?

Organize Playwright tests by grouping related cases with test.describe, initializing shared state in beforeEach, and breaking long flows into test.step blocks to improve readability and reliability.

How do I use semantic locators in Playwright for stable end-to-end testing?

Use semantic locators in Playwright by targeting accessible roles, labels, and text instead of brittle CSS selectors, creating resilient end-to-end tests that withstand UI structure changes.

Can I perform accessibility checks within a Playwright test flow?

Yes, you can perform accessibility checks within Playwright test flows by validating semantic locators and roles during typical page navigation, ensuring UI components meet accessibility standards alongside functional testing.

How do I set up network mocking in Playwright to stabilize e2e tests?

Set up network mocking in Playwright by intercepting route requests and returning predefined responses, isolating end-to-end tests from backend instability and ensuring deterministic test outcomes.

Why does my Playwright test fail intermittently during page transitions?

Playwright tests fail intermittently during page transitions when lacking deterministic structures; enforcing web-first assertions and semantic locators ensures the test waits for the UI to fully render before interacting.