ESLint 是如何检查 .vue 文件的
近期要做一个类似的内容,学习了一下 Vue 是如何做的。
ESLint 中的扩展机制
首先需要了解一下如何才能扩展 ESLint 的功能。ESLint 扩展机制主要有 Rules、Plugins、Formatters、Parsers,Formatters 目前不需要用到,因此着重看一下其他三种方式。
Parser
用于自定义的解析文件内容,返回 AST 给后续步骤使用。
Rules
用于定义校验规则。
Plugins
plugin 是多种功能的一个集合,可以定义以下内容:
- Rules:校验规则。
- Environments:环境变量。
- Processors:处理文件前后的钩子函数。preprocess、postprocess。
- Configs:一些预置的配置,可以让用户指定使用。
Vue 相关代码库
用于 .vue 文件的 eslint 代码库有两个:eslint-plugin-vue 和 vue-eslint-parser。
eslint-plugin-vue 用于提供 Rules。
vue-eslint-parser 用于解析 .vue 文件,尤其是 template 部分。
eslint-plugin-vue
入口文件为 lib/index.js,其中设置了三部分内容,rules、configs 和 processors。
rules
rules 部分对应着非常多的校验规则,放在 rules 目录下。rules 中关于 template 部分的校验,处理的是 vue-eslint-parser 中生成的 AST,这个 AST 的格式定义可以在这里查看:https://github.com/vuejs/vue-eslint-parser/blob/master/docs/ast.md
configs
configs 部分预置了很多配置选项,不同选项的区别主要在于 rules 的开关设置不同,我们不需要关心。这里我们主要看 base 配置中的 parser 部分:
parser 制定为了 vue-eslint-parser,这就是为什么我们不用手动装 vue-eslint-parser,而只需要安装 eslint-plugin-vue 的原因。
processors
最后一部分是 processors,他是一个对象:
其中 preprocess 没有做任何事情,直接将 code 返回了。
有时文件中会有一些注释来开启关闭某些 rules,而 postprocess 所做的内容是根据这些注释对 messages 做一个过滤。
vue-eslint-parser
vue-eslint-parser 的入口文件是 src/index.ts,该文件暴露出了 parseForESLint 和 parse 方法,这两个方法做的事情是一样的:输入原始代码,返回解析后的 AST。
由于配置 parser 后,所有文件都会经过 vue-eslint-parser,因此需要判断是否是 .vue 文件,如果不是的话,使用 espree (ESLint 默认的 JS 解析器) 或用户自定义的其他 parser 来处理 js 文件内容。
如果判断是 vue 文件,那么会对 HTMLParser 来解析 .vue 文件内容,获取到 script 和 template 部分。script 部分使用 espree 或用户自定义的其他 parser 来处理 js 内容,template 部分则已经由 HTMLParser 解析过了,直接使用即可。
总体流程
最后是总体的流程:
以上就是ESLint 是如何检查 .vue 文件的的详细内容,更多关于ESLint 检测.vue文件的资料请关注我们其它相关文章!