eslint.config.mjs

/**
 * Copyright (c) Microsoft Corporation.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import typescriptEslint from "@typescript-eslint/eslint-plugin";
import tsParser from "@typescript-eslint/parser";
import notice from "eslint-plugin-notice";
import path from "path";
import { fileURLToPath } from "url";
import stylistic from "@stylistic/eslint-plugin";
import importRules from "eslint-plugin-import";
import { fixupConfigRules } from "@eslint/compat";
import { FlatCompat } from "@eslint/eslintrc";
import js from "@eslint/js";

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

const plugins = {
  "@stylistic": stylistic,
  "@typescript-eslint": typescriptEslint,
  notice,
  import: importRules,
};

const ignores = [
  ".github/",
  "*.js",
  "**/.cache/",
  "**/*.d.ts",
  "index.d.ts",
  "node_modules/",
  "output/",
  "**/playwright-report/",
  "packages/*/lib/",
  "packages/playwright-core/src/generated/*",
  "packages/playwright-core/src/third_party/",
  "packages/playwright-core/types/*",
  "packages/playwright-ct-core/src/generated/*",
  "packages/html-reporter/bundle.ts",
  "packages/html-reporter/playwright.config.ts",
  "packages/html-reporter/playwright/*",
  "packages/html-reporter/vite.config.ts",
  "test-results/",
  "tests/assets/",
  "tests/components/",
  "tests/installation/fixture-scripts/",
  "tests/third_party/",
  "utils/",
];

export const baseRules = {
  "@typescript-eslint/no-unused-vars": [
    2,
    { args: "none", caughtErrors: "none" },
  ],

  /**
   * Enforced rules
   */
  // syntax preferences
  "object-curly-spacing": ["error", "always"],
  quotes: [
    2,
    "single",
    {
      avoidEscape: true,
      allowTemplateLiterals: true,
    },
  ],
  "jsx-quotes": [2, "prefer-single"],
  "no-extra-semi": 2,
  "@stylistic/semi": [2],
  "comma-style": [2, "last"],
  "wrap-iife": [2, "inside"],
  "spaced-comment": [
    2,
    "always",
    {
      markers: ["*"],
    },
  ],
  eqeqeq: [2],
  "accessor-pairs": [
    2,
    {
      getWithoutSet: false,
      setWithoutGet: false,
    },
  ],
  "brace-style": [2, "1tbs", { allowSingleLine: true }],
  curly: [2, "multi-or-nest", "consistent"],
  "new-parens": 2,
  "arrow-parens": [2, "as-needed"],
  "prefer-const": 2,
  "quote-props": [2, "consistent"],
  "nonblock-statement-body-position": [2, "below"],

  // anti-patterns
  "no-var": 2,
  "no-with": 2,
  "no-multi-str": 2,
  "no-caller": 2,
  "no-implied-eval": 2,
  "no-labels": 2,
  "no-new-object": 2,
  "no-octal-escape": 2,
  "no-self-compare": 2,
  "no-shadow-restricted-names": 2,
  "no-cond-assign": 2,
  "no-debugger": 2,
  "no-dupe-keys": 2,
  "no-duplicate-case": 2,
  "no-empty-character-class": 2,
  "no-unreachable": 2,
  "no-unsafe-negation": 2,
  radix: 2,
  "valid-typeof": 2,
  "no-implicit-globals": [2],
  "no-unused-expressions": [
    2,
    { allowShortCircuit: true, allowTernary: true, allowTaggedTemplates: true },
  ],
  "no-proto": 2,

  // es2015 features
  "require-yield": 2,
  "template-curly-spacing": [2, "never"],

  // spacing details
  "space-infix-ops": 2,
  "space-in-parens": [2, "never"],
  "array-bracket-spacing": [2, "never"],
  "comma-spacing": [2, { before: false, after: true }],
  "keyword-spacing": [2, "always"],
  "space-before-function-paren": [
    2,
    {
      anonymous: "never",
      named: "never",
      asyncArrow: "always",
    },
  ],
  "no-whitespace-before-property": 2,
  "keyword-spacing": [
    2,
    {
      overrides: {
        if: { after: true },
        else: { after: true },
        for: { after: true },
        while: { after: true },
        do: { after: true },
        switch: { after: true },
        return: { after: true },
      },
    },
  ],
  "arrow-spacing": [
    2,
    {
      after: true,
      before: true,
    },
  ],
  "@stylistic/func-call-spacing": 2,
  "@stylistic/type-annotation-spacing": 2,

  // file whitespace
  "no-multiple-empty-lines": [2, { max: 2, maxEOF: 0 }],
  "no-mixed-spaces-and-tabs": 2,
  "no-trailing-spaces": 2,
  "linebreak-style": [process.platform === "win32" ? 0 : 2, "unix"],
  indent: [
    2,
    2,
    { SwitchCase: 1, CallExpression: { arguments: 2 }, MemberExpression: 2 },
  ],
  "key-spacing": [
    2,
    {
      beforeColon: false,
    },
  ],
  "eol-last": 2,

  // copyright
  "notice/notice": [
    2,
    {
      mustMatch: "Copyright",
      templateFile: path.join(__dirname, "utils", "copyright.js"),
    },
  ],

  // react
  "react/react-in-jsx-scope": 0,
};

