playwright.md

playwright config

Config for projects using Playwright for testing.

🏗️ Setup

1. If you haven't already, make sure to install @code-pushup/eslint-config and its required peer dependencies.

2. Since this plugin requires additional peer dependencies, you have to install them as well:

   npm install -D eslint-plugin-{jest-formatting,playwright}

3. Add to your eslint.config.js file:

   import playwright from '@code-pushup/eslint-config/playwright.js';
   import tseslint from 'typescript-eslint';
   
   export default tseslint.config(...playwright);

📏 Rules (40)

🔧 Automatically fixable by the --fix CLI option.
💡 Manually fixable by editor suggestions.

🚨 Errors (8)

Plugin	Rule	Options	Autofix	Overrides
	missing-playwright-await Identify false positives when async Playwright APIs are not properly awaited.		🔧
	no-networkidle Prevent usage of the networkidle option
	no-unsafe-references Prevent unsafe variable references in page.evaluate()		🔧
	prefer-web-first-assertions Prefer web first assertions		🔧
	valid-describe-callback Enforce valid describe() callback
	valid-expect Enforce valid expect() usage
	valid-expect-in-promise Require promises that have expectations in their chain to be valid
	valid-title Enforce valid titles		🔧

⚠️ Warnings (32)

Plugin	Rule	Options	Autofix	Overrides
	padding-around-describe-blocks		🔧
	padding-around-test-blocks		🔧
	expect-expect Enforce assertion to be made in a test body
	max-nested-describe Enforces a maximum depth to nested describe calls
	no-commented-out-tests Disallow commented out tests
	no-conditional-expect Disallow calling expect conditionally
	no-conditional-in-test Disallow conditional logic in tests
	no-duplicate-hooks Disallow duplicate setup and teardown hooks
	no-element-handle The use of ElementHandle is discouraged, use Locator instead		💡
	no-eval The use of page.$eval and page.$$eval are discouraged, use locator.evaluate or locator.evaluateAll instead
	no-focused-test Prevent usage of .only() focus test annotation		💡
	no-force-option Prevent usage of { force: true } option.
	no-nested-step Disallow nested test.step() methods
	no-page-pause Prevent usage of page.pause()
	no-skipped-test Prevent usage of the .skip() skip test annotation.		💡
	no-standalone-expect Disallow using expect outside of test blocks		🔧
	no-useless-await Disallow unnecessary awaits for Playwright methods		🔧
	no-useless-not Disallow usage of 'not' matchers when a more specific matcher exists		🔧
	no-wait-for-selector Prevent usage of page.waitForSelector()		💡
	no-wait-for-timeout Prevent usage of page.waitForTimeout()		💡
	prefer-comparison-matcher Suggest using the built-in comparison matchers		🔧
	prefer-equality-matcher Suggest using the built-in equality matchers		💡
	prefer-hooks-in-order Prefer having hooks in a consistent order
	prefer-hooks-on-top Suggest having hooks before any test cases
	prefer-locator Suggest locators over page methods
	prefer-native-locators Prefer native locator functions		🔧
	prefer-to-be Suggest using toBe() for primitive literals		🔧
	prefer-to-contain Suggest using toContain()		🔧
	prefer-to-have-count Suggest using toHaveCount()		🔧
	prefer-to-have-length Suggest using toHaveLength()		🔧
	require-hook Require setup and teardown code to be within a hook
	require-to-throw-message Require a message for toThrow()