unicode-bom

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

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

Описание правила

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

Параметры

У этого правила есть строковый параметр:

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

always

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

// U+FEFF at the beginning

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

let abc;

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

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

let abc;

never

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

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

let abc;

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

// U+FEFF at the beginning

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

let abc;

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

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

Версия

Это правило появилось в ESLint v2.11.0.

Материалы

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