Eslint
规则 | Rules

unicode-bom

要求或不允许Unicode字节顺序标记(BOM)(unicode-bom)

--fix命令行上的选项可以自动修复一些被这条规则反映的问题。

Unicode字节顺序标记(BOM)用于指定代码单元是大端还是小端。也就是说,最重要的还是最不重要的字节先来。UTF-8不需要BOM,因为当字符是单个字节时,字节排序无关紧要。由于UTF-8是网络的主要编码方式,因此我们"never"设定默认选项。

规则细节

如果使用"always"选项,则此规则要求文件始终以Unicode BOM字符U + FEFF开头。如果"never"使用,文件不能以U + FEFF开头。

选项

这条规则有一个字符串选项:

  • "always" 文件必须以Unicode BOM开头

  • "never" (默认)文件不得以Unicode BOM开头

always

此规则的正确代码示例包含以下"always"选项:

/*eslint unicode-bom: "error"*/ U+FEFF var abc;

此规则的错误代码示例包含以下"always"选项:

/*eslint unicode-bom: "error"*/ var abc;

never

具有默认选项的此规则的正确代码示例"never"

/*eslint unicode-bom: ["error", "never"]*/ var abc;

此规则的错误代码示例包含以下"never"选项:

/*eslint unicode-bom: ["error", "never"]*/ U+FEFF var abc;

何时不使用

如果您使用某些UTF-16或UTF-32文件,而您希望允许文件选择以Unicode BOM开头,则应关闭此规则。

版本

这条规则是在ESLint 2.11.0中引入的。

资源