eslint-plugin-kepler为Vega应用提供自动lint规则,帮助您发现和修复性能及兼容性问题。
先决条件
安装插件及其依赖项:配置插件
-
更新
.eslintrc配置文件的extends、plugins和overrides部分:kepler配置包括所有Vega规则。要使用规则子集,请改为扩展以下一个或多个配置:performance- 仅限性能相关规则system-distributed-libs- 仅限系统分布式库检查(package.json验证和导入信息标记)accessibility- 仅限无障碍功能规则
要仅使用无障碍规则,请使用以下命令:保存文件。下次运行linter时,ESLint会加载Vega规则。 - (可选)按照ESLint的配置规则指南自定义lint规则。 如果跳过此步骤,所有规则都将以默认严重程度运行。 有关Vega ESLint插件提供的规则,请参阅了解性能规则、了解系统分布式库规则和了解无障碍功能规则。
-
在
package.json文件的lint脚本中指定自定义格式化程序:您的lint脚本现在使用Vega自定义格式化程序。 -
运行linter:
如果未出现
package.json警告,请确认已安装jsonc-eslint-parser,并且已将package.json传递给eslint命令。 您可以在控制台上看到结果:
linter还会生成一个HTML报告:
在悬停于代码上方时,您可以在VS Code上查看这些linter警告:
了解性能规则
以下规则有助于识别Vega应用中的常见性能问题,并实施最佳实践以实现最佳运行时性能。 在本页面的规则表中,Error规则会标记问题并导致构建失败。Warn规则会标记问题,但不会导致构建失败。
了解系统分布式库规则
以下规则检测系统分布式库的使用情况,并就正确实施为您提供指导。(可选)配置语义化版本规范
系统分布式库规则会检查package.json依赖项中的语义化版本规范。默认情况下,该插件使用自动模式来检测项目的版本规范设置。
通过设置semverGuidance选项来覆盖默认值:
- 仅限修补程序模式 (
semverGuidance: "patch"): 使用~前缀限制对修补程序的更新。 - 次要模式和修补程序模式 (
semverGuidance: "minor"): 允许使用^前缀的次要更新。 - 自动模式 (
semverGuidance: "auto"): 根据项目存储库中的项目签名检测设置。这是默认设置。
了解无障碍功能规则
以下规则标记辅助技术(例如屏幕阅读器)无法描述或无法正确操作的组件。有关这些规则检查的无障碍功能属性的指导,请参阅适用于React Native 0.83或React Native 0.72的无障碍功能。
要更改无障碍功能规则的严重程度,请在ESLint配置的
rules部分中覆盖它:
(可选)配置VS Code进行JSON验证
如果想在VS Code的package.json中查看错误和警告,请在以下settings.json条目中添加json:

