gecko-dev/devtools/.eslintrc.js

262 lines
8.3 KiB
JavaScript

/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
"use strict";
module.exports = {
plugins: ["react"],
globals: {
exports: true,
isWorker: true,
DebuggerNotificationObserver: true,
},
overrides: [
{
files: ["**/*.*"],
excludedFiles: ["**/*.sys.mjs", "**/*.worker.js"],
globals: {
loader: true,
module: true,
require: true,
},
},
{
files: ["client/framework/**"],
rules: {
"no-return-assign": "off",
},
},
{
files: [
// Allow non-camelcase so that run_test doesn't produce a warning.
"**/test*/**/*",
],
rules: {
camelcase: "off",
},
},
{
files: ["client/framework/**"],
rules: {
"max-nested-callbacks": "off",
},
},
{
files: ["client/framework/**", "shared/webconsole/test/chrome/*.html"],
rules: {
"mozilla/no-aArgs": "off",
},
},
{
files: ["client/framework/test/**"],
rules: {
"mozilla/var-only-at-top-level": "off",
},
},
{
files: ["client/framework/**"],
rules: {
strict: "off",
},
},
{
// For all head*.js files, turn off no-unused-vars at a global level
files: ["**/head*.js"],
rules: {
"no-unused-vars": ["error", { argsIgnorePattern: "^_", vars: "local" }],
},
},
{
// For all server and shared files, prevent requiring devtools/client
// modules.
files: ["server/**", "shared/**"],
rules: {
"mozilla/reject-some-requires": [
"error",
"^(resource://)?devtools/client",
],
},
excludedFiles: [
// Tests can always import anything.
"**/test*/**/*",
],
},
{
// All DevTools files should avoid relative paths.
files: ["**"],
excludedFiles: [
// Debugger modules have a custom bundling logic which relies on relative
// paths.
"client/debugger/src/**",
// `client/shared/build` contains node helpers to build the debugger and
// not devtools modules.
"client/shared/build/**",
],
rules: {
"mozilla/reject-relative-requires": "error",
},
},
{
// These tests use old React. We should accept deprecated API usages
files: [
"client/inspector/markup/test/doc_markup_events_react_development_15.4.1.html",
"client/inspector/markup/test/doc_markup_events_react_development_15.4.1_jsx.html",
"client/inspector/markup/test/doc_markup_events_react_production_15.3.1.html",
"client/inspector/markup/test/doc_markup_events_react_production_15.3.1_jsx.html",
],
rules: {
"react/no-deprecated": "off",
},
},
{
// These files are used in both browser and node environments,
files: [
"shared/compatibility/constants.js",
"shared/compatibility/helpers.js",
],
env: {
browser: false,
"mozilla/privileged": false,
"mozilla/specific": false,
},
},
{
// This file is only used in node environment.
files: ["shared/compatibility/bin/update.js"],
env: {
browser: false,
node: true,
"mozilla/privileged": false,
"mozilla/specific": false,
},
},
{
files: [
"client/inspector/markup/test/doc_markup_events_react_*_jsx.html",
],
parserOptions: {
ecmaFeatures: {
jsx: true,
},
},
},
],
rules: {
// These are the rules that have been configured so far to match the
// devtools coding style.
// Rules from the mozilla plugin
"mozilla/balanced-observers": "error",
"mozilla/no-aArgs": "error",
// See bug 1224289.
"mozilla/reject-importGlobalProperties": ["error", "everything"],
"mozilla/var-only-at-top-level": "error",
// Rules from the React plugin
"react/display-name": "error",
"react/no-danger": "error",
"react/no-deprecated": "error",
"react/no-did-mount-set-state": "error",
"react/no-did-update-set-state": "error",
"react/no-direct-mutation-state": "error",
"react/no-unknown-property": "error",
"react/prefer-es6-class": ["off", "always"],
"react/prop-types": "error",
"react/sort-comp": [
"error",
{
order: ["static-methods", "lifecycle", "everything-else", "render"],
groups: {
lifecycle: [
"displayName",
"propTypes",
"contextTypes",
"childContextTypes",
"mixins",
"statics",
"defaultProps",
"constructor",
"getDefaultProps",
"getInitialState",
"state",
"getChildContext",
"UNSAFE_componentWillMount",
"componentDidMount",
"UNSAFE_componentWillReceiveProps",
"shouldComponentUpdate",
"UNSAFE_componentWillUpdate",
"componentDidUpdate",
"componentWillUnmount",
],
},
},
],
// Disallow using variables outside the blocks they are defined (especially
// since only let and const are used, see "no-var").
"block-scoped-var": "error",
// Require camel case names
camelcase: ["error", { properties: "never" }],
// Warn about cyclomatic complexity in functions.
// 20 is ESLint's default, and we want to keep it this way to prevent new highly
// complex functions from being introduced. However, because Mozilla's eslintrc has
// some other value defined, we need to override it here. See bug 1553449 for more
// information on complex DevTools functions that are currently excluded.
complexity: ["error", 20],
// componentDidUnmount is not a real lifecycle method, use componentWillUnmount.
"id-denylist": ["error", "componentDidUnmount"],
// Maximum depth callbacks can be nested.
"max-nested-callbacks": ["error", 3],
// Require a capital letter for constructors, only check if all new
// operators are followed by a capital letter. Don't warn when capitalized
// functions are used without the new operator.
"new-cap": ["error", { capIsNew: false }],
// Disallow empty statements. This will report an error for:
// try { something(); } catch (e) {}
// but will not report it for:
// try { something(); } catch (e) { /* Silencing the error because ...*/ }
// which is a valid use case.
"no-empty": "error",
// Disallow adding to native types
"no-extend-native": "error",
// Disallow use of multiline strings (use template strings instead).
"no-multi-str": "error",
// Disallow usage of __proto__ property.
"no-proto": "error",
// Disallow use of assignment in return statement. It is preferable for a
// single line of code to have only one easily predictable effect.
"no-return-assign": "error",
// Disallow global and local variables that aren't used. Allow unused
// function arguments prefixed with `_`.
"no-unused-vars": ["error", { argsIgnorePattern: "^_", vars: "all" }],
// Enforce using `let` only when variables are reassigned.
"prefer-const": ["error", { destructuring: "all" }],
// Require use of the second argument for parseInt().
radix: "error",
// Require "use strict" to be defined globally in the script.
strict: ["error", "global"],
// Disallow Yoda conditions (where literal value comes first).
yoda: "error",
// And these are the rules that haven't been discussed so far, and that are
// disabled for now until we introduce them, one at a time.
// disallow overwriting functions written as function declarations
"no-func-assign": "off",
// disallow unnecessary nested blocks
"no-lone-blocks": "off",
// disallow unnecessary concatenation of literals or template literals
"no-useless-concat": "off",
// This rule will match any function starting with `use` which aren't
// necessarily in a React component. Also DevTools aren't using React hooks
// so this sounds unecessary.
"react-hooks/rules-of-hooks": "off",
},
settings: {
react: {
version: "16.8",
},
},
};