eslint 8.57.1 → 9.39.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +165 -115
- package/bin/eslint.js +112 -89
- package/conf/default-cli-options.js +22 -22
- package/conf/ecma-version.js +16 -0
- package/conf/globals.js +109 -94
- package/conf/replacements.json +24 -20
- package/conf/rule-type-list.json +89 -26
- package/lib/api.js +16 -20
- package/lib/cli-engine/cli-engine.js +841 -810
- package/lib/cli-engine/file-enumerator.js +384 -390
- package/lib/cli-engine/formatters/formatters-meta.json +17 -45
- package/lib/cli-engine/formatters/html.js +110 -102
- package/lib/cli-engine/formatters/json-with-metadata.js +5 -5
- package/lib/cli-engine/formatters/json.js +2 -2
- package/lib/cli-engine/formatters/stylish.js +97 -76
- package/lib/cli-engine/hash.js +1 -1
- package/lib/cli-engine/index.js +1 -1
- package/lib/cli-engine/lint-result-cache.js +165 -148
- package/lib/cli-engine/load-rules.js +17 -17
- package/lib/cli.js +481 -399
- package/lib/config/config-loader.js +816 -0
- package/lib/config/config.js +674 -0
- package/lib/config/default-config.js +57 -46
- package/lib/config/flat-config-array.js +170 -333
- package/lib/config/flat-config-schema.js +389 -389
- package/lib/config-api.js +12 -0
- package/lib/eslint/eslint-helpers.js +1196 -663
- package/lib/eslint/eslint.js +1262 -607
- package/lib/eslint/index.js +3 -3
- package/lib/eslint/legacy-eslint.js +786 -0
- package/lib/eslint/worker.js +173 -0
- package/lib/languages/js/index.js +336 -0
- package/lib/languages/js/source-code/index.js +7 -0
- package/lib/languages/js/source-code/source-code.js +1364 -0
- package/lib/languages/js/source-code/token-store/backward-token-comment-cursor.js +61 -0
- package/lib/languages/js/source-code/token-store/backward-token-cursor.js +57 -0
- package/lib/{source-code → languages/js/source-code}/token-store/cursor.js +36 -36
- package/lib/languages/js/source-code/token-store/cursors.js +120 -0
- package/lib/{source-code → languages/js/source-code}/token-store/decorative-cursor.js +17 -18
- package/lib/{source-code → languages/js/source-code}/token-store/filter-cursor.js +19 -20
- package/lib/languages/js/source-code/token-store/forward-token-comment-cursor.js +65 -0
- package/lib/languages/js/source-code/token-store/forward-token-cursor.js +62 -0
- package/lib/languages/js/source-code/token-store/index.js +721 -0
- package/lib/{source-code → languages/js/source-code}/token-store/limit-cursor.js +17 -18
- package/lib/languages/js/source-code/token-store/padded-token-cursor.js +45 -0
- package/lib/{source-code → languages/js/source-code}/token-store/skip-cursor.js +19 -20
- package/lib/languages/js/source-code/token-store/utils.js +110 -0
- package/lib/languages/js/validate-language-options.js +196 -0
- package/lib/linter/apply-disable-directives.js +490 -371
- package/lib/linter/code-path-analysis/code-path-analyzer.js +650 -674
- package/lib/linter/code-path-analysis/code-path-segment.js +215 -216
- package/lib/linter/code-path-analysis/code-path-state.js +2118 -2096
- package/lib/linter/code-path-analysis/code-path.js +307 -317
- package/lib/linter/code-path-analysis/debug-helpers.js +183 -163
- package/lib/linter/code-path-analysis/fork-context.js +297 -272
- package/lib/linter/code-path-analysis/id-generator.js +22 -23
- package/lib/linter/esquery.js +332 -0
- package/lib/linter/file-context.js +144 -0
- package/lib/linter/file-report.js +608 -0
- package/lib/linter/index.js +3 -5
- package/lib/linter/interpolate.js +38 -16
- package/lib/linter/linter.js +2328 -1785
- package/lib/linter/rule-fixer.js +136 -107
- package/lib/linter/rules.js +37 -46
- package/lib/linter/source-code-fixer.js +96 -94
- package/lib/linter/source-code-traverser.js +333 -0
- package/lib/linter/source-code-visitor.js +81 -0
- package/lib/linter/timing.js +145 -97
- package/lib/linter/vfile.js +115 -0
- package/lib/options.js +464 -326
- package/lib/rule-tester/index.js +3 -1
- package/lib/rule-tester/rule-tester.js +1371 -998
- package/lib/rules/accessor-pairs.js +333 -259
- package/lib/rules/array-bracket-newline.js +250 -220
- package/lib/rules/array-bracket-spacing.js +286 -229
- package/lib/rules/array-callback-return.js +401 -354
- package/lib/rules/array-element-newline.js +358 -295
- package/lib/rules/arrow-body-style.js +400 -278
- package/lib/rules/arrow-parens.js +206 -155
- package/lib/rules/arrow-spacing.js +169 -145
- package/lib/rules/block-scoped-var.js +125 -123
- package/lib/rules/block-spacing.js +186 -158
- package/lib/rules/brace-style.js +262 -181
- package/lib/rules/callback-return.js +203 -174
- package/lib/rules/camelcase.js +403 -380
- package/lib/rules/capitalized-comments.js +253 -228
- package/lib/rules/class-methods-use-this.js +231 -168
- package/lib/rules/comma-dangle.js +379 -328
- package/lib/rules/comma-spacing.js +193 -177
- package/lib/rules/comma-style.js +375 -298
- package/lib/rules/complexity.js +180 -144
- package/lib/rules/computed-property-spacing.js +236 -193
- package/lib/rules/consistent-return.js +181 -170
- package/lib/rules/consistent-this.js +167 -141
- package/lib/rules/constructor-super.js +418 -411
- package/lib/rules/curly.js +407 -468
- package/lib/rules/default-case-last.js +39 -32
- package/lib/rules/default-case.js +89 -83
- package/lib/rules/default-param-last.js +69 -53
- package/lib/rules/dot-location.js +122 -92
- package/lib/rules/dot-notation.js +193 -153
- package/lib/rules/eol-last.js +122 -102
- package/lib/rules/eqeqeq.js +191 -155
- package/lib/rules/for-direction.js +150 -122
- package/lib/rules/func-call-spacing.js +261 -213
- package/lib/rules/func-name-matching.js +294 -209
- package/lib/rules/func-names.js +165 -164
- package/lib/rules/func-style.js +209 -86
- package/lib/rules/function-call-argument-newline.js +152 -111
- package/lib/rules/function-paren-newline.js +349 -273
- package/lib/rules/generator-star-spacing.js +229 -192
- package/lib/rules/getter-return.js +208 -170
- package/lib/rules/global-require.js +85 -58
- package/lib/rules/grouped-accessor-pairs.js +201 -148
- package/lib/rules/guard-for-in.js +72 -63
- package/lib/rules/handle-callback-err.js +108 -87
- package/lib/rules/id-blacklist.js +182 -187
- package/lib/rules/id-denylist.js +174 -179
- package/lib/rules/id-length.js +197 -157
- package/lib/rules/id-match.js +350 -286
- package/lib/rules/implicit-arrow-linebreak.js +102 -61
- package/lib/rules/indent-legacy.js +1345 -1102
- package/lib/rules/indent.js +2272 -1741
- package/lib/rules/index.js +320 -294
- package/lib/rules/init-declarations.js +139 -106
- package/lib/rules/jsx-quotes.js +94 -64
- package/lib/rules/key-spacing.js +750 -615
- package/lib/rules/keyword-spacing.js +648 -587
- package/lib/rules/line-comment-position.js +143 -108
- package/lib/rules/linebreak-style.js +115 -88
- package/lib/rules/lines-around-comment.js +540 -430
- package/lib/rules/lines-around-directive.js +233 -185
- package/lib/rules/lines-between-class-members.js +305 -216
- package/lib/rules/logical-assignment-operators.js +582 -398
- package/lib/rules/max-classes-per-file.js +69 -68
- package/lib/rules/max-depth.js +146 -143
- package/lib/rules/max-len.js +473 -416
- package/lib/rules/max-lines-per-function.js +201 -176
- package/lib/rules/max-lines.js +158 -162
- package/lib/rules/max-nested-callbacks.js +102 -104
- package/lib/rules/max-params.js +102 -75
- package/lib/rules/max-statements-per-line.js +205 -180
- package/lib/rules/max-statements.js +168 -164
- package/lib/rules/multiline-comment-style.js +638 -460
- package/lib/rules/multiline-ternary.js +241 -158
- package/lib/rules/new-cap.js +233 -232
- package/lib/rules/new-parens.js +88 -61
- package/lib/rules/newline-after-var.js +287 -233
- package/lib/rules/newline-before-return.js +229 -204
- package/lib/rules/newline-per-chained-call.js +142 -109
- package/lib/rules/no-alert.js +90 -79
- package/lib/rules/no-array-constructor.js +175 -113
- package/lib/rules/no-async-promise-executor.js +30 -24
- package/lib/rules/no-await-in-loop.js +79 -70
- package/lib/rules/no-bitwise.js +113 -87
- package/lib/rules/no-buffer-constructor.js +61 -37
- package/lib/rules/no-caller.js +39 -33
- package/lib/rules/no-case-declarations.js +61 -45
- package/lib/rules/no-catch-shadow.js +76 -62
- package/lib/rules/no-class-assign.js +51 -48
- package/lib/rules/no-compare-neg-zero.js +62 -48
- package/lib/rules/no-cond-assign.js +148 -132
- package/lib/rules/no-confusing-arrow.js +98 -63
- package/lib/rules/no-console.js +202 -188
- package/lib/rules/no-const-assign.js +58 -41
- package/lib/rules/no-constant-binary-expression.js +501 -407
- package/lib/rules/no-constant-condition.js +158 -131
- package/lib/rules/no-constructor-return.js +49 -49
- package/lib/rules/no-continue.js +25 -26
- package/lib/rules/no-control-regex.js +125 -121
- package/lib/rules/no-debugger.js +28 -30
- package/lib/rules/no-delete-var.js +29 -29
- package/lib/rules/no-div-regex.js +47 -40
- package/lib/rules/no-dupe-args.js +79 -69
- package/lib/rules/no-dupe-class-members.js +102 -89
- package/lib/rules/no-dupe-else-if.js +100 -77
- package/lib/rules/no-dupe-keys.js +133 -110
- package/lib/rules/no-duplicate-case.js +50 -43
- package/lib/rules/no-duplicate-imports.js +266 -188
- package/lib/rules/no-else-return.js +430 -385
- package/lib/rules/no-empty-character-class.js +57 -50
- package/lib/rules/no-empty-function.js +197 -128
- package/lib/rules/no-empty-pattern.js +63 -56
- package/lib/rules/no-empty-static-block.js +61 -35
- package/lib/rules/no-empty.js +135 -85
- package/lib/rules/no-eq-null.js +37 -32
- package/lib/rules/no-eval.js +258 -249
- package/lib/rules/no-ex-assign.js +42 -39
- package/lib/rules/no-extend-native.js +161 -160
- package/lib/rules/no-extra-bind.js +201 -190
- package/lib/rules/no-extra-boolean-cast.js +398 -295
- package/lib/rules/no-extra-label.js +150 -130
- package/lib/rules/no-extra-parens.js +1654 -1307
- package/lib/rules/no-extra-semi.js +146 -126
- package/lib/rules/no-fallthrough.js +200 -136
- package/lib/rules/no-floating-decimal.js +74 -48
- package/lib/rules/no-func-assign.js +54 -55
- package/lib/rules/no-global-assign.js +78 -72
- package/lib/rules/no-implicit-coercion.js +350 -262
- package/lib/rules/no-implicit-globals.js +174 -133
- package/lib/rules/no-implied-eval.js +150 -112
- package/lib/rules/no-import-assign.js +145 -159
- package/lib/rules/no-inline-comments.js +101 -96
- package/lib/rules/no-inner-declarations.js +115 -78
- package/lib/rules/no-invalid-regexp.js +223 -174
- package/lib/rules/no-invalid-this.js +145 -117
- package/lib/rules/no-irregular-whitespace.js +266 -250
- package/lib/rules/no-iterator.js +29 -33
- package/lib/rules/no-label-var.js +59 -61
- package/lib/rules/no-labels.js +138 -131
- package/lib/rules/no-lone-blocks.js +127 -123
- package/lib/rules/no-lonely-if.js +105 -67
- package/lib/rules/no-loop-func.js +245 -184
- package/lib/rules/no-loss-of-precision.js +236 -201
- package/lib/rules/no-magic-numbers.js +339 -217
- package/lib/rules/no-misleading-character-class.js +548 -253
- package/lib/rules/no-mixed-operators.js +188 -164
- package/lib/rules/no-mixed-requires.js +253 -224
- package/lib/rules/no-mixed-spaces-and-tabs.js +135 -103
- package/lib/rules/no-multi-assign.js +46 -47
- package/lib/rules/no-multi-spaces.js +163 -125
- package/lib/rules/no-multi-str.js +42 -40
- package/lib/rules/no-multiple-empty-lines.js +196 -140
- package/lib/rules/no-native-reassign.js +90 -74
- package/lib/rules/no-negated-condition.js +79 -74
- package/lib/rules/no-negated-in-lhs.js +45 -32
- package/lib/rules/no-nested-ternary.js +33 -31
- package/lib/rules/no-new-func.js +71 -62
- package/lib/rules/no-new-native-nonconstructor.js +43 -39
- package/lib/rules/no-new-object.js +48 -39
- package/lib/rules/no-new-require.js +48 -31
- package/lib/rules/no-new-symbol.js +61 -43
- package/lib/rules/no-new-wrappers.js +43 -41
- package/lib/rules/no-new.js +28 -29
- package/lib/rules/no-nonoctal-decimal-escape.js +149 -121
- package/lib/rules/no-obj-calls.js +66 -53
- package/lib/rules/no-object-constructor.js +104 -97
- package/lib/rules/no-octal-escape.js +40 -43
- package/lib/rules/no-octal.js +29 -32
- package/lib/rules/no-param-reassign.js +236 -218
- package/lib/rules/no-path-concat.js +66 -51
- package/lib/rules/no-plusplus.js +60 -63
- package/lib/rules/no-process-env.js +49 -32
- package/lib/rules/no-process-exit.js +48 -28
- package/lib/rules/no-promise-executor-return.js +205 -204
- package/lib/rules/no-proto.js +26 -29
- package/lib/rules/no-prototype-builtins.js +146 -124
- package/lib/rules/no-redeclare.js +154 -155
- package/lib/rules/no-regex-spaces.js +183 -161
- package/lib/rules/no-restricted-exports.js +208 -174
- package/lib/rules/no-restricted-globals.js +254 -112
- package/lib/rules/no-restricted-imports.js +824 -384
- package/lib/rules/no-restricted-modules.js +222 -186
- package/lib/rules/no-restricted-properties.js +218 -153
- package/lib/rules/no-restricted-syntax.js +56 -52
- package/lib/rules/no-return-assign.js +56 -49
- package/lib/rules/no-return-await.js +147 -120
- package/lib/rules/no-script-url.js +53 -46
- package/lib/rules/no-self-assign.js +148 -145
- package/lib/rules/no-self-compare.js +63 -46
- package/lib/rules/no-sequences.js +135 -115
- package/lib/rules/no-setter-return.js +176 -178
- package/lib/rules/no-shadow-restricted-names.js +84 -36
- package/lib/rules/no-shadow.js +598 -310
- package/lib/rules/no-spaced-func.js +82 -60
- package/lib/rules/no-sparse-arrays.js +46 -28
- package/lib/rules/no-sync.js +61 -44
- package/lib/rules/no-tabs.js +83 -54
- package/lib/rules/no-template-curly-in-string.js +33 -32
- package/lib/rules/no-ternary.js +25 -28
- package/lib/rules/no-this-before-super.js +332 -298
- package/lib/rules/no-throw-literal.js +31 -36
- package/lib/rules/no-trailing-spaces.js +208 -174
- package/lib/rules/no-unassigned-vars.js +80 -0
- package/lib/rules/no-undef-init.js +86 -60
- package/lib/rules/no-undef.js +52 -47
- package/lib/rules/no-undefined.js +73 -74
- package/lib/rules/no-underscore-dangle.js +370 -322
- package/lib/rules/no-unexpected-multiline.js +112 -102
- package/lib/rules/no-unmodified-loop-condition.js +254 -254
- package/lib/rules/no-unneeded-ternary.js +212 -146
- package/lib/rules/no-unreachable-loop.js +145 -140
- package/lib/rules/no-unreachable.js +255 -248
- package/lib/rules/no-unsafe-finally.js +93 -85
- package/lib/rules/no-unsafe-negation.js +105 -81
- package/lib/rules/no-unsafe-optional-chaining.js +193 -177
- package/lib/rules/no-unused-expressions.js +199 -158
- package/lib/rules/no-unused-labels.js +139 -124
- package/lib/rules/no-unused-private-class-members.js +206 -182
- package/lib/rules/no-unused-vars.js +1708 -687
- package/lib/rules/no-use-before-define.js +327 -229
- package/lib/rules/no-useless-assignment.js +654 -0
- package/lib/rules/no-useless-backreference.js +212 -143
- package/lib/rules/no-useless-call.js +58 -53
- package/lib/rules/no-useless-catch.js +40 -40
- package/lib/rules/no-useless-computed-key.js +144 -108
- package/lib/rules/no-useless-concat.js +65 -59
- package/lib/rules/no-useless-constructor.js +160 -97
- package/lib/rules/no-useless-escape.js +364 -291
- package/lib/rules/no-useless-rename.js +183 -153
- package/lib/rules/no-useless-return.js +344 -307
- package/lib/rules/no-var.js +245 -212
- package/lib/rules/no-void.js +51 -46
- package/lib/rules/no-warning-comments.js +191 -183
- package/lib/rules/no-whitespace-before-property.js +131 -97
- package/lib/rules/no-with.js +24 -26
- package/lib/rules/nonblock-statement-body-position.js +149 -112
- package/lib/rules/object-curly-newline.js +306 -247
- package/lib/rules/object-curly-spacing.js +360 -296
- package/lib/rules/object-property-newline.js +137 -88
- package/lib/rules/object-shorthand.js +632 -500
- package/lib/rules/one-var-declaration-per-line.js +104 -82
- package/lib/rules/one-var.js +686 -536
- package/lib/rules/operator-assignment.js +219 -158
- package/lib/rules/operator-linebreak.js +295 -233
- package/lib/rules/padded-blocks.js +346 -290
- package/lib/rules/padding-line-between-statements.js +443 -421
- package/lib/rules/prefer-arrow-callback.js +371 -315
- package/lib/rules/prefer-const.js +418 -373
- package/lib/rules/prefer-destructuring.js +309 -278
- package/lib/rules/prefer-exponentiation-operator.js +176 -132
- package/lib/rules/prefer-named-capture-group.js +160 -141
- package/lib/rules/prefer-numeric-literals.js +121 -112
- package/lib/rules/prefer-object-has-own.js +116 -82
- package/lib/rules/prefer-object-spread.js +214 -193
- package/lib/rules/prefer-promise-reject-errors.js +140 -118
- package/lib/rules/prefer-reflect.js +126 -103
- package/lib/rules/prefer-regex-literals.js +561 -463
- package/lib/rules/prefer-rest-params.js +79 -80
- package/lib/rules/prefer-spread.js +47 -43
- package/lib/rules/prefer-template.js +266 -194
- package/lib/rules/preserve-caught-error.js +535 -0
- package/lib/rules/quote-props.js +373 -289
- package/lib/rules/quotes.js +374 -308
- package/lib/rules/radix.js +152 -134
- package/lib/rules/require-atomic-updates.js +316 -282
- package/lib/rules/require-await.js +153 -82
- package/lib/rules/require-unicode-regexp.js +296 -108
- package/lib/rules/require-yield.js +53 -54
- package/lib/rules/rest-spread-spacing.js +128 -98
- package/lib/rules/semi-spacing.js +281 -232
- package/lib/rules/semi-style.js +176 -116
- package/lib/rules/semi.js +456 -418
- package/lib/rules/sort-imports.js +307 -229
- package/lib/rules/sort-keys.js +219 -181
- package/lib/rules/sort-vars.js +127 -91
- package/lib/rules/space-before-blocks.js +199 -171
- package/lib/rules/space-before-function-paren.js +186 -148
- package/lib/rules/space-in-parens.js +359 -270
- package/lib/rules/space-infix-ops.js +237 -183
- package/lib/rules/space-unary-ops.js +356 -280
- package/lib/rules/spaced-comment.js +363 -301
- package/lib/rules/strict.js +266 -229
- package/lib/rules/switch-colon-spacing.js +130 -104
- package/lib/rules/symbol-description.js +45 -48
- package/lib/rules/template-curly-spacing.js +148 -124
- package/lib/rules/template-tag-spacing.js +98 -70
- package/lib/rules/unicode-bom.js +54 -54
- package/lib/rules/use-isnan.js +237 -110
- package/lib/rules/utils/ast-utils.js +2139 -1688
- package/lib/rules/utils/char-source.js +247 -0
- package/lib/rules/utils/fix-tracker.js +99 -88
- package/lib/rules/utils/keywords.js +59 -59
- package/lib/rules/utils/lazy-loading-rule-map.js +81 -78
- package/lib/rules/utils/regular-expressions.js +35 -19
- package/lib/rules/utils/unicode/index.js +9 -4
- package/lib/rules/utils/unicode/is-combining-character.js +1 -1
- package/lib/rules/utils/unicode/is-emoji-modifier.js +1 -1
- package/lib/rules/utils/unicode/is-regional-indicator-symbol.js +1 -1
- package/lib/rules/utils/unicode/is-surrogate-pair.js +1 -1
- package/lib/rules/valid-typeof.js +153 -109
- package/lib/rules/vars-on-top.js +152 -144
- package/lib/rules/wrap-iife.js +204 -173
- package/lib/rules/wrap-regex.js +77 -47
- package/lib/rules/yield-star-spacing.js +145 -116
- package/lib/rules/yoda.js +283 -274
- package/lib/services/parser-service.js +65 -0
- package/lib/services/processor-service.js +101 -0
- package/lib/services/suppressions-service.js +302 -0
- package/lib/services/warning-service.js +98 -0
- package/lib/shared/ajv.js +14 -14
- package/lib/shared/assert.js +21 -0
- package/lib/shared/ast-utils.js +7 -6
- package/lib/shared/deep-merge-arrays.js +62 -0
- package/lib/shared/directives.js +3 -2
- package/lib/shared/flags.js +108 -0
- package/lib/shared/logging.js +24 -16
- package/lib/shared/naming.js +109 -0
- package/lib/shared/option-utils.js +63 -0
- package/lib/shared/relative-module-resolver.js +18 -40
- package/lib/shared/runtime-info.js +138 -128
- package/lib/shared/serialization.js +78 -0
- package/lib/shared/severity.js +22 -22
- package/lib/shared/stats.js +30 -0
- package/lib/shared/string-utils.js +19 -21
- package/lib/shared/text-table.js +68 -0
- package/lib/shared/translate-cli-options.js +281 -0
- package/lib/shared/traverser.js +153 -146
- package/lib/types/config-api.d.ts +12 -0
- package/lib/types/index.d.ts +1473 -0
- package/lib/types/rules.d.ts +5589 -0
- package/lib/types/universal.d.ts +6 -0
- package/lib/types/use-at-your-own-risk.d.ts +87 -0
- package/lib/universal.js +10 -0
- package/lib/unsupported-api.js +8 -9
- package/messages/all-files-ignored.js +3 -3
- package/messages/all-matched-files-ignored.js +21 -0
- package/messages/config-file-missing.js +16 -0
- package/messages/config-plugin-missing.js +14 -0
- package/messages/config-serialize-function.js +30 -0
- package/messages/eslintrc-incompat.js +35 -16
- package/messages/eslintrc-plugins.js +8 -5
- package/messages/extend-config-missing.js +3 -3
- package/messages/failed-to-read-json.js +3 -3
- package/messages/file-not-found.js +3 -3
- package/messages/invalid-rule-options.js +2 -2
- package/messages/invalid-rule-severity.js +2 -2
- package/messages/no-config-found.js +4 -4
- package/messages/plugin-conflict.js +9 -9
- package/messages/plugin-invalid.js +4 -4
- package/messages/plugin-missing.js +4 -4
- package/messages/print-config-with-directory-path.js +2 -2
- package/messages/shared.js +6 -1
- package/messages/whitespace-found.js +3 -3
- package/package.json +105 -60
- package/conf/config-schema.js +0 -93
- package/lib/cli-engine/formatters/checkstyle.js +0 -60
- package/lib/cli-engine/formatters/compact.js +0 -60
- package/lib/cli-engine/formatters/jslint-xml.js +0 -41
- package/lib/cli-engine/formatters/junit.js +0 -82
- package/lib/cli-engine/formatters/tap.js +0 -95
- package/lib/cli-engine/formatters/unix.js +0 -58
- package/lib/cli-engine/formatters/visualstudio.js +0 -63
- package/lib/cli-engine/xml-escape.js +0 -34
- package/lib/config/flat-config-helpers.js +0 -111
- package/lib/config/rule-validator.js +0 -158
- package/lib/eslint/flat-eslint.js +0 -1159
- package/lib/linter/config-comment-parser.js +0 -185
- package/lib/linter/node-event-generator.js +0 -354
- package/lib/linter/report-translator.js +0 -369
- package/lib/linter/safe-emitter.js +0 -52
- package/lib/rule-tester/flat-rule-tester.js +0 -1131
- package/lib/rules/require-jsdoc.js +0 -122
- package/lib/rules/utils/patterns/letters.js +0 -36
- package/lib/rules/valid-jsdoc.js +0 -516
- package/lib/shared/config-validator.js +0 -347
- package/lib/shared/deprecation-warnings.js +0 -58
- package/lib/shared/types.js +0 -216
- package/lib/source-code/index.js +0 -5
- package/lib/source-code/source-code.js +0 -1055
- package/lib/source-code/token-store/backward-token-comment-cursor.js +0 -57
- package/lib/source-code/token-store/backward-token-cursor.js +0 -58
- package/lib/source-code/token-store/cursors.js +0 -90
- package/lib/source-code/token-store/forward-token-comment-cursor.js +0 -57
- package/lib/source-code/token-store/forward-token-cursor.js +0 -63
- package/lib/source-code/token-store/index.js +0 -627
- package/lib/source-code/token-store/padded-token-cursor.js +0 -38
- package/lib/source-code/token-store/utils.js +0 -107
|
@@ -15,21 +15,20 @@
|
|
|
15
15
|
// Requirements
|
|
16
16
|
//------------------------------------------------------------------------------
|
|
17
17
|
|
|
18
|
-
const fs = require("fs");
|
|
19
|
-
const path = require("path");
|
|
18
|
+
const fs = require("node:fs");
|
|
19
|
+
const path = require("node:path");
|
|
20
20
|
const defaultOptions = require("../../conf/default-cli-options");
|
|
21
21
|
const pkg = require("../../package.json");
|
|
22
22
|
|
|
23
|
-
|
|
24
23
|
const {
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
24
|
+
Legacy: {
|
|
25
|
+
ConfigOps,
|
|
26
|
+
naming,
|
|
27
|
+
CascadingConfigArrayFactory,
|
|
28
|
+
IgnorePattern,
|
|
29
|
+
getUsedExtractedConfigs,
|
|
30
|
+
ModuleResolver,
|
|
31
|
+
},
|
|
33
32
|
} = require("@eslint/eslintrc");
|
|
34
33
|
|
|
35
34
|
const { FileEnumerator } = require("./file-enumerator");
|
|
@@ -41,6 +40,17 @@ const hash = require("./hash");
|
|
|
41
40
|
const LintResultCache = require("./lint-result-cache");
|
|
42
41
|
|
|
43
42
|
const debug = require("debug")("eslint:cli-engine");
|
|
43
|
+
const removedFormatters = new Set([
|
|
44
|
+
"checkstyle",
|
|
45
|
+
"codeframe",
|
|
46
|
+
"compact",
|
|
47
|
+
"jslint-xml",
|
|
48
|
+
"junit",
|
|
49
|
+
"table",
|
|
50
|
+
"tap",
|
|
51
|
+
"unix",
|
|
52
|
+
"visualstudio",
|
|
53
|
+
]);
|
|
44
54
|
const validFixTypes = new Set(["directive", "problem", "suggestion", "layout"]);
|
|
45
55
|
|
|
46
56
|
//------------------------------------------------------------------------------
|
|
@@ -48,15 +58,15 @@ const validFixTypes = new Set(["directive", "problem", "suggestion", "layout"]);
|
|
|
48
58
|
//------------------------------------------------------------------------------
|
|
49
59
|
|
|
50
60
|
// For VSCode IntelliSense
|
|
51
|
-
/** @typedef {import("../
|
|
52
|
-
/** @typedef {import("../
|
|
53
|
-
/** @typedef {import("../
|
|
54
|
-
/** @typedef {import("../
|
|
55
|
-
/** @typedef {import("../
|
|
56
|
-
/** @typedef {import("../
|
|
57
|
-
/** @typedef {import("../
|
|
58
|
-
/** @typedef {import("../
|
|
59
|
-
/** @typedef {import("../
|
|
61
|
+
/** @typedef {import("../types").ESLint.ConfigData} ConfigData */
|
|
62
|
+
/** @typedef {import("../types").ESLint.DeprecatedRuleUse} DeprecatedRuleInfo */
|
|
63
|
+
/** @typedef {import("../types").ESLint.FormatterFunction} FormatterFunction */
|
|
64
|
+
/** @typedef {import("../types").Linter.LintMessage} LintMessage */
|
|
65
|
+
/** @typedef {import("../types").Linter.ParserOptions} ParserOptions */
|
|
66
|
+
/** @typedef {import("../types").ESLint.Plugin} Plugin */
|
|
67
|
+
/** @typedef {import("../types").Rule.RuleModule} Rule */
|
|
68
|
+
/** @typedef {import("../types").Linter.RuleEntry} RuleConf */
|
|
69
|
+
/** @typedef {import("../types").Linter.SuppressedLintMessage} SuppressedLintMessage */
|
|
60
70
|
/** @typedef {ReturnType<CascadingConfigArrayFactory.getConfigArrayForFile>} ConfigArray */
|
|
61
71
|
/** @typedef {ReturnType<ConfigArray.extractConfig>} ExtractedConfig */
|
|
62
72
|
|
|
@@ -144,11 +154,11 @@ const internalSlotsMap = new WeakMap();
|
|
|
144
154
|
* @throws {Error} If an invalid fix type is found.
|
|
145
155
|
*/
|
|
146
156
|
function validateFixTypes(fixTypes) {
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
157
|
+
for (const fixType of fixTypes) {
|
|
158
|
+
if (!validFixTypes.has(fixType)) {
|
|
159
|
+
throw new Error(`Invalid fix type "${fixType}" found.`);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
152
162
|
}
|
|
153
163
|
|
|
154
164
|
/**
|
|
@@ -158,33 +168,33 @@ function validateFixTypes(fixTypes) {
|
|
|
158
168
|
* @private
|
|
159
169
|
*/
|
|
160
170
|
function calculateStatsPerFile(messages) {
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
171
|
+
const stat = {
|
|
172
|
+
errorCount: 0,
|
|
173
|
+
fatalErrorCount: 0,
|
|
174
|
+
warningCount: 0,
|
|
175
|
+
fixableErrorCount: 0,
|
|
176
|
+
fixableWarningCount: 0,
|
|
177
|
+
};
|
|
178
|
+
|
|
179
|
+
for (let i = 0; i < messages.length; i++) {
|
|
180
|
+
const message = messages[i];
|
|
181
|
+
|
|
182
|
+
if (message.fatal || message.severity === 2) {
|
|
183
|
+
stat.errorCount++;
|
|
184
|
+
if (message.fatal) {
|
|
185
|
+
stat.fatalErrorCount++;
|
|
186
|
+
}
|
|
187
|
+
if (message.fix) {
|
|
188
|
+
stat.fixableErrorCount++;
|
|
189
|
+
}
|
|
190
|
+
} else {
|
|
191
|
+
stat.warningCount++;
|
|
192
|
+
if (message.fix) {
|
|
193
|
+
stat.fixableWarningCount++;
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
return stat;
|
|
188
198
|
}
|
|
189
199
|
|
|
190
200
|
/**
|
|
@@ -194,25 +204,25 @@ function calculateStatsPerFile(messages) {
|
|
|
194
204
|
* @private
|
|
195
205
|
*/
|
|
196
206
|
function calculateStatsPerRun(results) {
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
207
|
+
const stat = {
|
|
208
|
+
errorCount: 0,
|
|
209
|
+
fatalErrorCount: 0,
|
|
210
|
+
warningCount: 0,
|
|
211
|
+
fixableErrorCount: 0,
|
|
212
|
+
fixableWarningCount: 0,
|
|
213
|
+
};
|
|
214
|
+
|
|
215
|
+
for (let i = 0; i < results.length; i++) {
|
|
216
|
+
const result = results[i];
|
|
217
|
+
|
|
218
|
+
stat.errorCount += result.errorCount;
|
|
219
|
+
stat.fatalErrorCount += result.fatalErrorCount;
|
|
220
|
+
stat.warningCount += result.warningCount;
|
|
221
|
+
stat.fixableErrorCount += result.fixableErrorCount;
|
|
222
|
+
stat.fixableWarningCount += result.fixableWarningCount;
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
return stat;
|
|
216
226
|
}
|
|
217
227
|
|
|
218
228
|
/**
|
|
@@ -231,65 +241,62 @@ function calculateStatsPerRun(results) {
|
|
|
231
241
|
* @private
|
|
232
242
|
*/
|
|
233
243
|
function verifyText({
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
244
|
+
text,
|
|
245
|
+
cwd,
|
|
246
|
+
filePath: providedFilePath,
|
|
247
|
+
config,
|
|
248
|
+
fix,
|
|
249
|
+
allowInlineConfig,
|
|
250
|
+
reportUnusedDisableDirectives,
|
|
251
|
+
fileEnumerator,
|
|
252
|
+
linter,
|
|
243
253
|
}) {
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
}
|
|
291
|
-
|
|
292
|
-
return result;
|
|
254
|
+
const filePath = providedFilePath || "<text>";
|
|
255
|
+
|
|
256
|
+
debug(`Lint ${filePath}`);
|
|
257
|
+
|
|
258
|
+
/*
|
|
259
|
+
* Verify.
|
|
260
|
+
* `config.extractConfig(filePath)` requires an absolute path, but `linter`
|
|
261
|
+
* doesn't know CWD, so it gives `linter` an absolute path always.
|
|
262
|
+
*/
|
|
263
|
+
const filePathToVerify =
|
|
264
|
+
filePath === "<text>" ? path.join(cwd, filePath) : filePath;
|
|
265
|
+
const { fixed, messages, output } = linter.verifyAndFix(text, config, {
|
|
266
|
+
allowInlineConfig,
|
|
267
|
+
filename: filePathToVerify,
|
|
268
|
+
fix,
|
|
269
|
+
reportUnusedDisableDirectives,
|
|
270
|
+
|
|
271
|
+
/**
|
|
272
|
+
* Check if the linter should adopt a given code block or not.
|
|
273
|
+
* @param {string} blockFilename The virtual filename of a code block.
|
|
274
|
+
* @returns {boolean} `true` if the linter should adopt the code block.
|
|
275
|
+
*/
|
|
276
|
+
filterCodeBlock(blockFilename) {
|
|
277
|
+
return fileEnumerator.isTargetPath(blockFilename);
|
|
278
|
+
},
|
|
279
|
+
});
|
|
280
|
+
|
|
281
|
+
// Tweak and return.
|
|
282
|
+
const result = {
|
|
283
|
+
filePath,
|
|
284
|
+
messages,
|
|
285
|
+
suppressedMessages: linter.getSuppressedMessages(),
|
|
286
|
+
...calculateStatsPerFile(messages),
|
|
287
|
+
};
|
|
288
|
+
|
|
289
|
+
if (fixed) {
|
|
290
|
+
result.output = output;
|
|
291
|
+
}
|
|
292
|
+
if (
|
|
293
|
+
result.errorCount + result.warningCount > 0 &&
|
|
294
|
+
typeof result.output === "undefined"
|
|
295
|
+
) {
|
|
296
|
+
result.source = text;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
return result;
|
|
293
300
|
}
|
|
294
301
|
|
|
295
302
|
/**
|
|
@@ -300,37 +307,42 @@ function verifyText({
|
|
|
300
307
|
* @private
|
|
301
308
|
*/
|
|
302
309
|
function createIgnoreResult(filePath, baseDir) {
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
310
|
+
let message;
|
|
311
|
+
const isHidden = filePath
|
|
312
|
+
.split(path.sep)
|
|
313
|
+
.find(segment => /^\./u.test(segment));
|
|
314
|
+
const isInNodeModules =
|
|
315
|
+
baseDir && path.relative(baseDir, filePath).startsWith("node_modules");
|
|
316
|
+
|
|
317
|
+
if (isHidden) {
|
|
318
|
+
message =
|
|
319
|
+
"File ignored by default. Use a negated ignore pattern (like \"--ignore-pattern '!<relative/path/to/filename>'\") to override.";
|
|
320
|
+
} else if (isInNodeModules) {
|
|
321
|
+
message =
|
|
322
|
+
"File ignored by default. Use \"--ignore-pattern '!node_modules/*'\" to override.";
|
|
323
|
+
} else {
|
|
324
|
+
message =
|
|
325
|
+
'File ignored because of a matching ignore pattern. Use "--no-ignore" to override.';
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
return {
|
|
329
|
+
filePath: path.resolve(filePath),
|
|
330
|
+
messages: [
|
|
331
|
+
{
|
|
332
|
+
ruleId: null,
|
|
333
|
+
fatal: false,
|
|
334
|
+
severity: 1,
|
|
335
|
+
message,
|
|
336
|
+
nodeType: null,
|
|
337
|
+
},
|
|
338
|
+
],
|
|
339
|
+
suppressedMessages: [],
|
|
340
|
+
errorCount: 0,
|
|
341
|
+
fatalErrorCount: 0,
|
|
342
|
+
warningCount: 1,
|
|
343
|
+
fixableErrorCount: 0,
|
|
344
|
+
fixableWarningCount: 0,
|
|
345
|
+
};
|
|
334
346
|
}
|
|
335
347
|
|
|
336
348
|
/**
|
|
@@ -340,14 +352,14 @@ function createIgnoreResult(filePath, baseDir) {
|
|
|
340
352
|
* @returns {Rule|null} The rule or null.
|
|
341
353
|
*/
|
|
342
354
|
function getRule(ruleId, configArrays) {
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
355
|
+
for (const configArray of configArrays) {
|
|
356
|
+
const rule = configArray.pluginRules.get(ruleId);
|
|
357
|
+
|
|
358
|
+
if (rule) {
|
|
359
|
+
return rule;
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
return builtInRules.get(ruleId) || null;
|
|
351
363
|
}
|
|
352
364
|
|
|
353
365
|
/**
|
|
@@ -358,13 +370,13 @@ function getRule(ruleId, configArrays) {
|
|
|
358
370
|
* @returns {boolean} Whether the message should be fixed.
|
|
359
371
|
*/
|
|
360
372
|
function shouldMessageBeFixed(message, lastConfigArrays, fixTypes) {
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
373
|
+
if (!message.ruleId) {
|
|
374
|
+
return fixTypes.has("directive");
|
|
375
|
+
}
|
|
364
376
|
|
|
365
|
-
|
|
377
|
+
const rule = message.ruleId && getRule(message.ruleId, lastConfigArrays);
|
|
366
378
|
|
|
367
|
-
|
|
379
|
+
return Boolean(rule && rule.meta && fixTypes.has(rule.meta.type));
|
|
368
380
|
}
|
|
369
381
|
|
|
370
382
|
/**
|
|
@@ -372,41 +384,40 @@ function shouldMessageBeFixed(message, lastConfigArrays, fixTypes) {
|
|
|
372
384
|
* @param {ConfigArray[]} usedConfigArrays The config arrays which were used.
|
|
373
385
|
* @returns {IterableIterator<DeprecatedRuleInfo>} Used deprecated rules.
|
|
374
386
|
*/
|
|
375
|
-
function
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
}
|
|
387
|
+
function* iterateRuleDeprecationWarnings(usedConfigArrays) {
|
|
388
|
+
const processedRuleIds = new Set();
|
|
389
|
+
|
|
390
|
+
// Flatten used configs.
|
|
391
|
+
/** @type {ExtractedConfig[]} */
|
|
392
|
+
const configs = usedConfigArrays.flatMap(getUsedExtractedConfigs);
|
|
393
|
+
|
|
394
|
+
// Traverse rule configs.
|
|
395
|
+
for (const config of configs) {
|
|
396
|
+
for (const [ruleId, ruleConfig] of Object.entries(config.rules)) {
|
|
397
|
+
// Skip if it was processed.
|
|
398
|
+
if (processedRuleIds.has(ruleId)) {
|
|
399
|
+
continue;
|
|
400
|
+
}
|
|
401
|
+
processedRuleIds.add(ruleId);
|
|
402
|
+
|
|
403
|
+
// Skip if it's not used.
|
|
404
|
+
if (!ConfigOps.getRuleSeverity(ruleConfig)) {
|
|
405
|
+
continue;
|
|
406
|
+
}
|
|
407
|
+
const rule = getRule(ruleId, usedConfigArrays);
|
|
408
|
+
|
|
409
|
+
// Skip if it's not deprecated.
|
|
410
|
+
if (!(rule && rule.meta && rule.meta.deprecated)) {
|
|
411
|
+
continue;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
// This rule was used and deprecated.
|
|
415
|
+
yield {
|
|
416
|
+
ruleId,
|
|
417
|
+
replacedBy: rule.meta.replacedBy || [],
|
|
418
|
+
};
|
|
419
|
+
}
|
|
420
|
+
}
|
|
410
421
|
}
|
|
411
422
|
|
|
412
423
|
/**
|
|
@@ -416,10 +427,9 @@ function *iterateRuleDeprecationWarnings(usedConfigArrays) {
|
|
|
416
427
|
* @private
|
|
417
428
|
*/
|
|
418
429
|
function isErrorMessage(message) {
|
|
419
|
-
|
|
430
|
+
return message.severity === 2;
|
|
420
431
|
}
|
|
421
432
|
|
|
422
|
-
|
|
423
433
|
/**
|
|
424
434
|
* return the cacheFile to be used by eslint, based on whether the provided parameter is
|
|
425
435
|
* a directory or looks like a directory (ends in `path.sep`), in which case the file
|
|
@@ -431,65 +441,62 @@ function isErrorMessage(message) {
|
|
|
431
441
|
* @returns {string} the resolved path to the cache file
|
|
432
442
|
*/
|
|
433
443
|
function getCacheFile(cacheFile, cwd) {
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
}
|
|
491
|
-
|
|
492
|
-
return resolvedCacheFile;
|
|
444
|
+
/*
|
|
445
|
+
* make sure the path separators are normalized for the environment/os
|
|
446
|
+
* keeping the trailing path separator if present
|
|
447
|
+
*/
|
|
448
|
+
const normalizedCacheFile = path.normalize(cacheFile);
|
|
449
|
+
|
|
450
|
+
const resolvedCacheFile = path.resolve(cwd, normalizedCacheFile);
|
|
451
|
+
const looksLikeADirectory = normalizedCacheFile.slice(-1) === path.sep;
|
|
452
|
+
|
|
453
|
+
/**
|
|
454
|
+
* return the name for the cache file in case the provided parameter is a directory
|
|
455
|
+
* @returns {string} the resolved path to the cacheFile
|
|
456
|
+
*/
|
|
457
|
+
function getCacheFileForDirectory() {
|
|
458
|
+
return path.join(resolvedCacheFile, `.cache_${hash(cwd)}`);
|
|
459
|
+
}
|
|
460
|
+
|
|
461
|
+
let fileStats;
|
|
462
|
+
|
|
463
|
+
try {
|
|
464
|
+
fileStats = fs.lstatSync(resolvedCacheFile);
|
|
465
|
+
} catch {
|
|
466
|
+
fileStats = null;
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
/*
|
|
470
|
+
* in case the file exists we need to verify if the provided path
|
|
471
|
+
* is a directory or a file. If it is a directory we want to create a file
|
|
472
|
+
* inside that directory
|
|
473
|
+
*/
|
|
474
|
+
if (fileStats) {
|
|
475
|
+
/*
|
|
476
|
+
* is a directory or is a file, but the original file the user provided
|
|
477
|
+
* looks like a directory but `path.resolve` removed the `last path.sep`
|
|
478
|
+
* so we need to still treat this like a directory
|
|
479
|
+
*/
|
|
480
|
+
if (fileStats.isDirectory() || looksLikeADirectory) {
|
|
481
|
+
return getCacheFileForDirectory();
|
|
482
|
+
}
|
|
483
|
+
|
|
484
|
+
// is file so just use that file
|
|
485
|
+
return resolvedCacheFile;
|
|
486
|
+
}
|
|
487
|
+
|
|
488
|
+
/*
|
|
489
|
+
* here we known the file or directory doesn't exist,
|
|
490
|
+
* so we will try to infer if its a directory if it looks like a directory
|
|
491
|
+
* for the current operating system.
|
|
492
|
+
*/
|
|
493
|
+
|
|
494
|
+
// if the last character passed is a path separator we assume is a directory
|
|
495
|
+
if (looksLikeADirectory) {
|
|
496
|
+
return getCacheFileForDirectory();
|
|
497
|
+
}
|
|
498
|
+
|
|
499
|
+
return resolvedCacheFile;
|
|
493
500
|
}
|
|
494
501
|
|
|
495
502
|
/**
|
|
@@ -501,23 +508,21 @@ function getCacheFile(cacheFile, cwd) {
|
|
|
501
508
|
* @returns {Record<string,boolean>} The boolean map.
|
|
502
509
|
*/
|
|
503
510
|
function toBooleanMap(keys, defaultValue, displayName) {
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
}
|
|
520
|
-
return void 0;
|
|
511
|
+
if (keys && !Array.isArray(keys)) {
|
|
512
|
+
throw new Error(`${displayName} must be an array.`);
|
|
513
|
+
}
|
|
514
|
+
if (keys && keys.length > 0) {
|
|
515
|
+
return keys.reduce((map, def) => {
|
|
516
|
+
const [key, value] = def.split(":");
|
|
517
|
+
|
|
518
|
+
if (key !== "__proto__") {
|
|
519
|
+
map[key] = value === void 0 ? defaultValue : value === "true";
|
|
520
|
+
}
|
|
521
|
+
|
|
522
|
+
return map;
|
|
523
|
+
}, {});
|
|
524
|
+
}
|
|
525
|
+
return void 0;
|
|
521
526
|
}
|
|
522
527
|
|
|
523
528
|
/**
|
|
@@ -526,36 +531,30 @@ function toBooleanMap(keys, defaultValue, displayName) {
|
|
|
526
531
|
* @returns {ConfigData|null} The created config data.
|
|
527
532
|
*/
|
|
528
533
|
function createConfigDataFromOptions(options) {
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
ignorePatterns: ignorePattern,
|
|
554
|
-
parser,
|
|
555
|
-
parserOptions,
|
|
556
|
-
plugins,
|
|
557
|
-
rules
|
|
558
|
-
};
|
|
534
|
+
const { ignorePattern, parser, parserOptions, plugins, rules } = options;
|
|
535
|
+
const env = toBooleanMap(options.envs, true, "envs");
|
|
536
|
+
const globals = toBooleanMap(options.globals, false, "globals");
|
|
537
|
+
|
|
538
|
+
if (
|
|
539
|
+
env === void 0 &&
|
|
540
|
+
globals === void 0 &&
|
|
541
|
+
(ignorePattern === void 0 || ignorePattern.length === 0) &&
|
|
542
|
+
parser === void 0 &&
|
|
543
|
+
parserOptions === void 0 &&
|
|
544
|
+
plugins === void 0 &&
|
|
545
|
+
rules === void 0
|
|
546
|
+
) {
|
|
547
|
+
return null;
|
|
548
|
+
}
|
|
549
|
+
return {
|
|
550
|
+
env,
|
|
551
|
+
globals,
|
|
552
|
+
ignorePatterns: ignorePattern,
|
|
553
|
+
parser,
|
|
554
|
+
parserOptions,
|
|
555
|
+
plugins,
|
|
556
|
+
rules,
|
|
557
|
+
};
|
|
559
558
|
}
|
|
560
559
|
|
|
561
560
|
/**
|
|
@@ -565,14 +564,14 @@ function createConfigDataFromOptions(options) {
|
|
|
565
564
|
* @returns {boolean} `true` if a directory exists
|
|
566
565
|
*/
|
|
567
566
|
function directoryExists(resolvedPath) {
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
567
|
+
try {
|
|
568
|
+
return fs.statSync(resolvedPath).isDirectory();
|
|
569
|
+
} catch (error) {
|
|
570
|
+
if (error && (error.code === "ENOENT" || error.code === "ENOTDIR")) {
|
|
571
|
+
return false;
|
|
572
|
+
}
|
|
573
|
+
throw error;
|
|
574
|
+
}
|
|
576
575
|
}
|
|
577
576
|
|
|
578
577
|
//------------------------------------------------------------------------------
|
|
@@ -583,496 +582,528 @@ function directoryExists(resolvedPath) {
|
|
|
583
582
|
* Core CLI.
|
|
584
583
|
*/
|
|
585
584
|
class CLIEngine {
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1031
|
-
|
|
1032
|
-
|
|
1033
|
-
|
|
1034
|
-
|
|
1035
|
-
|
|
1036
|
-
|
|
1037
|
-
|
|
1038
|
-
|
|
1039
|
-
|
|
1040
|
-
|
|
1041
|
-
|
|
1042
|
-
|
|
1043
|
-
|
|
1044
|
-
|
|
1045
|
-
|
|
1046
|
-
|
|
1047
|
-
|
|
1048
|
-
|
|
1049
|
-
|
|
1050
|
-
|
|
1051
|
-
|
|
1052
|
-
|
|
1053
|
-
|
|
1054
|
-
|
|
1055
|
-
|
|
1056
|
-
|
|
1057
|
-
|
|
1058
|
-
|
|
1059
|
-
|
|
1060
|
-
|
|
1061
|
-
|
|
585
|
+
/**
|
|
586
|
+
* Creates a new instance of the core CLI engine.
|
|
587
|
+
* @param {CLIEngineOptions} providedOptions The options for this instance.
|
|
588
|
+
* @param {Object} [additionalData] Additional settings that are not CLIEngineOptions.
|
|
589
|
+
* @param {Record<string,Plugin>|null} [additionalData.preloadedPlugins] Preloaded plugins.
|
|
590
|
+
*/
|
|
591
|
+
constructor(providedOptions, { preloadedPlugins } = {}) {
|
|
592
|
+
const options = Object.assign(
|
|
593
|
+
Object.create(null),
|
|
594
|
+
defaultOptions,
|
|
595
|
+
{ cwd: process.cwd() },
|
|
596
|
+
providedOptions,
|
|
597
|
+
);
|
|
598
|
+
|
|
599
|
+
if (options.fix === void 0) {
|
|
600
|
+
options.fix = false;
|
|
601
|
+
}
|
|
602
|
+
|
|
603
|
+
const additionalPluginPool = new Map();
|
|
604
|
+
|
|
605
|
+
if (preloadedPlugins) {
|
|
606
|
+
for (const [id, plugin] of Object.entries(preloadedPlugins)) {
|
|
607
|
+
additionalPluginPool.set(id, plugin);
|
|
608
|
+
}
|
|
609
|
+
}
|
|
610
|
+
|
|
611
|
+
const cacheFilePath = getCacheFile(
|
|
612
|
+
options.cacheLocation || options.cacheFile,
|
|
613
|
+
options.cwd,
|
|
614
|
+
);
|
|
615
|
+
const configArrayFactory = new CascadingConfigArrayFactory({
|
|
616
|
+
additionalPluginPool,
|
|
617
|
+
baseConfig: options.baseConfig || null,
|
|
618
|
+
cliConfig: createConfigDataFromOptions(options),
|
|
619
|
+
cwd: options.cwd,
|
|
620
|
+
ignorePath: options.ignorePath,
|
|
621
|
+
resolvePluginsRelativeTo: options.resolvePluginsRelativeTo,
|
|
622
|
+
rulePaths: options.rulePaths,
|
|
623
|
+
specificConfigPath: options.configFile,
|
|
624
|
+
useEslintrc: options.useEslintrc,
|
|
625
|
+
builtInRules,
|
|
626
|
+
loadRules,
|
|
627
|
+
getEslintRecommendedConfig: () =>
|
|
628
|
+
require("@eslint/js").configs.recommended,
|
|
629
|
+
getEslintAllConfig: () => require("@eslint/js").configs.all,
|
|
630
|
+
});
|
|
631
|
+
const fileEnumerator = new FileEnumerator({
|
|
632
|
+
configArrayFactory,
|
|
633
|
+
cwd: options.cwd,
|
|
634
|
+
extensions: options.extensions,
|
|
635
|
+
globInputPaths: options.globInputPaths,
|
|
636
|
+
errorOnUnmatchedPattern: options.errorOnUnmatchedPattern,
|
|
637
|
+
ignore: options.ignore,
|
|
638
|
+
});
|
|
639
|
+
const lintResultCache = options.cache
|
|
640
|
+
? new LintResultCache(cacheFilePath, options.cacheStrategy)
|
|
641
|
+
: null;
|
|
642
|
+
const linter = new Linter({ cwd: options.cwd, configType: "eslintrc" });
|
|
643
|
+
|
|
644
|
+
/** @type {ConfigArray[]} */
|
|
645
|
+
const lastConfigArrays = [configArrayFactory.getConfigArrayForFile()];
|
|
646
|
+
|
|
647
|
+
// Store private data.
|
|
648
|
+
internalSlotsMap.set(this, {
|
|
649
|
+
additionalPluginPool,
|
|
650
|
+
cacheFilePath,
|
|
651
|
+
configArrayFactory,
|
|
652
|
+
defaultIgnores: IgnorePattern.createDefaultIgnore(options.cwd),
|
|
653
|
+
fileEnumerator,
|
|
654
|
+
lastConfigArrays,
|
|
655
|
+
lintResultCache,
|
|
656
|
+
linter,
|
|
657
|
+
options,
|
|
658
|
+
});
|
|
659
|
+
|
|
660
|
+
// setup special filter for fixes
|
|
661
|
+
if (options.fix && options.fixTypes && options.fixTypes.length > 0) {
|
|
662
|
+
debug(`Using fix types ${options.fixTypes}`);
|
|
663
|
+
|
|
664
|
+
// throw an error if any invalid fix types are found
|
|
665
|
+
validateFixTypes(options.fixTypes);
|
|
666
|
+
|
|
667
|
+
// convert to Set for faster lookup
|
|
668
|
+
const fixTypes = new Set(options.fixTypes);
|
|
669
|
+
|
|
670
|
+
// save original value of options.fix in case it's a function
|
|
671
|
+
const originalFix =
|
|
672
|
+
typeof options.fix === "function" ? options.fix : () => true;
|
|
673
|
+
|
|
674
|
+
options.fix = message =>
|
|
675
|
+
shouldMessageBeFixed(message, lastConfigArrays, fixTypes) &&
|
|
676
|
+
originalFix(message);
|
|
677
|
+
}
|
|
678
|
+
}
|
|
679
|
+
|
|
680
|
+
getRules() {
|
|
681
|
+
const { lastConfigArrays } = internalSlotsMap.get(this);
|
|
682
|
+
|
|
683
|
+
return new Map(
|
|
684
|
+
(function* () {
|
|
685
|
+
yield* builtInRules;
|
|
686
|
+
|
|
687
|
+
for (const configArray of lastConfigArrays) {
|
|
688
|
+
yield* configArray.pluginRules;
|
|
689
|
+
}
|
|
690
|
+
})(),
|
|
691
|
+
);
|
|
692
|
+
}
|
|
693
|
+
|
|
694
|
+
/**
|
|
695
|
+
* Returns results that only contains errors.
|
|
696
|
+
* @param {LintResult[]} results The results to filter.
|
|
697
|
+
* @returns {LintResult[]} The filtered results.
|
|
698
|
+
*/
|
|
699
|
+
static getErrorResults(results) {
|
|
700
|
+
const filtered = [];
|
|
701
|
+
|
|
702
|
+
results.forEach(result => {
|
|
703
|
+
const filteredMessages = result.messages.filter(isErrorMessage);
|
|
704
|
+
const filteredSuppressedMessages =
|
|
705
|
+
result.suppressedMessages.filter(isErrorMessage);
|
|
706
|
+
|
|
707
|
+
if (filteredMessages.length > 0) {
|
|
708
|
+
filtered.push({
|
|
709
|
+
...result,
|
|
710
|
+
messages: filteredMessages,
|
|
711
|
+
suppressedMessages: filteredSuppressedMessages,
|
|
712
|
+
errorCount: filteredMessages.length,
|
|
713
|
+
warningCount: 0,
|
|
714
|
+
fixableErrorCount: result.fixableErrorCount,
|
|
715
|
+
fixableWarningCount: 0,
|
|
716
|
+
});
|
|
717
|
+
}
|
|
718
|
+
});
|
|
719
|
+
|
|
720
|
+
return filtered;
|
|
721
|
+
}
|
|
722
|
+
|
|
723
|
+
/**
|
|
724
|
+
* Outputs fixes from the given results to files.
|
|
725
|
+
* @param {LintReport} report The report object created by CLIEngine.
|
|
726
|
+
* @returns {void}
|
|
727
|
+
*/
|
|
728
|
+
static outputFixes(report) {
|
|
729
|
+
report.results
|
|
730
|
+
.filter(result => Object.hasOwn(result, "output"))
|
|
731
|
+
.forEach(result => {
|
|
732
|
+
fs.writeFileSync(result.filePath, result.output);
|
|
733
|
+
});
|
|
734
|
+
}
|
|
735
|
+
|
|
736
|
+
/**
|
|
737
|
+
* Resolves the patterns passed into executeOnFiles() into glob-based patterns
|
|
738
|
+
* for easier handling.
|
|
739
|
+
* @param {string[]} patterns The file patterns passed on the command line.
|
|
740
|
+
* @returns {string[]} The equivalent glob patterns.
|
|
741
|
+
*/
|
|
742
|
+
resolveFileGlobPatterns(patterns) {
|
|
743
|
+
const { options } = internalSlotsMap.get(this);
|
|
744
|
+
|
|
745
|
+
if (options.globInputPaths === false) {
|
|
746
|
+
return patterns.filter(Boolean);
|
|
747
|
+
}
|
|
748
|
+
|
|
749
|
+
const extensions = (options.extensions || [".js"]).map(ext =>
|
|
750
|
+
ext.replace(/^\./u, ""),
|
|
751
|
+
);
|
|
752
|
+
const dirSuffix = `/**/*.{${extensions.join(",")}}`;
|
|
753
|
+
|
|
754
|
+
return patterns.filter(Boolean).map(pathname => {
|
|
755
|
+
const resolvedPath = path.resolve(options.cwd, pathname);
|
|
756
|
+
const newPath = directoryExists(resolvedPath)
|
|
757
|
+
? pathname.replace(/[/\\]$/u, "") + dirSuffix
|
|
758
|
+
: pathname;
|
|
759
|
+
|
|
760
|
+
return path.normalize(newPath).replace(/\\/gu, "/");
|
|
761
|
+
});
|
|
762
|
+
}
|
|
763
|
+
|
|
764
|
+
/**
|
|
765
|
+
* Executes the current configuration on an array of file and directory names.
|
|
766
|
+
* @param {string[]} patterns An array of file and directory names.
|
|
767
|
+
* @throws {Error} As may be thrown by `fs.unlinkSync`.
|
|
768
|
+
* @returns {LintReport} The results for all files that were linted.
|
|
769
|
+
*/
|
|
770
|
+
executeOnFiles(patterns) {
|
|
771
|
+
const {
|
|
772
|
+
cacheFilePath,
|
|
773
|
+
fileEnumerator,
|
|
774
|
+
lastConfigArrays,
|
|
775
|
+
lintResultCache,
|
|
776
|
+
linter,
|
|
777
|
+
options: {
|
|
778
|
+
allowInlineConfig,
|
|
779
|
+
cache,
|
|
780
|
+
cwd,
|
|
781
|
+
fix,
|
|
782
|
+
reportUnusedDisableDirectives,
|
|
783
|
+
},
|
|
784
|
+
} = internalSlotsMap.get(this);
|
|
785
|
+
const results = [];
|
|
786
|
+
const startTime = Date.now();
|
|
787
|
+
|
|
788
|
+
// Clear the last used config arrays.
|
|
789
|
+
lastConfigArrays.length = 0;
|
|
790
|
+
|
|
791
|
+
// Delete cache file; should this do here?
|
|
792
|
+
if (!cache) {
|
|
793
|
+
try {
|
|
794
|
+
fs.unlinkSync(cacheFilePath);
|
|
795
|
+
} catch (error) {
|
|
796
|
+
const errorCode = error && error.code;
|
|
797
|
+
|
|
798
|
+
// Ignore errors when no such file exists or file system is read only (and cache file does not exist)
|
|
799
|
+
if (
|
|
800
|
+
errorCode !== "ENOENT" &&
|
|
801
|
+
!(errorCode === "EROFS" && !fs.existsSync(cacheFilePath))
|
|
802
|
+
) {
|
|
803
|
+
throw error;
|
|
804
|
+
}
|
|
805
|
+
}
|
|
806
|
+
}
|
|
807
|
+
|
|
808
|
+
// Iterate source code files.
|
|
809
|
+
for (const { config, filePath, ignored } of fileEnumerator.iterateFiles(
|
|
810
|
+
patterns,
|
|
811
|
+
)) {
|
|
812
|
+
if (ignored) {
|
|
813
|
+
results.push(createIgnoreResult(filePath, cwd));
|
|
814
|
+
continue;
|
|
815
|
+
}
|
|
816
|
+
|
|
817
|
+
/*
|
|
818
|
+
* Store used configs for:
|
|
819
|
+
* - this method uses to collect used deprecated rules.
|
|
820
|
+
* - `getRules()` method uses to collect all loaded rules.
|
|
821
|
+
* - `--fix-type` option uses to get the loaded rule's meta data.
|
|
822
|
+
*/
|
|
823
|
+
if (!lastConfigArrays.includes(config)) {
|
|
824
|
+
lastConfigArrays.push(config);
|
|
825
|
+
}
|
|
826
|
+
|
|
827
|
+
// Skip if there is cached result.
|
|
828
|
+
if (lintResultCache) {
|
|
829
|
+
const cachedResult = lintResultCache.getCachedLintResults(
|
|
830
|
+
filePath,
|
|
831
|
+
config,
|
|
832
|
+
);
|
|
833
|
+
|
|
834
|
+
if (cachedResult) {
|
|
835
|
+
const hadMessages =
|
|
836
|
+
cachedResult.messages &&
|
|
837
|
+
cachedResult.messages.length > 0;
|
|
838
|
+
|
|
839
|
+
if (hadMessages && fix) {
|
|
840
|
+
debug(
|
|
841
|
+
`Reprocessing cached file to allow autofix: ${filePath}`,
|
|
842
|
+
);
|
|
843
|
+
} else {
|
|
844
|
+
debug(
|
|
845
|
+
`Skipping file since it hasn't changed: ${filePath}`,
|
|
846
|
+
);
|
|
847
|
+
results.push(cachedResult);
|
|
848
|
+
continue;
|
|
849
|
+
}
|
|
850
|
+
}
|
|
851
|
+
}
|
|
852
|
+
|
|
853
|
+
// Do lint.
|
|
854
|
+
const result = verifyText({
|
|
855
|
+
text: fs.readFileSync(filePath, "utf8"),
|
|
856
|
+
filePath,
|
|
857
|
+
config,
|
|
858
|
+
cwd,
|
|
859
|
+
fix,
|
|
860
|
+
allowInlineConfig,
|
|
861
|
+
reportUnusedDisableDirectives,
|
|
862
|
+
fileEnumerator,
|
|
863
|
+
linter,
|
|
864
|
+
});
|
|
865
|
+
|
|
866
|
+
results.push(result);
|
|
867
|
+
|
|
868
|
+
/*
|
|
869
|
+
* Store the lint result in the LintResultCache.
|
|
870
|
+
* NOTE: The LintResultCache will remove the file source and any
|
|
871
|
+
* other properties that are difficult to serialize, and will
|
|
872
|
+
* hydrate those properties back in on future lint runs.
|
|
873
|
+
*/
|
|
874
|
+
if (lintResultCache) {
|
|
875
|
+
lintResultCache.setCachedLintResults(filePath, config, result);
|
|
876
|
+
}
|
|
877
|
+
}
|
|
878
|
+
|
|
879
|
+
// Persist the cache to disk.
|
|
880
|
+
if (lintResultCache) {
|
|
881
|
+
lintResultCache.reconcile();
|
|
882
|
+
}
|
|
883
|
+
|
|
884
|
+
debug(`Linting complete in: ${Date.now() - startTime}ms`);
|
|
885
|
+
let usedDeprecatedRules;
|
|
886
|
+
|
|
887
|
+
return {
|
|
888
|
+
results,
|
|
889
|
+
...calculateStatsPerRun(results),
|
|
890
|
+
|
|
891
|
+
// Initialize it lazily because CLI and `ESLint` API don't use it.
|
|
892
|
+
get usedDeprecatedRules() {
|
|
893
|
+
if (!usedDeprecatedRules) {
|
|
894
|
+
usedDeprecatedRules = Array.from(
|
|
895
|
+
iterateRuleDeprecationWarnings(lastConfigArrays),
|
|
896
|
+
);
|
|
897
|
+
}
|
|
898
|
+
return usedDeprecatedRules;
|
|
899
|
+
},
|
|
900
|
+
};
|
|
901
|
+
}
|
|
902
|
+
|
|
903
|
+
/**
|
|
904
|
+
* Executes the current configuration on text.
|
|
905
|
+
* @param {string} text A string of JavaScript code to lint.
|
|
906
|
+
* @param {string} [filename] An optional string representing the texts filename.
|
|
907
|
+
* @param {boolean} [warnIgnored] Always warn when a file is ignored
|
|
908
|
+
* @returns {LintReport} The results for the linting.
|
|
909
|
+
*/
|
|
910
|
+
executeOnText(text, filename, warnIgnored) {
|
|
911
|
+
const {
|
|
912
|
+
configArrayFactory,
|
|
913
|
+
fileEnumerator,
|
|
914
|
+
lastConfigArrays,
|
|
915
|
+
linter,
|
|
916
|
+
options: {
|
|
917
|
+
allowInlineConfig,
|
|
918
|
+
cwd,
|
|
919
|
+
fix,
|
|
920
|
+
reportUnusedDisableDirectives,
|
|
921
|
+
},
|
|
922
|
+
} = internalSlotsMap.get(this);
|
|
923
|
+
const results = [];
|
|
924
|
+
const startTime = Date.now();
|
|
925
|
+
const resolvedFilename = filename && path.resolve(cwd, filename);
|
|
926
|
+
|
|
927
|
+
// Clear the last used config arrays.
|
|
928
|
+
lastConfigArrays.length = 0;
|
|
929
|
+
if (resolvedFilename && this.isPathIgnored(resolvedFilename)) {
|
|
930
|
+
if (warnIgnored) {
|
|
931
|
+
results.push(createIgnoreResult(resolvedFilename, cwd));
|
|
932
|
+
}
|
|
933
|
+
} else {
|
|
934
|
+
const config = configArrayFactory.getConfigArrayForFile(
|
|
935
|
+
resolvedFilename || "__placeholder__.js",
|
|
936
|
+
);
|
|
937
|
+
|
|
938
|
+
/*
|
|
939
|
+
* Store used configs for:
|
|
940
|
+
* - this method uses to collect used deprecated rules.
|
|
941
|
+
* - `getRules()` method uses to collect all loaded rules.
|
|
942
|
+
* - `--fix-type` option uses to get the loaded rule's meta data.
|
|
943
|
+
*/
|
|
944
|
+
lastConfigArrays.push(config);
|
|
945
|
+
|
|
946
|
+
// Do lint.
|
|
947
|
+
results.push(
|
|
948
|
+
verifyText({
|
|
949
|
+
text,
|
|
950
|
+
filePath: resolvedFilename,
|
|
951
|
+
config,
|
|
952
|
+
cwd,
|
|
953
|
+
fix,
|
|
954
|
+
allowInlineConfig,
|
|
955
|
+
reportUnusedDisableDirectives,
|
|
956
|
+
fileEnumerator,
|
|
957
|
+
linter,
|
|
958
|
+
}),
|
|
959
|
+
);
|
|
960
|
+
}
|
|
961
|
+
|
|
962
|
+
debug(`Linting complete in: ${Date.now() - startTime}ms`);
|
|
963
|
+
let usedDeprecatedRules;
|
|
964
|
+
|
|
965
|
+
return {
|
|
966
|
+
results,
|
|
967
|
+
...calculateStatsPerRun(results),
|
|
968
|
+
|
|
969
|
+
// Initialize it lazily because CLI and `ESLint` API don't use it.
|
|
970
|
+
get usedDeprecatedRules() {
|
|
971
|
+
if (!usedDeprecatedRules) {
|
|
972
|
+
usedDeprecatedRules = Array.from(
|
|
973
|
+
iterateRuleDeprecationWarnings(lastConfigArrays),
|
|
974
|
+
);
|
|
975
|
+
}
|
|
976
|
+
return usedDeprecatedRules;
|
|
977
|
+
},
|
|
978
|
+
};
|
|
979
|
+
}
|
|
980
|
+
|
|
981
|
+
/**
|
|
982
|
+
* Returns a configuration object for the given file based on the CLI options.
|
|
983
|
+
* This is the same logic used by the ESLint CLI executable to determine
|
|
984
|
+
* configuration for each file it processes.
|
|
985
|
+
* @param {string} filePath The path of the file to retrieve a config object for.
|
|
986
|
+
* @throws {Error} If filepath a directory path.
|
|
987
|
+
* @returns {ConfigData} A configuration object for the file.
|
|
988
|
+
*/
|
|
989
|
+
getConfigForFile(filePath) {
|
|
990
|
+
const { configArrayFactory, options } = internalSlotsMap.get(this);
|
|
991
|
+
const absolutePath = path.resolve(options.cwd, filePath);
|
|
992
|
+
|
|
993
|
+
if (directoryExists(absolutePath)) {
|
|
994
|
+
throw Object.assign(
|
|
995
|
+
new Error("'filePath' should not be a directory path."),
|
|
996
|
+
{ messageTemplate: "print-config-with-directory-path" },
|
|
997
|
+
);
|
|
998
|
+
}
|
|
999
|
+
|
|
1000
|
+
return configArrayFactory
|
|
1001
|
+
.getConfigArrayForFile(absolutePath)
|
|
1002
|
+
.extractConfig(absolutePath)
|
|
1003
|
+
.toCompatibleObjectAsConfigFileContent();
|
|
1004
|
+
}
|
|
1005
|
+
|
|
1006
|
+
/**
|
|
1007
|
+
* Checks if a given path is ignored by ESLint.
|
|
1008
|
+
* @param {string} filePath The path of the file to check.
|
|
1009
|
+
* @returns {boolean} Whether or not the given path is ignored.
|
|
1010
|
+
*/
|
|
1011
|
+
isPathIgnored(filePath) {
|
|
1012
|
+
const {
|
|
1013
|
+
configArrayFactory,
|
|
1014
|
+
defaultIgnores,
|
|
1015
|
+
options: { cwd, ignore },
|
|
1016
|
+
} = internalSlotsMap.get(this);
|
|
1017
|
+
const absolutePath = path.resolve(cwd, filePath);
|
|
1018
|
+
|
|
1019
|
+
if (ignore) {
|
|
1020
|
+
const config = configArrayFactory
|
|
1021
|
+
.getConfigArrayForFile(absolutePath)
|
|
1022
|
+
.extractConfig(absolutePath);
|
|
1023
|
+
const ignores = config.ignores || defaultIgnores;
|
|
1024
|
+
|
|
1025
|
+
return ignores(absolutePath);
|
|
1026
|
+
}
|
|
1027
|
+
|
|
1028
|
+
return defaultIgnores(absolutePath);
|
|
1029
|
+
}
|
|
1030
|
+
|
|
1031
|
+
/**
|
|
1032
|
+
* Returns the formatter representing the given format or null if the `format` is not a string.
|
|
1033
|
+
* @param {string} [format] The name of the format to load or the path to a
|
|
1034
|
+
* custom formatter.
|
|
1035
|
+
* @throws {any} As may be thrown by requiring of formatter
|
|
1036
|
+
* @returns {(FormatterFunction|null)} The formatter function or null if the `format` is not a string.
|
|
1037
|
+
*/
|
|
1038
|
+
getFormatter(format) {
|
|
1039
|
+
// default is stylish
|
|
1040
|
+
const resolvedFormatName = format || "stylish";
|
|
1041
|
+
|
|
1042
|
+
// only strings are valid formatters
|
|
1043
|
+
if (typeof resolvedFormatName === "string") {
|
|
1044
|
+
// replace \ with / for Windows compatibility
|
|
1045
|
+
const normalizedFormatName = resolvedFormatName.replace(
|
|
1046
|
+
/\\/gu,
|
|
1047
|
+
"/",
|
|
1048
|
+
);
|
|
1049
|
+
|
|
1050
|
+
const slots = internalSlotsMap.get(this);
|
|
1051
|
+
const cwd = slots ? slots.options.cwd : process.cwd();
|
|
1052
|
+
const namespace = naming.getNamespaceFromTerm(normalizedFormatName);
|
|
1053
|
+
|
|
1054
|
+
let formatterPath;
|
|
1055
|
+
|
|
1056
|
+
// if there's a slash, then it's a file (TODO: this check seems dubious for scoped npm packages)
|
|
1057
|
+
if (!namespace && normalizedFormatName.includes("/")) {
|
|
1058
|
+
formatterPath = path.resolve(cwd, normalizedFormatName);
|
|
1059
|
+
} else {
|
|
1060
|
+
try {
|
|
1061
|
+
const npmFormat = naming.normalizePackageName(
|
|
1062
|
+
normalizedFormatName,
|
|
1063
|
+
"eslint-formatter",
|
|
1064
|
+
);
|
|
1065
|
+
|
|
1066
|
+
formatterPath = ModuleResolver.resolve(
|
|
1067
|
+
npmFormat,
|
|
1068
|
+
path.join(cwd, "__placeholder__.js"),
|
|
1069
|
+
);
|
|
1070
|
+
} catch {
|
|
1071
|
+
formatterPath = path.resolve(
|
|
1072
|
+
__dirname,
|
|
1073
|
+
"formatters",
|
|
1074
|
+
normalizedFormatName,
|
|
1075
|
+
);
|
|
1076
|
+
}
|
|
1077
|
+
}
|
|
1078
|
+
|
|
1079
|
+
try {
|
|
1080
|
+
return require(formatterPath);
|
|
1081
|
+
} catch (ex) {
|
|
1082
|
+
if (removedFormatters.has(format)) {
|
|
1083
|
+
ex.message = `The ${format} formatter is no longer part of core ESLint. Install it manually with \`npm install -D eslint-formatter-${format}\``;
|
|
1084
|
+
} else {
|
|
1085
|
+
ex.message = `There was a problem loading formatter: ${formatterPath}\nError: ${ex.message}`;
|
|
1086
|
+
}
|
|
1087
|
+
throw ex;
|
|
1088
|
+
}
|
|
1089
|
+
} else {
|
|
1090
|
+
return null;
|
|
1091
|
+
}
|
|
1092
|
+
}
|
|
1062
1093
|
}
|
|
1063
1094
|
|
|
1064
1095
|
CLIEngine.version = pkg.version;
|
|
1065
1096
|
CLIEngine.getFormatter = CLIEngine.prototype.getFormatter;
|
|
1066
1097
|
|
|
1067
1098
|
module.exports = {
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
|
|
1071
|
-
|
|
1072
|
-
|
|
1073
|
-
|
|
1074
|
-
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1099
|
+
CLIEngine,
|
|
1100
|
+
|
|
1101
|
+
/**
|
|
1102
|
+
* Get the internal slots of a given CLIEngine instance for tests.
|
|
1103
|
+
* @param {CLIEngine} instance The CLIEngine instance to get.
|
|
1104
|
+
* @returns {CLIEngineInternalSlots} The internal slots.
|
|
1105
|
+
*/
|
|
1106
|
+
getCLIEngineInternalSlots(instance) {
|
|
1107
|
+
return internalSlotsMap.get(instance);
|
|
1108
|
+
},
|
|
1078
1109
|
};
|