unicode-bom

Требовать или запрещать метку порядка байтов Unicode (BOM)

Метка порядка байтов Unicode (BOM) используется для указания, являются ли кодовые единицы большого или малого порядка. То есть, идут ли сначала наиболее или наименее значимые байты. UTF-8 не требует BOM, поскольку порядок байтов не имеет значения, когда символы представляются одним байтом. Поскольку UTF-8 является основным кодированием в веб, мы устанавливаем "never" в качестве параметра по умолчанию.

Подробности правила

Если используется параметр "always", это правило требует, чтобы файлы всегда начинались с символа метки порядка байтов Unicode U+FEFF. Если используется "never", файлы не должны начинаться с U+FEFF.

Параметры

Это правило имеет строковый параметр:

• "always" файлы должны начинаться с метки порядка байтов Unicode
• "never" (по умолчанию) файлы не должны начинаться с метки порядка байтов Unicode

всегда

Пример правильного кода для этого правила с параметром "always":

// U+FEFF at the beginning

/*eslint unicode-bom: ["error", "always"]*/

var abc;

Пример неправильного кода для этого правила с параметром "always":

/*eslint unicode-bom: ["error", "always"]*/

var abc;

никогда

Пример правильного кода для этого правила с параметром по умолчанию "never":

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

var abc;

Пример неправильного кода для этого правила с параметром "never":

// U+FEFF at the beginning

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

var abc;

Когда не следует использовать

Если вы используете файлы UTF-16 или UTF-32 и хотите разрешить файлу необязательно начинаться с метки порядка байтов Unicode, вам следует отключить это правило.

Версия

Это правило было добавлено в ESLint v2.11.0.

Ресурсы

• Исходный код правила
• Исходный код тестов