2024-08-09 12:04:48 +00:00
|
|
|
/**
|
|
|
|
* @fileoverview Require or disallow Unicode BOM
|
|
|
|
* @author Andrew Johnston <https://github.com/ehjay>
|
|
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
// Rule Definition
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
/** @type {import('../shared/types').Rule} */
|
2024-08-09 12:04:48 +00:00
|
|
|
module.exports = {
|
|
|
|
meta: {
|
|
|
|
type: "layout",
|
|
|
|
|
|
|
|
docs: {
|
2024-08-21 06:34:30 +00:00
|
|
|
description: "Require or disallow Unicode byte order mark (BOM)",
|
2024-08-09 12:04:48 +00:00
|
|
|
recommended: false,
|
2024-08-21 06:34:30 +00:00
|
|
|
url: "https://eslint.org/docs/latest/rules/unicode-bom"
|
2024-08-09 12:04:48 +00:00
|
|
|
},
|
|
|
|
|
|
|
|
fixable: "whitespace",
|
|
|
|
|
|
|
|
schema: [
|
|
|
|
{
|
|
|
|
enum: ["always", "never"]
|
|
|
|
}
|
|
|
|
],
|
|
|
|
messages: {
|
|
|
|
expected: "Expected Unicode BOM (Byte Order Mark).",
|
|
|
|
unexpected: "Unexpected Unicode BOM (Byte Order Mark)."
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
create(context) {
|
|
|
|
|
|
|
|
//--------------------------------------------------------------------------
|
|
|
|
// Public
|
|
|
|
//--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
return {
|
|
|
|
|
|
|
|
Program: function checkUnicodeBOM(node) {
|
|
|
|
|
2024-08-21 06:34:30 +00:00
|
|
|
const sourceCode = context.sourceCode,
|
2024-08-09 12:04:48 +00:00
|
|
|
location = { column: 0, line: 1 },
|
|
|
|
requireBOM = context.options[0] || "never";
|
|
|
|
|
|
|
|
if (!sourceCode.hasBOM && (requireBOM === "always")) {
|
|
|
|
context.report({
|
|
|
|
node,
|
|
|
|
loc: location,
|
|
|
|
messageId: "expected",
|
|
|
|
fix(fixer) {
|
|
|
|
return fixer.insertTextBeforeRange([0, 1], "\uFEFF");
|
|
|
|
}
|
|
|
|
});
|
|
|
|
} else if (sourceCode.hasBOM && (requireBOM === "never")) {
|
|
|
|
context.report({
|
|
|
|
node,
|
|
|
|
loc: location,
|
|
|
|
messageId: "unexpected",
|
|
|
|
fix(fixer) {
|
|
|
|
return fixer.removeRange([-1, 0]);
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
};
|