Linux websever 5.15.0-153-generic #163-Ubuntu SMP Thu Aug 7 16:37:18 UTC 2025 x86_64
Apache/2.4.52 (Ubuntu)
: 192.168.3.70 | : 192.168.1.99
Cant Read [ /etc/named.conf ]
8.1.2-1ubuntu2.23
urlab
www.github.com/MadExploits
Terminal
AUTO ROOT
Adminer
Backdoor Destroyer
Linux Exploit
Lock Shell
Lock File
Create User
CREATE RDP
PHP Mailer
BACKCONNECT
UNLOCK SHELL
HASH IDENTIFIER
CPANEL RESET
CREATE WP USER
README
+ Create Folder
+ Create File
/
var /
www /
html /
cqt /
node_modules /
eslint /
lib /
rules /
[ HOME SHELL ]
Name
Size
Permission
Action
utils
[ DIR ]
drwxr-xr-x
accessor-pairs.js
10.95
KB
-rw-r--r--
array-bracket-newline.js
7.93
KB
-rw-r--r--
array-bracket-spacing.js
7.88
KB
-rw-r--r--
array-callback-return.js
12.6
KB
-rw-r--r--
array-element-newline.js
8.86
KB
-rw-r--r--
arrow-body-style.js
10.12
KB
-rw-r--r--
arrow-parens.js
6.95
KB
-rw-r--r--
arrow-spacing.js
4.51
KB
-rw-r--r--
block-scoped-var.js
3.42
KB
-rw-r--r--
block-spacing.js
5.04
KB
-rw-r--r--
brace-style.js
7.41
KB
-rw-r--r--
callback-return.js
5.74
KB
-rw-r--r--
camelcase.js
10.12
KB
-rw-r--r--
capitalized-comments.js
9.07
KB
-rw-r--r--
class-methods-use-this.js
6.24
KB
-rw-r--r--
comma-dangle.js
11.38
KB
-rw-r--r--
comma-spacing.js
5.75
KB
-rw-r--r--
comma-style.js
10
KB
-rw-r--r--
complexity.js
4.89
KB
-rw-r--r--
computed-property-spacing.js
6.55
KB
-rw-r--r--
consistent-return.js
5.6
KB
-rw-r--r--
consistent-this.js
4.33
KB
-rw-r--r--
constructor-super.js
11.77
KB
-rw-r--r--
curly.js
11.48
KB
-rw-r--r--
default-case-last.js
1.08
KB
-rw-r--r--
default-case.js
2.26
KB
-rw-r--r--
default-param-last.js
1.65
KB
-rw-r--r--
dot-location.js
3.32
KB
-rw-r--r--
dot-notation.js
5.08
KB
-rw-r--r--
eol-last.js
3.48
KB
-rw-r--r--
eqeqeq.js
4.76
KB
-rw-r--r--
for-direction.js
4.11
KB
-rw-r--r--
func-call-spacing.js
8.1
KB
-rw-r--r--
func-name-matching.js
8.63
KB
-rw-r--r--
func-names.js
5.01
KB
-rw-r--r--
func-style.js
5.21
KB
-rw-r--r--
function-call-argument-newline...
4.12
KB
-rw-r--r--
function-paren-newline.js
9.96
KB
-rw-r--r--
generator-star-spacing.js
6.17
KB
-rw-r--r--
getter-return.js
5.62
KB
-rw-r--r--
global-require.js
2.78
KB
-rw-r--r--
grouped-accessor-pairs.js
7.08
KB
-rw-r--r--
guard-for-in.js
1.88
KB
-rw-r--r--
handle-callback-err.js
3.17
KB
-rw-r--r--
id-blacklist.js
6.54
KB
-rw-r--r--
id-denylist.js
6.21
KB
-rw-r--r--
id-length.js
5.48
KB
-rw-r--r--
id-match.js
8.99
KB
-rw-r--r--
implicit-arrow-linebreak.js
3.07
KB
-rw-r--r--
indent-legacy.js
34.88
KB
-rw-r--r--
indent.js
64.92
KB
-rw-r--r--
index.js
17.43
KB
-rw-r--r--
init-declarations.js
3.88
KB
-rw-r--r--
jsx-quotes.js
3.07
KB
-rw-r--r--
key-spacing.js
20.77
KB
-rw-r--r--
keyword-spacing.js
19.94
KB
-rw-r--r--
line-comment-position.js
3.65
KB
-rw-r--r--
linebreak-style.js
3.49
KB
-rw-r--r--
lines-around-comment.js
15.13
KB
-rw-r--r--
lines-around-directive.js
6.85
KB
-rw-r--r--
lines-between-class-members.js
9.89
KB
-rw-r--r--
logical-assignment-operators.j...
18.6
KB
-rw-r--r--
max-classes-per-file.js
1.81
KB
-rw-r--r--
max-depth.js
3.55
KB
-rw-r--r--
max-len.js
13.33
KB
-rw-r--r--
max-lines-per-function.js
5.91
KB
-rw-r--r--
max-lines.js
4.3
KB
-rw-r--r--
max-nested-callbacks.js
2.63
KB
-rw-r--r--
max-params.js
3
KB
-rw-r--r--
max-statements-per-line.js
6.58
KB
-rw-r--r--
max-statements.js
4.47
KB
-rw-r--r--
multiline-comment-style.js
17.96
KB
-rw-r--r--
multiline-ternary.js
6.39
KB
-rw-r--r--
new-cap.js
7.04
KB
-rw-r--r--
new-parens.js
3.09
KB
-rw-r--r--
newline-after-var.js
8.64
KB
-rw-r--r--
newline-before-return.js
6.96
KB
-rw-r--r--
newline-per-chained-call.js
3.79
KB
-rw-r--r--
no-alert.js
3.75
KB
-rw-r--r--
no-array-constructor.js
4.88
KB
-rw-r--r--
no-async-promise-executor.js
1007
B
-rw-r--r--
no-await-in-loop.js
2.44
KB
-rw-r--r--
no-bitwise.js
2.88
KB
-rw-r--r--
no-buffer-constructor.js
1.82
KB
-rw-r--r--
no-caller.js
1.06
KB
-rw-r--r--
no-case-declarations.js
1.82
KB
-rw-r--r--
no-catch-shadow.js
2.45
KB
-rw-r--r--
no-class-assign.js
1.53
KB
-rw-r--r--
no-compare-neg-zero.js
1.62
KB
-rw-r--r--
no-cond-assign.js
4.72
KB
-rw-r--r--
no-confusing-arrow.js
3.16
KB
-rw-r--r--
no-console.js
6.09
KB
-rw-r--r--
no-const-assign.js
1.8
KB
-rw-r--r--
no-constant-binary-expression....
17.72
KB
-rw-r--r--
no-constant-condition.js
4.36
KB
-rw-r--r--
no-constructor-return.js
1.16
KB
-rw-r--r--
no-continue.js
784
B
-rw-r--r--
no-control-regex.js
3.74
KB
-rw-r--r--
no-debugger.js
793
B
-rw-r--r--
no-delete-var.js
852
B
-rw-r--r--
no-div-regex.js
1.22
KB
-rw-r--r--
no-dupe-args.js
1.95
KB
-rw-r--r--
no-dupe-class-members.js
2.82
KB
-rw-r--r--
no-dupe-else-if.js
4.1
KB
-rw-r--r--
no-dupe-keys.js
3.87
KB
-rw-r--r--
no-duplicate-case.js
1.72
KB
-rw-r--r--
no-duplicate-imports.js
9.79
KB
-rw-r--r--
no-else-return.js
13.09
KB
-rw-r--r--
no-empty-character-class.js
1.89
KB
-rw-r--r--
no-empty-function.js
5.22
KB
-rw-r--r--
no-empty-pattern.js
1.8
KB
-rw-r--r--
no-empty-static-block.js
1007
B
-rw-r--r--
no-empty.js
2.39
KB
-rw-r--r--
no-eq-null.js
1.09
KB
-rw-r--r--
no-eval.js
7.34
KB
-rw-r--r--
no-ex-assign.js
1.27
KB
-rw-r--r--
no-extend-native.js
5.29
KB
-rw-r--r--
no-extra-bind.js
5.87
KB
-rw-r--r--
no-extra-boolean-cast.js
10.34
KB
-rw-r--r--
no-extra-label.js
4.17
KB
-rw-r--r--
no-extra-parens.js
42.57
KB
-rw-r--r--
no-extra-semi.js
4.52
KB
-rw-r--r--
no-fallthrough.js
6.8
KB
-rw-r--r--
no-floating-decimal.js
2.51
KB
-rw-r--r--
no-func-assign.js
1.82
KB
-rw-r--r--
no-global-assign.js
2.37
KB
-rw-r--r--
no-implicit-coercion.js
12.3
KB
-rw-r--r--
no-implicit-globals.js
4.52
KB
-rw-r--r--
no-implied-eval.js
4.24
KB
-rw-r--r--
no-import-assign.js
6.03
KB
-rw-r--r--
no-inline-comments.js
2.63
KB
-rw-r--r--
no-inner-declarations.js
3.15
KB
-rw-r--r--
no-invalid-regexp.js
5.82
KB
-rw-r--r--
no-invalid-this.js
4.38
KB
-rw-r--r--
no-irregular-whitespace.js
7.67
KB
-rw-r--r--
no-iterator.js
1.08
KB
-rw-r--r--
no-label-var.js
2.01
KB
-rw-r--r--
no-labels.js
3.29
KB
-rw-r--r--
no-lone-blocks.js
3.24
KB
-rw-r--r--
no-lonely-if.js
3.23
KB
-rw-r--r--
no-loop-func.js
6.87
KB
-rw-r--r--
no-loss-of-precision.js
6.91
KB
-rw-r--r--
no-magic-numbers.js
10.33
KB
-rw-r--r--
no-misleading-character-class....
15.96
KB
-rw-r--r--
no-mixed-operators.js
6.98
KB
-rw-r--r--
no-mixed-requires.js
6.23
KB
-rw-r--r--
no-mixed-spaces-and-tabs.js
3.3
KB
-rw-r--r--
no-multi-assign.js
1.3
KB
-rw-r--r--
no-multi-spaces.js
4.48
KB
-rw-r--r--
no-multi-str.js
1.57
KB
-rw-r--r--
no-multiple-empty-lines.js
5.45
KB
-rw-r--r--
no-native-reassign.js
2.7
KB
-rw-r--r--
no-negated-condition.js
2.37
KB
-rw-r--r--
no-negated-in-lhs.js
1.3
KB
-rw-r--r--
no-nested-ternary.js
960
B
-rw-r--r--
no-new-func.js
2.34
KB
-rw-r--r--
no-new-native-nonconstructor.j...
1.71
KB
-rw-r--r--
no-new-object.js
1.82
KB
-rw-r--r--
no-new-require.js
1.55
KB
-rw-r--r--
no-new-symbol.js
1.69
KB
-rw-r--r--
no-new-wrappers.js
1.43
KB
-rw-r--r--
no-new.js
905
B
-rw-r--r--
no-nonoctal-decimal-escape.js
4.46
KB
-rw-r--r--
no-obj-calls.js
2.41
KB
-rw-r--r--
no-object-constructor.js
2.85
KB
-rw-r--r--
no-octal-escape.js
1.15
KB
-rw-r--r--
no-octal.js
851
B
-rw-r--r--
no-param-reassign.js
6.21
KB
-rw-r--r--
no-path-concat.js
1.96
KB
-rw-r--r--
no-plusplus.js
2.61
KB
-rw-r--r--
no-process-env.js
1.6
KB
-rw-r--r--
no-process-exit.js
1.69
KB
-rw-r--r--
no-promise-executor-return.js
6.52
KB
-rw-r--r--
no-proto.js
1.07
KB
-rw-r--r--
no-prototype-builtins.js
4.61
KB
-rw-r--r--
no-redeclare.js
4.32
KB
-rw-r--r--
no-regex-spaces.js
5.15
KB
-rw-r--r--
no-restricted-exports.js
5.5
KB
-rw-r--r--
no-restricted-globals.js
3.72
KB
-rw-r--r--
no-restricted-imports.js
19.02
KB
-rw-r--r--
no-restricted-modules.js
5.98
KB
-rw-r--r--
no-restricted-properties.js
5.81
KB
-rw-r--r--
no-restricted-syntax.js
1.66
KB
-rw-r--r--
no-return-assign.js
2.21
KB
-rw-r--r--
no-return-await.js
4.35
KB
-rw-r--r--
no-script-url.js
1.48
KB
-rw-r--r--
no-self-assign.js
4.56
KB
-rw-r--r--
no-self-compare.js
1.67
KB
-rw-r--r--
no-sequences.js
3.92
KB
-rw-r--r--
no-setter-return.js
5.59
KB
-rw-r--r--
no-shadow-restricted-names.js
2.61
KB
-rw-r--r--
no-shadow.js
16.95
KB
-rw-r--r--
no-spaced-func.js
2.54
KB
-rw-r--r--
no-sparse-arrays.js
1.45
KB
-rw-r--r--
no-sync.js
1.84
KB
-rw-r--r--
no-tabs.js
2.39
KB
-rw-r--r--
no-template-curly-in-string.js
989
B
-rw-r--r--
no-ternary.js
785
B
-rw-r--r--
no-this-before-super.js
8.83
KB
-rw-r--r--
no-throw-literal.js
1.06
KB
-rw-r--r--
no-trailing-spaces.js
5.91
KB
-rw-r--r--
no-unassigned-vars.js
1.92
KB
-rw-r--r--
no-undef-init.js
2.35
KB
-rw-r--r--
no-undef.js
1.85
KB
-rw-r--r--
no-undefined.js
1.82
KB
-rw-r--r--
no-underscore-dangle.js
9.31
KB
-rw-r--r--
no-unexpected-multiline.js
3.4
KB
-rw-r--r--
no-unmodified-loop-condition.j...
9.8
KB
-rw-r--r--
no-unneeded-ternary.js
5.8
KB
-rw-r--r--
no-unreachable-loop.js
4.96
KB
-rw-r--r--
no-unreachable.js
7.32
KB
-rw-r--r--
no-unsafe-finally.js
3.26
KB
-rw-r--r--
no-unsafe-negation.js
3.88
KB
-rw-r--r--
no-unsafe-optional-chaining.js
5.26
KB
-rw-r--r--
no-unused-expressions.js
5.39
KB
-rw-r--r--
no-unused-labels.js
3.79
KB
-rw-r--r--
no-unused-private-class-member...
6.13
KB
-rw-r--r--
no-unused-vars.js
47.41
KB
-rw-r--r--
no-use-before-define.js
11.59
KB
-rw-r--r--
no-useless-assignment.js
18.88
KB
-rw-r--r--
no-useless-backreference.js
7.48
KB
-rw-r--r--
no-useless-call.js
2.71
KB
-rw-r--r--
no-useless-catch.js
1.28
KB
-rw-r--r--
no-useless-computed-key.js
5.8
KB
-rw-r--r--
no-useless-concat.js
2.9
KB
-rw-r--r--
no-useless-constructor.js
6.82
KB
-rw-r--r--
no-useless-escape.js
10.81
KB
-rw-r--r--
no-useless-rename.js
4.81
KB
-rw-r--r--
no-useless-return.js
11.67
KB
-rw-r--r--
no-var.js
11.19
KB
-rw-r--r--
no-void.js
1.33
KB
-rw-r--r--
no-warning-comments.js
5.54
KB
-rw-r--r--
no-whitespace-before-property....
3.79
KB
-rw-r--r--
no-with.js
757
B
-rw-r--r--
nonblock-statement-body-positi...
4.31
KB
-rw-r--r--
object-curly-newline.js
9.88
KB
-rw-r--r--
object-curly-spacing.js
10.16
KB
-rw-r--r--
object-property-newline.js
3.67
KB
-rw-r--r--
object-shorthand.js
17.59
KB
-rw-r--r--
one-var-declaration-per-line.j...
2.92
KB
-rw-r--r--
one-var.js
17.5
KB
-rw-r--r--
operator-assignment.js
7.36
KB
-rw-r--r--
operator-linebreak.js
8.69
KB
-rw-r--r--
padded-blocks.js
8.7
KB
-rw-r--r--
padding-line-between-statement...
16.59
KB
-rw-r--r--
prefer-arrow-callback.js
11.39
KB
-rw-r--r--
prefer-const.js
15.41
KB
-rw-r--r--
prefer-destructuring.js
8.72
KB
-rw-r--r--
prefer-exponentiation-operator...
6.57
KB
-rw-r--r--
prefer-named-capture-group.js
4.93
KB
-rw-r--r--
prefer-numeric-literals.js
4.4
KB
-rw-r--r--
prefer-object-has-own.js
3.71
KB
-rw-r--r--
prefer-object-spread.js
9.27
KB
-rw-r--r--
prefer-promise-reject-errors.j...
4.51
KB
-rw-r--r--
prefer-reflect.js
3.74
KB
-rw-r--r--
prefer-regex-literals.js
14.05
KB
-rw-r--r--
prefer-rest-params.js
2.96
KB
-rw-r--r--
prefer-spread.js
2.5
KB
-rw-r--r--
prefer-template.js
10.29
KB
-rw-r--r--
quote-props.js
9.89
KB
-rw-r--r--
quotes.js
10.68
KB
-rw-r--r--
radix.js
5.42
KB
-rw-r--r--
require-atomic-updates.js
9.08
KB
-rw-r--r--
require-await.js
4.46
KB
-rw-r--r--
require-unicode-regexp.js
7.57
KB
-rw-r--r--
require-yield.js
1.68
KB
-rw-r--r--
rest-spread-spacing.js
3.65
KB
-rw-r--r--
semi-spacing.js
7.21
KB
-rw-r--r--
semi-style.js
5.12
KB
-rw-r--r--
semi.js
13.01
KB
-rw-r--r--
sort-imports.js
8.4
KB
-rw-r--r--
sort-keys.js
5.74
KB
-rw-r--r--
sort-vars.js
3.24
KB
-rw-r--r--
space-before-blocks.js
6.18
KB
-rw-r--r--
space-before-function-paren.js
5.13
KB
-rw-r--r--
space-in-parens.js
9.1
KB
-rw-r--r--
space-infix-ops.js
5.75
KB
-rw-r--r--
space-unary-ops.js
10.39
KB
-rw-r--r--
spaced-comment.js
10.98
KB
-rw-r--r--
strict.js
8.91
KB
-rw-r--r--
switch-colon-spacing.js
4.59
KB
-rw-r--r--
symbol-description.js
1.66
KB
-rw-r--r--
template-curly-spacing.js
4.24
KB
-rw-r--r--
template-tag-spacing.js
2.99
KB
-rw-r--r--
unicode-bom.js
1.68
KB
-rw-r--r--
use-isnan.js
6.96
KB
-rw-r--r--
valid-typeof.js
4.16
KB
-rw-r--r--
vars-on-top.js
4.2
KB
-rw-r--r--
wrap-iife.js
6.75
KB
-rw-r--r--
wrap-regex.js
2.12
KB
-rw-r--r--
yield-star-spacing.js
3.9
KB
-rw-r--r--
yoda.js
9.48
KB
-rw-r--r--
Delete
Unzip
Zip
${this.title}
Close
Code Editor : multiline-comment-style.js
/** * @fileoverview enforce a particular style for multiline comments * @author Teddy Katz * @deprecated in ESLint v9.3.0 */ "use strict"; const astUtils = require("./utils/ast-utils"); //------------------------------------------------------------------------------ // Rule Definition //------------------------------------------------------------------------------ /** @type {import('../types').Rule.RuleModule} */ module.exports = { meta: { deprecated: { message: "Formatting rules are being moved out of ESLint core.", url: "https://eslint.org/blog/2023/10/deprecating-formatting-rules/", deprecatedSince: "9.3.0", availableUntil: "10.0.0", replacedBy: [ { message: "ESLint Stylistic now maintains deprecated stylistic core rules.", url: "https://eslint.style/guide/migration", plugin: { name: "@stylistic/eslint-plugin", url: "https://eslint.style", }, rule: { name: "multiline-comment-style", url: "https://eslint.style/rules/multiline-comment-style", }, }, ], }, type: "suggestion", docs: { description: "Enforce a particular style for multiline comments", recommended: false, url: "https://eslint.org/docs/latest/rules/multiline-comment-style", }, fixable: "whitespace", schema: { anyOf: [ { type: "array", items: [ { enum: ["starred-block", "bare-block"], }, ], additionalItems: false, }, { type: "array", items: [ { enum: ["separate-lines"], }, { type: "object", properties: { checkJSDoc: { type: "boolean", }, }, additionalProperties: false, }, ], additionalItems: false, }, ], }, messages: { expectedBlock: "Expected a block comment instead of consecutive line comments.", expectedBareBlock: "Expected a block comment without padding stars.", startNewline: "Expected a linebreak after '/*'.", endNewline: "Expected a linebreak before '*/'.", missingStar: "Expected a '*' at the start of this line.", alignment: "Expected this line to be aligned with the start of the comment.", expectedLines: "Expected multiple line comments instead of a block comment.", }, }, create(context) { const sourceCode = context.sourceCode; const option = context.options[0] || "starred-block"; const params = context.options[1] || {}; const checkJSDoc = !!params.checkJSDoc; //---------------------------------------------------------------------- // Helpers //---------------------------------------------------------------------- /** * Checks if a comment line is starred. * @param {string} line A string representing a comment line. * @returns {boolean} Whether or not the comment line is starred. */ function isStarredCommentLine(line) { return /^\s*\*/u.test(line); } /** * Checks if a comment group is in starred-block form. * @param {Token[]} commentGroup A group of comments, containing either multiple line comments or a single block comment. * @returns {boolean} Whether or not the comment group is in starred block form. */ function isStarredBlockComment([firstComment]) { if (firstComment.type !== "Block") { return false; } const lines = firstComment.value.split(astUtils.LINEBREAK_MATCHER); // The first and last lines can only contain whitespace. return ( lines.length > 0 && lines.every((line, i) => (i === 0 || i === lines.length - 1 ? /^\s*$/u : /^\s*\*/u ).test(line), ) ); } /** * Checks if a comment group is in JSDoc form. * @param {Token[]} commentGroup A group of comments, containing either multiple line comments or a single block comment. * @returns {boolean} Whether or not the comment group is in JSDoc form. */ function isJSDocComment([firstComment]) { if (firstComment.type !== "Block") { return false; } const lines = firstComment.value.split(astUtils.LINEBREAK_MATCHER); return ( /^\*\s*$/u.test(lines[0]) && lines.slice(1, -1).every(line => /^\s* /u.test(line)) && /^\s*$/u.test(lines.at(-1)) ); } /** * Processes a comment group that is currently in separate-line form, calculating the offset for each line. * @param {Token[]} commentGroup A group of comments containing multiple line comments. * @returns {string[]} An array of the processed lines. */ function processSeparateLineComments(commentGroup) { const allLinesHaveLeadingSpace = commentGroup .map(({ value }) => value) .filter(line => line.trim().length) .every(line => line.startsWith(" ")); return commentGroup.map(({ value }) => allLinesHaveLeadingSpace ? value.replace(/^ /u, "") : value, ); } /** * Processes a comment group that is currently in starred-block form, calculating the offset for each line. * @param {Token} comment A single block comment token in starred-block form. * @returns {string[]} An array of the processed lines. */ function processStarredBlockComment(comment) { const lines = comment.value .split(astUtils.LINEBREAK_MATCHER) .filter( (line, i, linesArr) => !(i === 0 || i === linesArr.length - 1), ) .map(line => line.replace(/^\s*$/u, "")); const allLinesHaveLeadingSpace = lines .map(line => line.replace(/\s*\*/u, "")) .filter(line => line.trim().length) .every(line => line.startsWith(" ")); return lines.map(line => line.replace( allLinesHaveLeadingSpace ? /\s*\* ?/u : /\s*\*/u, "", ), ); } /** * Processes a comment group that is currently in bare-block form, calculating the offset for each line. * @param {Token} comment A single block comment token in bare-block form. * @returns {string[]} An array of the processed lines. */ function processBareBlockComment(comment) { const lines = comment.value .split(astUtils.LINEBREAK_MATCHER) .map(line => line.replace(/^\s*$/u, "")); const leadingWhitespace = `${sourceCode.text.slice(comment.range[0] - comment.loc.start.column, comment.range[0])} `; let offset = ""; /* * Calculate the offset of the least indented line and use that as the basis for offsetting all the lines. * The first line should not be checked because it is inline with the opening block comment delimiter. */ for (const [i, line] of lines.entries()) { if (!line.trim().length || i === 0) { continue; } const [, lineOffset] = line.match(/^(\s*\*?\s*)/u); if (lineOffset.length < leadingWhitespace.length) { const newOffset = leadingWhitespace.slice( lineOffset.length - leadingWhitespace.length, ); if (newOffset.length > offset.length) { offset = newOffset; } } } return lines.map(line => { const match = line.match(/^(\s*\*?\s*)(.*)/u); const [, lineOffset, lineContents] = match; if (lineOffset.length > leadingWhitespace.length) { return `${lineOffset.slice(leadingWhitespace.length - (offset.length + lineOffset.length))}${lineContents}`; } if (lineOffset.length < leadingWhitespace.length) { return `${lineOffset.slice(leadingWhitespace.length)}${lineContents}`; } return lineContents; }); } /** * Gets a list of comment lines in a group, formatting leading whitespace as necessary. * @param {Token[]} commentGroup A group of comments containing either multiple line comments or a single block comment. * @returns {string[]} A list of comment lines. */ function getCommentLines(commentGroup) { const [firstComment] = commentGroup; if (firstComment.type === "Line") { return processSeparateLineComments(commentGroup); } if (isStarredBlockComment(commentGroup)) { return processStarredBlockComment(firstComment); } return processBareBlockComment(firstComment); } /** * Gets the initial offset (whitespace) from the beginning of a line to a given comment token. * @param {Token} comment The token to check. * @returns {string} The offset from the beginning of a line to the token. */ function getInitialOffset(comment) { return sourceCode.text.slice( comment.range[0] - comment.loc.start.column, comment.range[0], ); } /** * Converts a comment into starred-block form * @param {Token} firstComment The first comment of the group being converted * @param {string[]} commentLinesList A list of lines to appear in the new starred-block comment * @returns {string} A representation of the comment value in starred-block form, excluding start and end markers */ function convertToStarredBlock(firstComment, commentLinesList) { const initialOffset = getInitialOffset(firstComment); return `/*\n${commentLinesList.map(line => `${initialOffset} * ${line}`).join("\n")}\n${initialOffset} */`; } /** * Converts a comment into separate-line form * @param {Token} firstComment The first comment of the group being converted * @param {string[]} commentLinesList A list of lines to appear in the new starred-block comment * @returns {string} A representation of the comment value in separate-line form */ function convertToSeparateLines(firstComment, commentLinesList) { return commentLinesList .map(line => `// ${line}`) .join(`\n${getInitialOffset(firstComment)}`); } /** * Converts a comment into bare-block form * @param {Token} firstComment The first comment of the group being converted * @param {string[]} commentLinesList A list of lines to appear in the new starred-block comment * @returns {string} A representation of the comment value in bare-block form */ function convertToBlock(firstComment, commentLinesList) { return `/* ${commentLinesList.join(`\n${getInitialOffset(firstComment)} `)} */`; } /** * Each method checks a group of comments to see if it's valid according to the given option. * @param {Token[]} commentGroup A list of comments that appear together. This will either contain a single * block comment or multiple line comments. * @returns {void} */ const commentGroupCheckers = { "starred-block"(commentGroup) { const [firstComment] = commentGroup; const commentLines = getCommentLines(commentGroup); if (commentLines.some(value => value.includes("*/"))) { return; } if (commentGroup.length > 1) { context.report({ loc: { start: firstComment.loc.start, end: commentGroup.at(-1).loc.end, }, messageId: "expectedBlock", fix(fixer) { const range = [ firstComment.range[0], commentGroup.at(-1).range[1], ]; return commentLines.some(value => value.startsWith("/"), ) ? null : fixer.replaceTextRange( range, convertToStarredBlock( firstComment, commentLines, ), ); }, }); } else { const lines = firstComment.value.split( astUtils.LINEBREAK_MATCHER, ); const expectedLeadingWhitespace = getInitialOffset(firstComment); const expectedLinePrefix = `${expectedLeadingWhitespace} *`; if (!/^\*?\s*$/u.test(lines[0])) { const start = firstComment.value.startsWith("*") ? firstComment.range[0] + 1 : firstComment.range[0]; context.report({ loc: { start: firstComment.loc.start, end: { line: firstComment.loc.start.line, column: firstComment.loc.start.column + 2, }, }, messageId: "startNewline", fix: fixer => fixer.insertTextAfterRange( [start, start + 2], `\n${expectedLinePrefix}`, ), }); } if (!/^\s*$/u.test(lines.at(-1))) { context.report({ loc: { start: { line: firstComment.loc.end.line, column: firstComment.loc.end.column - 2, }, end: firstComment.loc.end, }, messageId: "endNewline", fix: fixer => fixer.replaceTextRange( [ firstComment.range[1] - 2, firstComment.range[1], ], `\n${expectedLinePrefix}/`, ), }); } for ( let lineNumber = firstComment.loc.start.line + 1; lineNumber <= firstComment.loc.end.line; lineNumber++ ) { const lineText = sourceCode.lines[lineNumber - 1]; const errorType = isStarredCommentLine(lineText) ? "alignment" : "missingStar"; if (!lineText.startsWith(expectedLinePrefix)) { context.report({ loc: { start: { line: lineNumber, column: 0 }, end: { line: lineNumber, column: lineText.length, }, }, messageId: errorType, fix(fixer) { const lineStartIndex = sourceCode.getIndexFromLoc({ line: lineNumber, column: 0, }); if (errorType === "alignment") { const [, commentTextPrefix = ""] = lineText.match(/^(\s*\*)/u) || []; const commentTextStartIndex = lineStartIndex + commentTextPrefix.length; return fixer.replaceTextRange( [ lineStartIndex, commentTextStartIndex, ], expectedLinePrefix, ); } const [, commentTextPrefix = ""] = lineText.match(/^(\s*)/u) || []; const commentTextStartIndex = lineStartIndex + commentTextPrefix.length; let offset; for (const [idx, line] of lines.entries()) { if (!/\S+/u.test(line)) { continue; } const lineTextToAlignWith = sourceCode.lines[ firstComment.loc.start.line - 1 + idx ]; const [ , prefix = "", initialOffset = "", ] = lineTextToAlignWith.match( /^(\s*(?:\/?\*)?(\s*))/u, ) || []; offset = `${commentTextPrefix.slice(prefix.length)}${initialOffset}`; if ( /^\s*\//u.test(lineText) && offset.length === 0 ) { offset += " "; } break; } return fixer.replaceTextRange( [lineStartIndex, commentTextStartIndex], `${expectedLinePrefix}${offset}`, ); }, }); } } } }, "separate-lines"(commentGroup) { const [firstComment] = commentGroup; const isJSDoc = isJSDocComment(commentGroup); if (firstComment.type !== "Block" || (!checkJSDoc && isJSDoc)) { return; } let commentLines = getCommentLines(commentGroup); if (isJSDoc) { commentLines = commentLines.slice( 1, commentLines.length - 1, ); } const tokenAfter = sourceCode.getTokenAfter(firstComment, { includeComments: true, }); if ( tokenAfter && firstComment.loc.end.line === tokenAfter.loc.start.line ) { return; } context.report({ loc: { start: firstComment.loc.start, end: { line: firstComment.loc.start.line, column: firstComment.loc.start.column + 2, }, }, messageId: "expectedLines", fix(fixer) { return fixer.replaceText( firstComment, convertToSeparateLines(firstComment, commentLines), ); }, }); }, "bare-block"(commentGroup) { if (isJSDocComment(commentGroup)) { return; } const [firstComment] = commentGroup; const commentLines = getCommentLines(commentGroup); // Disallows consecutive line comments in favor of using a block comment. if ( firstComment.type === "Line" && commentLines.length > 1 && !commentLines.some(value => value.includes("*/")) ) { context.report({ loc: { start: firstComment.loc.start, end: commentGroup.at(-1).loc.end, }, messageId: "expectedBlock", fix(fixer) { return fixer.replaceTextRange( [ firstComment.range[0], commentGroup.at(-1).range[1], ], convertToBlock(firstComment, commentLines), ); }, }); } // Prohibits block comments from having a * at the beginning of each line. if (isStarredBlockComment(commentGroup)) { context.report({ loc: { start: firstComment.loc.start, end: { line: firstComment.loc.start.line, column: firstComment.loc.start.column + 2, }, }, messageId: "expectedBareBlock", fix(fixer) { return fixer.replaceText( firstComment, convertToBlock(firstComment, commentLines), ); }, }); } }, }; //---------------------------------------------------------------------- // Public //---------------------------------------------------------------------- return { Program() { return sourceCode .getAllComments() .filter(comment => comment.type !== "Shebang") .filter( comment => !astUtils.COMMENTS_IGNORE_PATTERN.test( comment.value, ), ) .filter(comment => { const tokenBefore = sourceCode.getTokenBefore(comment, { includeComments: true, }); return ( !tokenBefore || tokenBefore.loc.end.line < comment.loc.start.line ); }) .reduce((commentGroups, comment, index, commentList) => { const tokenBefore = sourceCode.getTokenBefore(comment, { includeComments: true, }); if ( comment.type === "Line" && index && commentList[index - 1].type === "Line" && tokenBefore && tokenBefore.loc.end.line === comment.loc.start.line - 1 && tokenBefore === commentList[index - 1] ) { commentGroups.at(-1).push(comment); } else { commentGroups.push([comment]); } return commentGroups; }, []) .filter( commentGroup => !( commentGroup.length === 1 && commentGroup[0].loc.start.line === commentGroup[0].loc.end.line ), ) .forEach(commentGroupCheckers[option]); }, }; }, };
Close
