You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

232 lines
7.0 KiB

'use strict';
/**
* Translates a multi-argument context.report() call into a single object argument call
* @param {...*} arguments A list of arguments passed to `context.report`
* @returns {MessageDescriptor} A normalized object containing report information
*/
function normalizeMultiArgReportCall() {
// If there is one argument, it is considered to be a new-style call already.
if (arguments.length === 1) {
return arguments[0];
}
// If the second argument is a string, the arguments are interpreted as [node, message, data, fix].
if (typeof arguments[1] === 'string') {
return {
node: arguments[0],
message: arguments[1],
data: arguments[2],
fix: arguments[3],
};
}
// Otherwise, the arguments are interpreted as [node, loc, message, data, fix].
return {
node: arguments[0],
loc: arguments[1],
message: arguments[2],
data: arguments[3],
fix: arguments[4],
};
}
/**
* Normalizes a MessageDescriptor to always have a `loc` with `start` and `end` properties
* @param {MessageDescriptor} descriptor A descriptor for the report from a rule.
* @returns {{start: Location, end: (Location|null)}} An updated location that infers the `start` and `end` properties
* from the `node` of the original descriptor, or infers the `start` from the `loc` of the original descriptor.
*/
function normalizeReportLoc(descriptor) {
if (descriptor.loc) {
if (descriptor.loc.start) {
return descriptor.loc;
}
return { start: descriptor.loc, end: null };
}
return descriptor.node.loc;
}
/**
* Interpolates data placeholders in report messages
* @param {MessageDescriptor} descriptor The report message descriptor.
* @param {Object} messageIds Message IDs from rule metadata
* @returns {{message: string, data: Object}} The interpolated message and data for the descriptor
*/
function normalizeMessagePlaceholders(descriptor, messageIds) {
const message = typeof descriptor.messageId === 'string' ? messageIds[descriptor.messageId] : descriptor.message;
if (!descriptor.data) {
return {
message,
data: typeof descriptor.messageId === 'string' ? {} : null,
};
}
const normalizedData = Object.create(null);
const interpolatedMessage = message.replace(/\{\{\s*([^{}]+?)\s*\}\}/g, (fullMatch, term) => {
if (term in descriptor.data) {
normalizedData[term] = descriptor.data[term];
return descriptor.data[term];
}
return fullMatch;
});
return {
message: interpolatedMessage,
data: Object.freeze(normalizedData),
};
}
function getRuleMeta(rule) {
return typeof rule === 'object' && rule.meta && typeof rule.meta === 'object'
? rule.meta
: {};
}
function getMessageIds(rule) {
const meta = getRuleMeta(rule);
return meta.messages && typeof rule.meta.messages === 'object'
? meta.messages
: {};
}
function getReportNormalizer(rule) {
const messageIds = getMessageIds(rule);
return function normalizeReport() {
const descriptor = normalizeMultiArgReportCall.apply(null, arguments);
const interpolatedMessageAndData = normalizeMessagePlaceholders(descriptor, messageIds);
return {
node: descriptor.node,
message: interpolatedMessageAndData.message,
messageId: typeof descriptor.messageId === 'string' ? descriptor.messageId : null,
data: typeof descriptor.messageId === 'string' ? interpolatedMessageAndData.data : null,
loc: normalizeReportLoc(descriptor),
fix: descriptor.fix,
};
};
}
function getRuleCreateFunc(rule) {
return typeof rule === 'function' ? rule : rule.create;
}
function removeMessageIfMessageIdPresent(reportDescriptor) {
const newDescriptor = Object.assign({}, reportDescriptor);
if (typeof reportDescriptor.messageId === 'string' && typeof reportDescriptor.message === 'string') {
delete newDescriptor.message;
}
return newDescriptor;
}
module.exports = Object.freeze({
filterReports(rule, predicate) {
return Object.freeze({
create(context) {
const filename = context.getFilename();
const sourceCode = context.getSourceCode();
const settings = context.settings;
const options = context.options;
return getRuleCreateFunc(rule)(
Object.freeze(
Object.create(
context,
{
report: {
enumerable: true,
value() {
const reportDescriptor = getReportNormalizer(rule).apply(null, arguments);
if (predicate(reportDescriptor, {
sourceCode, settings, options, filename,
})) {
context.report(removeMessageIfMessageIdPresent(reportDescriptor));
}
},
},
}
)
)
);
},
schema: rule.schema,
meta: getRuleMeta(rule),
});
},
mapReports(rule, iteratee) {
return Object.freeze({
create(context) {
const filename = context.getFilename();
const sourceCode = context.getSourceCode();
const settings = context.settings;
const options = context.options;
return getRuleCreateFunc(rule)(
Object.freeze(
Object.create(
context,
{
report: {
enumerable: true,
value() {
context.report(
removeMessageIfMessageIdPresent(
iteratee(
getReportNormalizer(rule).apply(null, arguments),
{
sourceCode, settings, options, filename,
}
)
)
);
},
},
}
)
)
);
},
schema: rule.schema,
meta: getRuleMeta(rule),
});
},
joinReports(rules) {
return Object.freeze({
create(context) {
return rules
.map(rule => getRuleCreateFunc(rule)(context))
.reduce(
(allListeners, ruleListeners) =>
Object.keys(ruleListeners).reduce(
(combinedListeners, key) => {
const currentListener = combinedListeners[key];
const ruleListener = ruleListeners[key];
if (currentListener) {
return Object.assign({}, combinedListeners, {
[key]() {
currentListener.apply(null, arguments);
ruleListener.apply(null, arguments);
},
});
}
return Object.assign({}, combinedListeners, { [key]: ruleListener });
},
allListeners
),
Object.create(null)
);
},
meta: Object.freeze({
messages: Object.assign.apply(
null,
[Object.create(null)].concat(rules.map(getMessageIds))
),
fixable: 'code',
}),
});
},
});