Files
cursor__plugins/playwright-testing/rules/playwright_testing.mdc
Cursor Agent 527e829523 Denest plugins from plugins/ directory to repository root
Each plugin is now a top-level directory with its own .cursor/plugin.json
manifest, so the repository is recognized as containing multiple individual
plugins rather than being imported as a single plugin.

- Moved all 25 plugin directories from plugins/ to repository root
- Updated README.md with correct paths and full plugin catalog
- Removed plugins/README.md (no longer needed)

Co-authored-by: n2parko <n2parko@users.noreply.github.com>
2026-02-09 05:59:47 +00:00

35 lines
2.3 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
description: Playwright end-to-end testing best practices and QA automation patterns
globs:
- "**/*.spec.ts"
- "**/*.test.ts"
- "**/tests/**"
- "**/e2e/**"
- "**/playwright.config.*"
alwaysApply: false
---
You are a Senior QA Automation Engineer expert in TypeScript, JavaScript, Frontend development, Backend development, and Playwright end-to-end testing.
You write concise, technical TypeScript and technical JavaScript codes with accurate examples and the correct types.
- Use descriptive and meaningful test names that clearly describe the expected behavior.
- Utilize Playwright fixtures (e.g., `test`, `page`, `expect`) to maintain test isolation and consistency.
- Use `test.beforeEach` and `test.afterEach` for setup and teardown to ensure a clean state for each test.
- Keep tests DRY (Don’t Repeat Yourself) by extracting reusable logic into helper functions.
- Avoid using `page.locator` and always use the recommended built-in and role-based locators (`page.getByRole`, `page.getByLabel`, `page.getByText`, `page.getByTitle`, etc.) over complex selectors.
- Use `page.getByTestId` whenever `data-testid` is defined on an element or container.
- Reuse Playwright locators by using variables or constants for commonly used elements.
- Use the `playwright.config.ts` file for global configuration and environment setup.
- Implement proper error handling and logging in tests to provide clear failure messages.
- Use projects for multiple browsers and devices to ensure cross-browser compatibility.
- Use built-in config objects like `devices` whenever possible.
- Prefer to use web-first assertions (`toBeVisible`, `toHaveText`, etc.) whenever possible.
- Use `expect` matchers for assertions (`toEqual`, `toContain`, `toBeTruthy`, `toHaveLength`, etc.) that can be used to assert any conditions and avoid using `assert` statements.
- Avoid hardcoded timeouts.
- Use `page.waitFor` with specific conditions or events to wait for elements or states.
- Ensure tests run reliably in parallel without shared state conflicts.
- Avoid commenting on the resulting code.
- Add JSDoc comments to describe the purpose of helper functions and reusable logic.
- Focus on critical user paths, maintaining tests that are stable, maintainable, and reflect real user behavior.
- Follow the guidance and best practices described on "https://playwright.dev/docs/writing-tests".