const noFloatingPromisesRules = {
  "@typescript-eslint/no-floating-promises": "error",
};

const noBooleanCompareRules = {
  "@typescript-eslint/no-unnecessary-boolean-literal-compare": 2,
};

// This should contain every builtin from builtins.ts.
const noWebGlobalsRuleList = [
  { name: "window", message: "Use InjectedScript.window instead" },
  { name: "document", message: "Use InjectedScript.document instead" },
  { name: "globalThis", message: "Use InjectedScript.window instead" },
  { name: "setTimeout", message: "import { setTimeout } from './builtins' instead" },
  { name: "clearTimeout", message: "import { clearTimeout } from './builtins' instead" },
  { name: "setInterval", message: "import { setInterval } from './builtins' instead" },
  { name: "clearInterval", message: "import { clearInterval } from './builtins' instead" },
  { name: "requestAnimationFrame", message: "import { requestAnimationFrame } from './builtins' instead" },
  { name: "cancelAnimationFrame", message: "import { cancelAnimationFrame } from './builtins' instead" },
  { name: "requestIdleCallback", message: "import { requestIdleCallback } from './builtins' instead" },
  { name: "cancelIdleCallback", message: "import { cancelIdleCallback } from './builtins' instead" },
  { name: "performance", message: "import { performance } from './builtins' instead" },
  { name: "eval", message: "Use builtins().eval instead" },
  { name: "Date", message: "import { Date } from './builtins' instead" },
  { name: "Map", message: "import { Map } from './builtins' instead" },
  { name: "Set", message: "import { Set } from './builtins' instead" },
];

const noNodeGlobalsRuleList = [{ name: "process" }];

const importOrderRules = {
  "import/order": [
    2,
    {
      groups: [
        "builtin",
        "external",
        "internal",
        ["parent", "sibling"],
        "index",
        "type",
      ],
      "newlines-between": "always",
    },
  ],
  "import/consistent-type-specifier-style": [2, "prefer-top-level"],
};

const languageOptions = {
  parser: tsParser,
  ecmaVersion: 9,
  sourceType: "module",
};

const languageOptionsWithTsConfig = {
  parser: tsParser,
  ecmaVersion: 9,
  sourceType: "module",
  parserOptions: {
    project: path.join(__dirname, "tsconfig.json"),
  },
};

