eslint-config-alloy
Version:
AlloyTeam ESLint 规则
404 lines (403 loc) • 11.5 kB
JavaScript
/**
* AlloyTeam ESLint 规则
* https://alloyteam.github.io/eslint-config-alloy/
*
* 贡献者：
* xcatliu <xcatliu@gmail.com>
* heyli <lcxfs1991@gmail.com>
* Xuing <admin@xuing.cn>
* Dash Chen <dc3671@users.noreply.github.com>
* DiamondYuan <admin@diamondyuan.com>
* Roy Revelt <roy@codsen.com>
* Swan <1021808625@qq.com>
* kenve <zwei.xie@gmail.com>
* lzw <mingxin2014@gmail.com>
* ryoliu <sfesh@163.com>
* sunhui04 <sunhui04@meituan.com>
* zoubingwu <zoubingwu@gmail.com>
*
* 依赖版本：
* eslint ^8.45.0
* @babel/core ^7.22.9
* @babel/eslint-parser ^7.22.9
* @babel/preset-react ^7.22.5
* eslint-plugin-react ^7.33.0
* vue-eslint-parser ^9.3.1
* eslint-plugin-vue ^9.15.1
* @typescript-eslint/parser ^6.2.0
* @typescript-eslint/eslint-plugin ^6.2.0
*
* 此文件是由脚本 scripts/build.ts 自动生成
*/
module.exports = {
parserOptions: {
babelOptions: {
presets: ['@babel/preset-react'],
},
},
plugins: ['react'],
rules: {
/**
* 布尔值类型的 propTypes 的 name 必须为 is 或 has 开头
* @reason 类型相关的约束交给 TypeScript
*/
'react/boolean-prop-naming': 'off',
/**
* <button> 必须有 type 属性
*/
'react/button-has-type': 'off',
/**
* 一个 defaultProps 必须有对应的 propTypes
* @reason 类型相关的约束交给 TypeScript
*/
'react/default-props-match-prop-types': 'off',
/**
* props, state, context 必须用解构赋值
*/
'react/destructuring-assignment': 'off',
/**
* 组件必须有 displayName 属性
* @reason 不强制要求写 displayName
*/
'react/display-name': 'off',
/**
* 禁止在自定义组件中使用指定的 props
*/
'react/forbid-component-props': 'off',
/**
* 禁止在 dom 组件中使用指定的 props
*/
'react/forbid-dom-props': 'off',
/**
* 禁止使用指定的组件
*/
'react/forbid-elements': 'off',
/**
* 禁止使用另一个组件的 propTypes
* @reason 类型相关的约束交给 TypeScript
*/
'react/forbid-foreign-prop-types': 'off',
/**
* 禁止使用 PropTypes.any PropTypes.array 和 PropTypes.object
* @reason 类型相关的约束交给 TypeScript
*/
'react/forbid-prop-types': 'off',
/**
* 限制函数式组件的函数形式（函数声明、函数表达式或箭头函数）
* @reason 一些场景还不能覆盖，如 export default function，自动修复功能在 ts 中有些问题
*/
'react/function-component-definition': 'off',
/**
* hook 的返回值必须与 useState 的解构对应
*/
'react/hook-use-state': 'off',
/**
* iframe 组件必须添加 sandbox 属性
*/
'react/iframe-missing-sandbox': 'error',
/**
* 布尔值的属性必须显式的声明值为 true
*/
'react/jsx-boolean-value': 'off',
/**
* 禁止 jsx 中使用无用的引号
*/
'react/jsx-curly-brace-presence': ['error', 'never'],
/**
* 限制文件后缀
*/
'react/jsx-filename-extension': 'off',
/**
* 必须使用 <></> 而不是 React.Fragment
* @reason <></> 不需要额外引入 Fragment 组件
*/
'react/jsx-fragments': ['error', 'syntax'],
/**
* handler 的名称必须是 onXXX 或 handleXXX
*/
'react/jsx-handler-names': 'off',
/**
* 数组中的 jsx 必须有 key
*/
'react/jsx-key': [
'error',
{
checkFragmentShorthand: true,
},
],
/**
* 限制 jsx 层级
*/
'react/jsx-max-depth': 'off',
/**
* jsx 中禁止使用 bind
*/
'react/jsx-no-bind': 'off',
/**
* 禁止在 jsx 中使用像注释的字符串
*/
'react/jsx-no-comment-textnodes': 'error',
/**
* 禁止使用不稳定的值作为 Context.Provider 的 value
*/
'react/jsx-no-constructed-context-values': 'error',
/**
* 禁止出现重复的 props
*/
'react/jsx-no-duplicate-props': 'error',
/**
* 使用 && 渲染组件时，禁止条件是 0 '' 或 NaN
*/
'react/jsx-no-leaked-render': 'off',
/**
* 禁止在 jsx 中出现字符串
*/
'react/jsx-no-literals': 'off',
/**
* 禁止出现 href="javascript:void(0)"
* @reason React 已经有 warning 了，并且会在将来禁止此类属性值
*/
'react/jsx-no-script-url': 'error',
/**
* 禁止使用 target="_blank"
*/
'react/jsx-no-target-blank': 'off',
/**
* 禁止使用未定义的组件
*/
'react/jsx-no-undef': 'error',
/**
* 禁止无意义的 Fragment 组件
*/
'react/jsx-no-useless-fragment': 'error',
/**
* 组件的名称必须符合 PascalCase
*/
'react/jsx-pascal-case': 'error',
/**
* 禁止使用 {...props}
*/
'react/jsx-props-no-spreading': 'off',
/**
* props 必须按字母排序
*/
'react/jsx-sort-props': 'off',
/**
* 修复 React 被误报为未使用的变量的问题（仅在开启 no-unused-vars 时有效）
*/
'react/jsx-uses-react': 'error',
/**
* 修复 no-unused-vars 不检查 jsx 的问题
*/
'react/jsx-uses-vars': 'error',
/**
* 禁止在 setState 中使用 this.state
*/
'react/no-access-state-in-setstate': 'off',
/**
* 两个 inline 元素之间必须有空格，否则视觉上它们就贴在一起了
* @reason 这是样式的问题，不应该由空格约束
*/
'react/no-adjacent-inline-elements': 'off',
/**
* 禁止使用数组的索引作为 key
*/
'react/no-array-index-key': 'off',
/**
* 类组件中的生命周期函数不要使用箭头函数
*/
'react/no-arrow-function-lifecycle': 'off',
/**
* 禁止将 children 作为一个 prop
*/
'react/no-children-prop': 'error',
/**
* 禁止使用 dangerouslySetInnerHTML
*/
'react/no-danger': 'off',
/**
* 禁止在使用了 dangerouslySetInnerHTML 的组件内添加 children
*/
'react/no-danger-with-children': 'error',
/**
* 禁止使用已废弃的 api
*/
'react/no-deprecated': 'error',
/**
* 禁止在 componentDidMount 里使用 setState
* @reason 同构应用需要在 didMount 里使用 setState
*/
'react/no-did-mount-set-state': 'off',
/**
* 禁止在 componentDidUpdate 里使用 setState
*/
'react/no-did-update-set-state': 'error',
/**
* 禁止直接修改 this.state
*/
'react/no-direct-mutation-state': 'error',
/**
* 禁止使用 findDOMNode
*/
'react/no-find-dom-node': 'error',
/**
* 禁用指定的 html 属性
* @reason 需要指定特定属性时才需要开启
*/
'react/no-invalid-html-attribute': 'off',
/**
* 禁止使用 isMounted
* @reason 它是已废弃的语法
*/
'react/no-is-mounted': 'error',
/**
* 禁止在一个文件创建两个组件
* @reason 有一个 bug：https://github.com/yannickcr/eslint-plugin-react/issues/1181
*/
'react/no-multi-comp': 'off',
/**
* 禁止在 jsx 中使用命名空间
*/
'react/no-namespace': 'error',
/**
* 在功能性组件中禁止将引用类型变量用作默认参数
*/
'react/no-object-type-as-default-prop': 'off',
/**
* 禁止在 React.PureComponent 中使用 shouldComponentUpdate
*/
'react/no-redundant-should-component-update': 'error',
/**
* 禁止使用 ReactDOM.render 的返回值
*/
'react/no-render-return-value': 'error',
/**
* 禁止使用 setState
*/
'react/no-set-state': 'off',
/**
* 禁止使用字符串 ref
*/
'react/no-string-refs': 'error',
/**
* 禁止在函数组件中使用 this
*/
'react/no-this-in-sfc': 'error',
/**
* 禁止组件的属性或生命周期大小写错误
*/
'react/no-typos': 'error',
/**
* 禁止在组件的内部存在未转义的 >, ", ' 或 }
*/
'react/no-unescaped-entities': 'error',
/**
* 禁止出现 HTML 中的属性，如 class
*/
'react/no-unknown-property': 'error',
/**
* 禁止使用不安全的生命周期方法 componentWillMount, componentWillReceiveProps, componentWillUpdate
*/
'react/no-unsafe': [
'error',
{
checkAliases: true,
},
],
/**
* 禁止在组件内使用不稳定的组件
*/
'react/no-unstable-nested-components': 'error',
/**
* 禁止在类组件中定义未使用的方法
*/
'react/no-unused-class-component-methods': 'off',
/**
* 禁止出现未使用的 propTypes
* @reason 类型相关的约束交给 TypeScript
*/
'react/no-unused-prop-types': 'off',
/**
* 已定义的 state 必须使用
* @reason 没有官方文档，并且存在很多 bug：https://github.com/yannickcr/eslint-plugin-react/search?q=no-unused-state&type=Issues&utf8=%E2%9C%93
*/
'react/no-unused-state': 'off',
/**
* 禁止在 componentWillUpdate 中使用 setState
* @reason 已经禁止使用 componentWillUpdate 了
*/
'react/no-will-update-set-state': 'off',
/**
* 必须使用 Class 的形式创建组件
*/
'react/prefer-es6-class': ['error', 'always'],
/**
* 使用 Flow 时，props 必须设置为精确的类型
*/
'react/prefer-exact-props': 'off',
/**
* 使用 Flow 时，props 必须设置为只读的
*/
'react/prefer-read-only-props': 'off',
/**
* 必须使用函数式组件
*/
'react/prefer-stateless-function': 'off',
/**
* 组件必须写 propTypes
* @reason 类型相关的约束交给 TypeScript
*/
'react/prop-types': 'off',
/**
* 出现 jsx 的地方必须导入 React
* @reason 已经在 no-undef 中限制了
*/
'react/react-in-jsx-scope': 'off',
/**
* 非 required 的 prop 必须有 defaultProps
* @reason 类型相关的约束交给 TypeScript
*/
'react/require-default-props': 'off',
/**
* 组件必须有 shouldComponentUpdate
*/
'react/require-optimization': 'off',
/**
* render 方法中必须有返回值
*/
'react/require-render-return': 'error',
/**
* 组件内没有 children 时，必须使用自闭和写法
*/
'react/self-closing-comp': 'error',
/**
* 组件内方法必须按照一定规则排序
*/
'react/sort-comp': 'error',
/**
* 强制实施 defaultProps 声明按字母顺序排序
*/
'react/sort-default-props': 'off',
/**
* propTypes 的属性必须按照字母排序
* @reason 类型相关的约束交给 TypeScript
*/
'react/sort-prop-types': 'off',
/**
* 必须在构造函数中初始化 state
*/
'react/state-in-constructor': 'off',
/**
* 类的静态属性必须使用 static 关键字定义
*/
'react/static-property-placement': 'error',
/**
* style 属性的取值必须是 object
*/
'react/style-prop-object': 'error',
/**
* img, br 标签中禁止有 children
*/
'react/void-dom-elements-no-children': 'error',
},
};