eslint-plugin-sonarjs
Version:
SonarJS rules for ESLint
73 lines (72 loc) • 2.82 kB
JavaScript
;
/*
* SonarQube JavaScript Plugin
* Copyright (C) 2011-2025 SonarSource SA
* mailto:info AT sonarsource DOT com
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the Sonar Source-Available License for more details.
*
* You should have received a copy of the Sonar Source-Available License
* along with this program; if not, see https://sonarsource.com/license/ssal/
*/
// https://sonarsource.github.io/rspec/#/rspec/S1135/javascript
Object.defineProperty(exports, "__esModule", { value: true });
exports.rule = void 0;
exports.reportPatternInComment = reportPatternInComment;
const index_js_1 = require("../helpers/index.js");
const meta_js_1 = require("./meta.js");
const todoPattern = 'todo';
const letterPattern = /[\p{Letter}]/u;
exports.rule = {
meta: (0, index_js_1.generateMeta)(meta_js_1.meta, {
messages: {
completeTODO: 'Complete the task associated to this "TODO" comment.',
},
}),
create(context) {
return {
'Program:exit': () => {
reportPatternInComment(context, todoPattern, 'completeTODO');
},
};
},
};
function reportPatternInComment(context, pattern, messageId) {
const sourceCode = context.sourceCode;
sourceCode.getAllComments().forEach(comment => {
const rawText = comment.value.toLowerCase();
if (rawText.includes(pattern)) {
const lines = rawText.split(/\r\n?|\n/);
for (let i = 0; i < lines.length; i++) {
const index = lines[i].indexOf(pattern);
if (index >= 0 && !isLetterAround(lines[i], index, pattern)) {
context.report({
messageId,
loc: getPatternPosition(i, index, comment, pattern),
});
}
}
}
});
}
function isLetterAround(line, start, pattern) {
const end = start + pattern.length;
const pre = start > 0 && letterPattern.test(line.charAt(start - 1));
const post = end <= line.length - 1 && letterPattern.test(line.charAt(end));
return pre || post;
}
function getPatternPosition(lineIdx, index, comment, pattern) {
const line = comment.loc.start.line + lineIdx;
const columnStart = lineIdx === 0 ? comment.loc.start.column + 2 : 0;
const patternStart = columnStart + index;
return {
start: { line, column: patternStart },
end: { line, column: patternStart + pattern.length },
};
}