const compat = new FlatCompat({
  baseDirectory: __dirname,
  recommendedConfig: js.configs.recommended,
  allConfig: js.configs.all,
});
const reactBaseConfig = fixupConfigRules(
  compat.extends("plugin:react/recommended", "plugin:react-hooks/recommended")
);
const reactFiles = [
  `packages/html-reporter/src/**/*.ts`,
  `packages/html-reporter/src/**/*.tsx`,
  `packages/recorder/src/**/*.ts`,
  `packages/recorder/src/**/*.tsx`,
  `packages/trace-viewer/src/**/*.ts`,
  `packages/trace-viewer/src/**/*.tsx`,
  `packages/web/src/**/*.ts`,
  `packages/web/src/**/*.tsx`,
];

function reactPackageSection(packageName) {
  return {
    files: [
      `packages/${packageName}/src/**/*.ts`,
      `packages/${packageName}/src/**/*.tsx`,
      `packages/web/src/**/*.ts`,
      `packages/web/src/**/*.tsx`,
    ],
    languageOptions: {
      parser: tsParser,
      ecmaVersion: 9,
      sourceType: "module",
      parserOptions: {
        project: path.join(__dirname, "packages", packageName, "tsconfig.json"),
      },
    },
    rules: {
      ...baseRules,
      "no-console": 2,
    },
  };
}

export default [
  {
    ignores,
  },
  {
    files: ["**/*.ts", "**/*.tsx"],
    plugins,
    languageOptions,
    rules: baseRules,
    settings: {
      react: { version: "detect" },
    },
  },
  {
    files: ["packages/**/*.ts"],
    languageOptions: languageOptionsWithTsConfig,
    rules: {
      "no-console": 2,
      "no-restricted-properties": [
        2,
        {
          object: "process",
          property: "exit",
          message:
            "Please use gracefullyProcessExitDoNotHang function to exit the process.",
        },
      ],
    },
  },
  {
    files: ["packages/**/*.ts"],
    rules: {
      ...importOrderRules,
    },
  },
  {
    files: ["packages/playwright/**/*.ts"],
    rules: {
      ...noFloatingPromisesRules,
    },
  },
  {
    files: ["packages/playwright/src/reporters/**/*.ts"],
    languageOptions: languageOptionsWithTsConfig,
    rules: {
      "no-console": "off",
    },
  },
  {
    files: [
      "packages/playwright-core/src/utils/**/*.ts",
    ],
    languageOptions: languageOptionsWithTsConfig,
    rules: {
      "no-restricted-globals": [
        "error",
        ...noNodeGlobalsRuleList,
        ...noWebGlobalsRuleList,
      ],
      ...noFloatingPromisesRules,
      ...noBooleanCompareRules,
    },
  },
  {
    files: [
      "packages/injected/src/**/*.ts",
      "packages/playwright-core/src/server/pageBinding.ts",
      "packages/playwright-core/src/server/storageScript.ts",
    ],
    languageOptions: languageOptionsWithTsConfig,
    rules: {
      "no-restricted-globals": [
        "error",
        ...noWebGlobalsRuleList,
      ],
      ...noFloatingPromisesRules,
      ...noBooleanCompareRules,
    },
  },
  {
    files: [
      "packages/playwright-core/src/client/**/*.ts",
      "packages/playwright-core/src/protocol/**/*.ts",
    ],
    languageOptions: languageOptionsWithTsConfig,
    rules: {
      "no-restricted-globals": [
        "error",
        ...noNodeGlobalsRuleList,
      ],
      ...noFloatingPromisesRules,
      ...noBooleanCompareRules,
    },
  },
  {
    files: ["tests/**/*.spec.js", "tests/**/*.ts"],
    languageOptions: {
      parser: tsParser,
      ecmaVersion: 9,
      sourceType: "module",
      parserOptions: {
        project: path.join(__dirname, "tests", "tsconfig.json"),
      },
    },
    rules: {
      ...noFloatingPromisesRules,
    },
  },
  ...reactBaseConfig.map((config) => ({
    ...config,
    files: reactFiles,
  })),
  reactPackageSection("html-reporter"),
  reactPackageSection("recorder"),
  reactPackageSection("trace-viewer"),
];