eslint 9.21.0 → 9.23.0

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.
Files changed (425) hide show
  1. package/README.md +52 -48
  2. package/bin/eslint.js +92 -90
  3. package/conf/default-cli-options.js +22 -22
  4. package/conf/ecma-version.js +1 -1
  5. package/conf/globals.js +97 -98
  6. package/conf/replacements.json +24 -20
  7. package/conf/rule-type-list.json +88 -92
  8. package/lib/api.js +12 -12
  9. package/lib/cli-engine/cli-engine.js +828 -808
  10. package/lib/cli-engine/file-enumerator.js +381 -387
  11. package/lib/cli-engine/formatters/formatters-meta.json +16 -16
  12. package/lib/cli-engine/formatters/html.js +107 -99
  13. package/lib/cli-engine/formatters/json-with-metadata.js +5 -5
  14. package/lib/cli-engine/formatters/json.js +2 -2
  15. package/lib/cli-engine/formatters/stylish.js +96 -75
  16. package/lib/cli-engine/hash.js +1 -1
  17. package/lib/cli-engine/index.js +1 -1
  18. package/lib/cli-engine/lint-result-cache.js +144 -145
  19. package/lib/cli-engine/load-rules.js +16 -16
  20. package/lib/cli.js +541 -457
  21. package/lib/config/config-loader.js +648 -618
  22. package/lib/config/config.js +247 -221
  23. package/lib/config/default-config.js +54 -45
  24. package/lib/config/flat-config-array.js +167 -172
  25. package/lib/config/flat-config-helpers.js +65 -68
  26. package/lib/config/flat-config-schema.js +375 -368
  27. package/lib/config/rule-validator.js +139 -144
  28. package/lib/config-api.js +12 -0
  29. package/lib/eslint/eslint-helpers.js +709 -679
  30. package/lib/eslint/eslint.js +944 -886
  31. package/lib/eslint/index.js +2 -2
  32. package/lib/eslint/legacy-eslint.js +576 -532
  33. package/lib/languages/js/index.js +263 -264
  34. package/lib/languages/js/source-code/index.js +1 -1
  35. package/lib/languages/js/source-code/source-code.js +1129 -1054
  36. package/lib/languages/js/source-code/token-store/backward-token-comment-cursor.js +39 -35
  37. package/lib/languages/js/source-code/token-store/backward-token-cursor.js +35 -36
  38. package/lib/languages/js/source-code/token-store/cursor.js +36 -36
  39. package/lib/languages/js/source-code/token-store/cursors.js +80 -52
  40. package/lib/languages/js/source-code/token-store/decorative-cursor.js +17 -18
  41. package/lib/languages/js/source-code/token-store/filter-cursor.js +19 -20
  42. package/lib/languages/js/source-code/token-store/forward-token-comment-cursor.js +40 -32
  43. package/lib/languages/js/source-code/token-store/forward-token-cursor.js +40 -41
  44. package/lib/languages/js/source-code/token-store/index.js +592 -498
  45. package/lib/languages/js/source-code/token-store/limit-cursor.js +17 -18
  46. package/lib/languages/js/source-code/token-store/padded-token-cursor.js +23 -16
  47. package/lib/languages/js/source-code/token-store/skip-cursor.js +19 -20
  48. package/lib/languages/js/source-code/token-store/utils.js +63 -60
  49. package/lib/languages/js/validate-language-options.js +104 -89
  50. package/lib/linter/apply-disable-directives.js +467 -383
  51. package/lib/linter/code-path-analysis/code-path-analyzer.js +650 -672
  52. package/lib/linter/code-path-analysis/code-path-segment.js +215 -216
  53. package/lib/linter/code-path-analysis/code-path-state.js +2118 -2096
  54. package/lib/linter/code-path-analysis/code-path.js +307 -319
  55. package/lib/linter/code-path-analysis/debug-helpers.js +183 -163
  56. package/lib/linter/code-path-analysis/fork-context.js +296 -271
  57. package/lib/linter/code-path-analysis/id-generator.js +22 -23
  58. package/lib/linter/file-context.js +119 -120
  59. package/lib/linter/index.js +3 -3
  60. package/lib/linter/interpolate.js +16 -16
  61. package/lib/linter/linter.js +2402 -2044
  62. package/lib/linter/node-event-generator.js +284 -225
  63. package/lib/linter/report-translator.js +256 -219
  64. package/lib/linter/rule-fixer.js +122 -124
  65. package/lib/linter/rules.js +35 -35
  66. package/lib/linter/safe-emitter.js +18 -18
  67. package/lib/linter/source-code-fixer.js +94 -92
  68. package/lib/linter/timing.js +104 -101
  69. package/lib/linter/vfile.js +70 -73
  70. package/lib/options.js +375 -361
  71. package/lib/rule-tester/index.js +1 -1
  72. package/lib/rule-tester/rule-tester.js +1307 -1045
  73. package/lib/rules/accessor-pairs.js +297 -262
  74. package/lib/rules/array-bracket-newline.js +249 -237
  75. package/lib/rules/array-bracket-spacing.js +262 -223
  76. package/lib/rules/array-callback-return.js +401 -355
  77. package/lib/rules/array-element-newline.js +357 -312
  78. package/lib/rules/arrow-body-style.js +399 -280
  79. package/lib/rules/arrow-parens.js +205 -172
  80. package/lib/rules/arrow-spacing.js +168 -162
  81. package/lib/rules/block-scoped-var.js +124 -122
  82. package/lib/rules/block-spacing.js +185 -175
  83. package/lib/rules/brace-style.js +261 -198
  84. package/lib/rules/callback-return.js +202 -189
  85. package/lib/rules/camelcase.js +402 -391
  86. package/lib/rules/capitalized-comments.js +252 -231
  87. package/lib/rules/class-methods-use-this.js +179 -171
  88. package/lib/rules/comma-dangle.js +378 -345
  89. package/lib/rules/comma-spacing.js +192 -194
  90. package/lib/rules/comma-style.js +374 -315
  91. package/lib/rules/complexity.js +172 -168
  92. package/lib/rules/computed-property-spacing.js +235 -210
  93. package/lib/rules/consistent-return.js +180 -169
  94. package/lib/rules/consistent-this.js +166 -146
  95. package/lib/rules/constructor-super.js +411 -403
  96. package/lib/rules/curly.js +406 -331
  97. package/lib/rules/default-case-last.js +37 -30
  98. package/lib/rules/default-case.js +88 -84
  99. package/lib/rules/default-param-last.js +68 -53
  100. package/lib/rules/dot-location.js +121 -109
  101. package/lib/rules/dot-notation.js +191 -155
  102. package/lib/rules/eol-last.js +121 -119
  103. package/lib/rules/eqeqeq.js +167 -154
  104. package/lib/rules/for-direction.js +145 -120
  105. package/lib/rules/func-call-spacing.js +260 -230
  106. package/lib/rules/func-name-matching.js +292 -208
  107. package/lib/rules/func-names.js +164 -163
  108. package/lib/rules/func-style.js +158 -126
  109. package/lib/rules/function-call-argument-newline.js +151 -128
  110. package/lib/rules/function-paren-newline.js +348 -290
  111. package/lib/rules/generator-star-spacing.js +228 -209
  112. package/lib/rules/getter-return.js +207 -171
  113. package/lib/rules/global-require.js +84 -73
  114. package/lib/rules/grouped-accessor-pairs.js +169 -149
  115. package/lib/rules/guard-for-in.js +71 -62
  116. package/lib/rules/handle-callback-err.js +107 -102
  117. package/lib/rules/id-blacklist.js +181 -198
  118. package/lib/rules/id-denylist.js +167 -186
  119. package/lib/rules/id-length.js +196 -170
  120. package/lib/rules/id-match.js +343 -288
  121. package/lib/rules/implicit-arrow-linebreak.js +101 -78
  122. package/lib/rules/indent-legacy.js +1343 -1117
  123. package/lib/rules/indent.js +2271 -1758
  124. package/lib/rules/index.js +317 -292
  125. package/lib/rules/init-declarations.js +115 -106
  126. package/lib/rules/jsx-quotes.js +93 -81
  127. package/lib/rules/key-spacing.js +749 -632
  128. package/lib/rules/keyword-spacing.js +647 -604
  129. package/lib/rules/line-comment-position.js +141 -127
  130. package/lib/rules/linebreak-style.js +106 -105
  131. package/lib/rules/lines-around-comment.js +539 -447
  132. package/lib/rules/lines-around-directive.js +232 -202
  133. package/lib/rules/lines-between-class-members.js +304 -233
  134. package/lib/rules/logical-assignment-operators.js +581 -398
  135. package/lib/rules/max-classes-per-file.js +68 -67
  136. package/lib/rules/max-depth.js +145 -142
  137. package/lib/rules/max-len.js +472 -433
  138. package/lib/rules/max-lines-per-function.js +200 -175
  139. package/lib/rules/max-lines.js +157 -161
  140. package/lib/rules/max-nested-callbacks.js +101 -103
  141. package/lib/rules/max-params.js +77 -75
  142. package/lib/rules/max-statements-per-line.js +204 -197
  143. package/lib/rules/max-statements.js +167 -163
  144. package/lib/rules/multiline-comment-style.js +636 -478
  145. package/lib/rules/multiline-ternary.js +240 -175
  146. package/lib/rules/new-cap.js +232 -212
  147. package/lib/rules/new-parens.js +87 -78
  148. package/lib/rules/newline-after-var.js +286 -249
  149. package/lib/rules/newline-before-return.js +228 -221
  150. package/lib/rules/newline-per-chained-call.js +141 -126
  151. package/lib/rules/no-alert.js +89 -78
  152. package/lib/rules/no-array-constructor.js +121 -112
  153. package/lib/rules/no-async-promise-executor.js +29 -23
  154. package/lib/rules/no-await-in-loop.js +68 -70
  155. package/lib/rules/no-bitwise.js +123 -99
  156. package/lib/rules/no-buffer-constructor.js +54 -46
  157. package/lib/rules/no-caller.js +38 -32
  158. package/lib/rules/no-case-declarations.js +60 -56
  159. package/lib/rules/no-catch-shadow.js +75 -72
  160. package/lib/rules/no-class-assign.js +50 -47
  161. package/lib/rules/no-compare-neg-zero.js +61 -47
  162. package/lib/rules/no-cond-assign.js +147 -131
  163. package/lib/rules/no-confusing-arrow.js +97 -80
  164. package/lib/rules/no-console.js +201 -190
  165. package/lib/rules/no-const-assign.js +46 -40
  166. package/lib/rules/no-constant-binary-expression.js +499 -404
  167. package/lib/rules/no-constant-condition.js +157 -142
  168. package/lib/rules/no-constructor-return.js +48 -48
  169. package/lib/rules/no-continue.js +24 -26
  170. package/lib/rules/no-control-regex.js +124 -120
  171. package/lib/rules/no-debugger.js +27 -29
  172. package/lib/rules/no-delete-var.js +28 -28
  173. package/lib/rules/no-div-regex.js +46 -40
  174. package/lib/rules/no-dupe-args.js +67 -68
  175. package/lib/rules/no-dupe-class-members.js +92 -88
  176. package/lib/rules/no-dupe-else-if.js +99 -76
  177. package/lib/rules/no-dupe-keys.js +132 -109
  178. package/lib/rules/no-duplicate-case.js +49 -42
  179. package/lib/rules/no-duplicate-imports.js +178 -175
  180. package/lib/rules/no-else-return.js +429 -384
  181. package/lib/rules/no-empty-character-class.js +56 -49
  182. package/lib/rules/no-empty-function.js +126 -127
  183. package/lib/rules/no-empty-pattern.js +62 -57
  184. package/lib/rules/no-empty-static-block.js +36 -34
  185. package/lib/rules/no-empty.js +97 -85
  186. package/lib/rules/no-eq-null.js +36 -31
  187. package/lib/rules/no-eval.js +255 -249
  188. package/lib/rules/no-ex-assign.js +41 -38
  189. package/lib/rules/no-extend-native.js +160 -158
  190. package/lib/rules/no-extra-bind.js +200 -189
  191. package/lib/rules/no-extra-boolean-cast.js +397 -347
  192. package/lib/rules/no-extra-label.js +149 -130
  193. package/lib/rules/no-extra-parens.js +1653 -1324
  194. package/lib/rules/no-extra-semi.js +145 -143
  195. package/lib/rules/no-fallthrough.js +198 -156
  196. package/lib/rules/no-floating-decimal.js +73 -65
  197. package/lib/rules/no-func-assign.js +53 -54
  198. package/lib/rules/no-global-assign.js +77 -72
  199. package/lib/rules/no-implicit-coercion.js +348 -292
  200. package/lib/rules/no-implicit-globals.js +157 -134
  201. package/lib/rules/no-implied-eval.js +139 -111
  202. package/lib/rules/no-import-assign.js +144 -158
  203. package/lib/rules/no-inline-comments.js +100 -94
  204. package/lib/rules/no-inner-declarations.js +114 -100
  205. package/lib/rules/no-invalid-regexp.js +221 -189
  206. package/lib/rules/no-invalid-this.js +122 -116
  207. package/lib/rules/no-irregular-whitespace.js +265 -251
  208. package/lib/rules/no-iterator.js +28 -32
  209. package/lib/rules/no-label-var.js +58 -61
  210. package/lib/rules/no-labels.js +137 -132
  211. package/lib/rules/no-lone-blocks.js +126 -122
  212. package/lib/rules/no-lonely-if.js +107 -76
  213. package/lib/rules/no-loop-func.js +233 -212
  214. package/lib/rules/no-loss-of-precision.js +215 -200
  215. package/lib/rules/no-magic-numbers.js +245 -217
  216. package/lib/rules/no-misleading-character-class.js +498 -445
  217. package/lib/rules/no-mixed-operators.js +187 -181
  218. package/lib/rules/no-mixed-requires.js +252 -239
  219. package/lib/rules/no-mixed-spaces-and-tabs.js +133 -120
  220. package/lib/rules/no-multi-assign.js +45 -43
  221. package/lib/rules/no-multi-spaces.js +162 -142
  222. package/lib/rules/no-multi-str.js +41 -40
  223. package/lib/rules/no-multiple-empty-lines.js +195 -157
  224. package/lib/rules/no-native-reassign.js +89 -84
  225. package/lib/rules/no-negated-condition.js +78 -74
  226. package/lib/rules/no-negated-in-lhs.js +44 -42
  227. package/lib/rules/no-nested-ternary.js +32 -31
  228. package/lib/rules/no-new-func.js +70 -61
  229. package/lib/rules/no-new-native-nonconstructor.js +42 -38
  230. package/lib/rules/no-new-object.js +47 -47
  231. package/lib/rules/no-new-require.js +47 -46
  232. package/lib/rules/no-new-symbol.js +51 -49
  233. package/lib/rules/no-new-wrappers.js +42 -40
  234. package/lib/rules/no-new.js +27 -28
  235. package/lib/rules/no-nonoctal-decimal-escape.js +140 -120
  236. package/lib/rules/no-obj-calls.js +65 -52
  237. package/lib/rules/no-object-constructor.js +103 -96
  238. package/lib/rules/no-octal-escape.js +39 -42
  239. package/lib/rules/no-octal.js +31 -31
  240. package/lib/rules/no-param-reassign.js +234 -216
  241. package/lib/rules/no-path-concat.js +65 -66
  242. package/lib/rules/no-plusplus.js +59 -60
  243. package/lib/rules/no-process-env.js +48 -47
  244. package/lib/rules/no-process-exit.js +53 -49
  245. package/lib/rules/no-promise-executor-return.js +213 -181
  246. package/lib/rules/no-proto.js +25 -28
  247. package/lib/rules/no-prototype-builtins.js +145 -123
  248. package/lib/rules/no-redeclare.js +153 -151
  249. package/lib/rules/no-regex-spaces.js +182 -160
  250. package/lib/rules/no-restricted-exports.js +207 -184
  251. package/lib/rules/no-restricted-globals.js +110 -111
  252. package/lib/rules/no-restricted-imports.js +656 -536
  253. package/lib/rules/no-restricted-modules.js +221 -201
  254. package/lib/rules/no-restricted-properties.js +180 -152
  255. package/lib/rules/no-restricted-syntax.js +55 -51
  256. package/lib/rules/no-return-assign.js +54 -49
  257. package/lib/rules/no-return-await.js +147 -123
  258. package/lib/rules/no-script-url.js +51 -44
  259. package/lib/rules/no-self-assign.js +147 -145
  260. package/lib/rules/no-self-compare.js +62 -45
  261. package/lib/rules/no-sequences.js +134 -115
  262. package/lib/rules/no-setter-return.js +184 -151
  263. package/lib/rules/no-shadow-restricted-names.js +60 -45
  264. package/lib/rules/no-shadow.js +341 -315
  265. package/lib/rules/no-spaced-func.js +81 -76
  266. package/lib/rules/no-sparse-arrays.js +53 -58
  267. package/lib/rules/no-sync.js +60 -59
  268. package/lib/rules/no-tabs.js +82 -71
  269. package/lib/rules/no-template-curly-in-string.js +32 -31
  270. package/lib/rules/no-ternary.js +24 -28
  271. package/lib/rules/no-this-before-super.js +320 -318
  272. package/lib/rules/no-throw-literal.js +30 -35
  273. package/lib/rules/no-trailing-spaces.js +198 -190
  274. package/lib/rules/no-undef-init.js +75 -60
  275. package/lib/rules/no-undef.js +50 -47
  276. package/lib/rules/no-undefined.js +72 -74
  277. package/lib/rules/no-underscore-dangle.js +369 -326
  278. package/lib/rules/no-unexpected-multiline.js +111 -101
  279. package/lib/rules/no-unmodified-loop-condition.js +253 -253
  280. package/lib/rules/no-unneeded-ternary.js +211 -146
  281. package/lib/rules/no-unreachable-loop.js +144 -141
  282. package/lib/rules/no-unreachable.js +254 -247
  283. package/lib/rules/no-unsafe-finally.js +92 -84
  284. package/lib/rules/no-unsafe-negation.js +104 -82
  285. package/lib/rules/no-unsafe-optional-chaining.js +191 -177
  286. package/lib/rules/no-unused-expressions.js +177 -161
  287. package/lib/rules/no-unused-labels.js +138 -123
  288. package/lib/rules/no-unused-private-class-members.js +205 -181
  289. package/lib/rules/no-unused-vars.js +1668 -1448
  290. package/lib/rules/no-use-before-define.js +228 -230
  291. package/lib/rules/no-useless-assignment.js +589 -510
  292. package/lib/rules/no-useless-backreference.js +211 -192
  293. package/lib/rules/no-useless-call.js +57 -52
  294. package/lib/rules/no-useless-catch.js +39 -39
  295. package/lib/rules/no-useless-computed-key.js +143 -114
  296. package/lib/rules/no-useless-concat.js +64 -59
  297. package/lib/rules/no-useless-constructor.js +157 -110
  298. package/lib/rules/no-useless-escape.js +341 -290
  299. package/lib/rules/no-useless-rename.js +182 -155
  300. package/lib/rules/no-useless-return.js +343 -311
  301. package/lib/rules/no-var.js +232 -211
  302. package/lib/rules/no-void.js +49 -47
  303. package/lib/rules/no-warning-comments.js +190 -185
  304. package/lib/rules/no-whitespace-before-property.js +130 -114
  305. package/lib/rules/no-with.js +23 -25
  306. package/lib/rules/nonblock-statement-body-position.js +148 -129
  307. package/lib/rules/object-curly-newline.js +305 -264
  308. package/lib/rules/object-curly-spacing.js +359 -313
  309. package/lib/rules/object-property-newline.js +136 -105
  310. package/lib/rules/object-shorthand.js +606 -501
  311. package/lib/rules/one-var-declaration-per-line.js +103 -99
  312. package/lib/rules/one-var.js +652 -536
  313. package/lib/rules/operator-assignment.js +218 -160
  314. package/lib/rules/operator-linebreak.js +294 -250
  315. package/lib/rules/padded-blocks.js +345 -307
  316. package/lib/rules/padding-line-between-statements.js +442 -438
  317. package/lib/rules/prefer-arrow-callback.js +361 -312
  318. package/lib/rules/prefer-const.js +417 -376
  319. package/lib/rules/prefer-destructuring.js +300 -278
  320. package/lib/rules/prefer-exponentiation-operator.js +175 -132
  321. package/lib/rules/prefer-named-capture-group.js +152 -139
  322. package/lib/rules/prefer-numeric-literals.js +120 -112
  323. package/lib/rules/prefer-object-has-own.js +115 -81
  324. package/lib/rules/prefer-object-spread.js +212 -192
  325. package/lib/rules/prefer-promise-reject-errors.js +139 -121
  326. package/lib/rules/prefer-reflect.js +126 -106
  327. package/lib/rules/prefer-regex-literals.js +577 -465
  328. package/lib/rules/prefer-rest-params.js +78 -79
  329. package/lib/rules/prefer-spread.js +46 -43
  330. package/lib/rules/prefer-template.js +265 -194
  331. package/lib/rules/quote-props.js +372 -306
  332. package/lib/rules/quotes.js +373 -325
  333. package/lib/rules/radix.js +151 -135
  334. package/lib/rules/require-atomic-updates.js +315 -284
  335. package/lib/rules/require-await.js +143 -115
  336. package/lib/rules/require-unicode-regexp.js +281 -176
  337. package/lib/rules/require-yield.js +52 -53
  338. package/lib/rules/rest-spread-spacing.js +127 -115
  339. package/lib/rules/semi-spacing.js +280 -249
  340. package/lib/rules/semi-style.js +175 -133
  341. package/lib/rules/semi.js +455 -435
  342. package/lib/rules/sort-imports.js +305 -232
  343. package/lib/rules/sort-keys.js +218 -187
  344. package/lib/rules/sort-vars.js +126 -92
  345. package/lib/rules/space-before-blocks.js +198 -188
  346. package/lib/rules/space-before-function-paren.js +185 -165
  347. package/lib/rules/space-in-parens.js +358 -287
  348. package/lib/rules/space-infix-ops.js +236 -200
  349. package/lib/rules/space-unary-ops.js +355 -297
  350. package/lib/rules/spaced-comment.js +362 -318
  351. package/lib/rules/strict.js +264 -229
  352. package/lib/rules/switch-colon-spacing.js +129 -121
  353. package/lib/rules/symbol-description.js +44 -47
  354. package/lib/rules/template-curly-spacing.js +147 -141
  355. package/lib/rules/template-tag-spacing.js +97 -87
  356. package/lib/rules/unicode-bom.js +53 -55
  357. package/lib/rules/use-isnan.js +236 -205
  358. package/lib/rules/utils/ast-utils.js +2039 -1860
  359. package/lib/rules/utils/char-source.js +162 -155
  360. package/lib/rules/utils/fix-tracker.js +83 -80
  361. package/lib/rules/utils/keywords.js +59 -59
  362. package/lib/rules/utils/lazy-loading-rule-map.js +79 -76
  363. package/lib/rules/utils/regular-expressions.js +32 -24
  364. package/lib/rules/utils/unicode/index.js +4 -4
  365. package/lib/rules/utils/unicode/is-combining-character.js +1 -1
  366. package/lib/rules/utils/unicode/is-emoji-modifier.js +1 -1
  367. package/lib/rules/utils/unicode/is-regional-indicator-symbol.js +1 -1
  368. package/lib/rules/utils/unicode/is-surrogate-pair.js +1 -1
  369. package/lib/rules/valid-typeof.js +152 -110
  370. package/lib/rules/vars-on-top.js +151 -144
  371. package/lib/rules/wrap-iife.js +203 -190
  372. package/lib/rules/wrap-regex.js +69 -57
  373. package/lib/rules/yield-star-spacing.js +144 -133
  374. package/lib/rules/yoda.js +282 -271
  375. package/lib/services/parser-service.js +35 -35
  376. package/lib/services/processor-service.js +66 -73
  377. package/lib/shared/ajv.js +14 -14
  378. package/lib/shared/assert.js +3 -4
  379. package/lib/shared/ast-utils.js +7 -6
  380. package/lib/shared/deep-merge-arrays.js +24 -22
  381. package/lib/shared/directives.js +3 -2
  382. package/lib/shared/flags.js +46 -17
  383. package/lib/shared/logging.js +24 -25
  384. package/lib/shared/option-utils.js +43 -36
  385. package/lib/shared/runtime-info.js +136 -127
  386. package/lib/shared/serialization.js +27 -27
  387. package/lib/shared/severity.js +22 -22
  388. package/lib/shared/stats.js +5 -5
  389. package/lib/shared/string-utils.js +16 -16
  390. package/lib/shared/text-table.js +28 -27
  391. package/lib/shared/traverser.js +153 -146
  392. package/lib/types/config-api.d.ts +8 -0
  393. package/lib/types/index.d.ts +2010 -1559
  394. package/lib/types/rules.d.ts +5312 -0
  395. package/lib/types/use-at-your-own-risk.d.ts +32 -30
  396. package/lib/unsupported-api.js +5 -5
  397. package/messages/all-files-ignored.js +3 -3
  398. package/messages/all-matched-files-ignored.js +3 -3
  399. package/messages/config-file-missing.js +2 -2
  400. package/messages/config-plugin-missing.js +3 -3
  401. package/messages/config-serialize-function.js +9 -7
  402. package/messages/eslintrc-incompat.js +13 -15
  403. package/messages/eslintrc-plugins.js +3 -4
  404. package/messages/extend-config-missing.js +3 -3
  405. package/messages/failed-to-read-json.js +3 -3
  406. package/messages/file-not-found.js +3 -3
  407. package/messages/invalid-rule-options.js +2 -2
  408. package/messages/invalid-rule-severity.js +2 -2
  409. package/messages/no-config-found.js +3 -3
  410. package/messages/plugin-conflict.js +8 -8
  411. package/messages/plugin-invalid.js +3 -3
  412. package/messages/plugin-missing.js +3 -3
  413. package/messages/print-config-with-directory-path.js +2 -2
  414. package/messages/shared.js +6 -1
  415. package/messages/whitespace-found.js +3 -3
  416. package/package.json +22 -20
  417. package/lib/types/rules/best-practices.d.ts +0 -1143
  418. package/lib/types/rules/deprecated.d.ts +0 -252
  419. package/lib/types/rules/ecmascript-6.d.ts +0 -647
  420. package/lib/types/rules/index.d.ts +0 -50
  421. package/lib/types/rules/node-commonjs.d.ts +0 -171
  422. package/lib/types/rules/possible-errors.d.ts +0 -685
  423. package/lib/types/rules/strict-mode.d.ts +0 -38
  424. package/lib/types/rules/stylistic-issues.d.ts +0 -2043
  425. package/lib/types/rules/variables.d.ts +0 -234
@@ -10,11 +10,11 @@
10
10
  //------------------------------------------------------------------------------
11
11
 
12
12
  const assert = require("../../shared/assert"),
13
- { breakableTypePattern } = require("../../shared/ast-utils"),
14
- CodePath = require("./code-path"),
15
- CodePathSegment = require("./code-path-segment"),
16
- IdGenerator = require("./id-generator"),
17
- debug = require("./debug-helpers");
13
+ { breakableTypePattern } = require("../../shared/ast-utils"),
14
+ CodePath = require("./code-path"),
15
+ CodePathSegment = require("./code-path-segment"),
16
+ IdGenerator = require("./id-generator"),
17
+ debug = require("./debug-helpers");
18
18
 
19
19
  //------------------------------------------------------------------------------
20
20
  // Helpers
@@ -26,7 +26,7 @@ const assert = require("../../shared/assert"),
26
26
  * @returns {boolean} `true` if the node is a `case` node (not `default` node).
27
27
  */
28
28
  function isCaseNode(node) {
29
- return Boolean(node.test);
29
+ return Boolean(node.test);
30
30
  }
31
31
 
32
32
  /**
@@ -36,9 +36,11 @@ function isCaseNode(node) {
36
36
  * false if not.
37
37
  */
38
38
  function isPropertyDefinitionValue(node) {
39
- const parent = node.parent;
39
+ const parent = node.parent;
40
40
 
41
- return parent && parent.type === "PropertyDefinition" && parent.value === node;
41
+ return (
42
+ parent && parent.type === "PropertyDefinition" && parent.value === node
43
+ );
42
44
  }
43
45
 
44
46
  /**
@@ -48,7 +50,7 @@ function isPropertyDefinitionValue(node) {
48
50
  * @returns {boolean} `true` if the operator is "&&" or "||" or "??"
49
51
  */
50
52
  function isHandledLogicalOperator(operator) {
51
- return operator === "&&" || operator === "||" || operator === "??";
53
+ return operator === "&&" || operator === "||" || operator === "??";
52
54
  }
53
55
 
54
56
  /**
@@ -59,7 +61,7 @@ function isHandledLogicalOperator(operator) {
59
61
  * @returns {boolean} `true` if the operator is "&&=" or "||=" or "??="
60
62
  */
61
63
  function isLogicalAssignmentOperator(operator) {
62
- return operator === "&&=" || operator === "||=" || operator === "??=";
64
+ return operator === "&&=" || operator === "||=" || operator === "??=";
63
65
  }
64
66
 
65
67
  /**
@@ -68,10 +70,10 @@ function isLogicalAssignmentOperator(operator) {
68
70
  * @returns {string|null} The label or `null`.
69
71
  */
70
72
  function getLabel(node) {
71
- if (node.parent.type === "LabeledStatement") {
72
- return node.parent.label.name;
73
- }
74
- return null;
73
+ if (node.parent.type === "LabeledStatement") {
74
+ return node.parent.label.name;
75
+ }
76
+ return null;
75
77
  }
76
78
 
77
79
  /**
@@ -81,25 +83,25 @@ function getLabel(node) {
81
83
  * @returns {boolean} `true` if the node is a test of a choice statement.
82
84
  */
83
85
  function isForkingByTrueOrFalse(node) {
84
- const parent = node.parent;
86
+ const parent = node.parent;
85
87
 
86
- switch (parent.type) {
87
- case "ConditionalExpression":
88
- case "IfStatement":
89
- case "WhileStatement":
90
- case "DoWhileStatement":
91
- case "ForStatement":
92
- return parent.test === node;
88
+ switch (parent.type) {
89
+ case "ConditionalExpression":
90
+ case "IfStatement":
91
+ case "WhileStatement":
92
+ case "DoWhileStatement":
93
+ case "ForStatement":
94
+ return parent.test === node;
93
95
 
94
- case "LogicalExpression":
95
- return isHandledLogicalOperator(parent.operator);
96
+ case "LogicalExpression":
97
+ return isHandledLogicalOperator(parent.operator);
96
98
 
97
- case "AssignmentExpression":
98
- return isLogicalAssignmentOperator(parent.operator);
99
+ case "AssignmentExpression":
100
+ return isLogicalAssignmentOperator(parent.operator);
99
101
 
100
- default:
101
- return false;
102
- }
102
+ default:
103
+ return false;
104
+ }
103
105
  }
104
106
 
105
107
  /**
@@ -113,10 +115,10 @@ function isForkingByTrueOrFalse(node) {
113
115
  * otherwise `undefined`.
114
116
  */
115
117
  function getBooleanValueIfSimpleConstant(node) {
116
- if (node.type === "Literal") {
117
- return Boolean(node.value);
118
- }
119
- return void 0;
118
+ if (node.type === "Literal") {
119
+ return Boolean(node.value);
120
+ }
121
+ return void 0;
120
122
  }
121
123
 
122
124
  /**
@@ -127,43 +129,39 @@ function getBooleanValueIfSimpleConstant(node) {
127
129
  * @returns {boolean} `true` if the node is a reference.
128
130
  */
129
131
  function isIdentifierReference(node) {
130
- const parent = node.parent;
131
-
132
- switch (parent.type) {
133
- case "LabeledStatement":
134
- case "BreakStatement":
135
- case "ContinueStatement":
136
- case "ArrayPattern":
137
- case "RestElement":
138
- case "ImportSpecifier":
139
- case "ImportDefaultSpecifier":
140
- case "ImportNamespaceSpecifier":
141
- case "CatchClause":
142
- return false;
143
-
144
- case "FunctionDeclaration":
145
- case "FunctionExpression":
146
- case "ArrowFunctionExpression":
147
- case "ClassDeclaration":
148
- case "ClassExpression":
149
- case "VariableDeclarator":
150
- return parent.id !== node;
151
-
152
- case "Property":
153
- case "PropertyDefinition":
154
- case "MethodDefinition":
155
- return (
156
- parent.key !== node ||
157
- parent.computed ||
158
- parent.shorthand
159
- );
160
-
161
- case "AssignmentPattern":
162
- return parent.key !== node;
163
-
164
- default:
165
- return true;
166
- }
132
+ const parent = node.parent;
133
+
134
+ switch (parent.type) {
135
+ case "LabeledStatement":
136
+ case "BreakStatement":
137
+ case "ContinueStatement":
138
+ case "ArrayPattern":
139
+ case "RestElement":
140
+ case "ImportSpecifier":
141
+ case "ImportDefaultSpecifier":
142
+ case "ImportNamespaceSpecifier":
143
+ case "CatchClause":
144
+ return false;
145
+
146
+ case "FunctionDeclaration":
147
+ case "FunctionExpression":
148
+ case "ArrowFunctionExpression":
149
+ case "ClassDeclaration":
150
+ case "ClassExpression":
151
+ case "VariableDeclarator":
152
+ return parent.id !== node;
153
+
154
+ case "Property":
155
+ case "PropertyDefinition":
156
+ case "MethodDefinition":
157
+ return parent.key !== node || parent.computed || parent.shorthand;
158
+
159
+ case "AssignmentPattern":
160
+ return parent.key !== node;
161
+
162
+ default:
163
+ return true;
164
+ }
167
165
  }
168
166
 
169
167
  /**
@@ -179,58 +177,47 @@ function isIdentifierReference(node) {
179
177
  * @returns {void}
180
178
  */
181
179
  function forwardCurrentToHead(analyzer, node) {
182
- const codePath = analyzer.codePath;
183
- const state = CodePath.getState(codePath);
184
- const currentSegments = state.currentSegments;
185
- const headSegments = state.headSegments;
186
- const end = Math.max(currentSegments.length, headSegments.length);
187
- let i, currentSegment, headSegment;
188
-
189
- // Fires leaving events.
190
- for (i = 0; i < end; ++i) {
191
- currentSegment = currentSegments[i];
192
- headSegment = headSegments[i];
193
-
194
- if (currentSegment !== headSegment && currentSegment) {
195
-
196
- const eventName = currentSegment.reachable
197
- ? "onCodePathSegmentEnd"
198
- : "onUnreachableCodePathSegmentEnd";
199
-
200
- debug.dump(`${eventName} ${currentSegment.id}`);
201
-
202
- analyzer.emitter.emit(
203
- eventName,
204
- currentSegment,
205
- node
206
- );
207
- }
208
- }
209
-
210
- // Update state.
211
- state.currentSegments = headSegments;
212
-
213
- // Fires entering events.
214
- for (i = 0; i < end; ++i) {
215
- currentSegment = currentSegments[i];
216
- headSegment = headSegments[i];
217
-
218
- if (currentSegment !== headSegment && headSegment) {
219
-
220
- const eventName = headSegment.reachable
221
- ? "onCodePathSegmentStart"
222
- : "onUnreachableCodePathSegmentStart";
223
-
224
- debug.dump(`${eventName} ${headSegment.id}`);
225
- CodePathSegment.markUsed(headSegment);
226
- analyzer.emitter.emit(
227
- eventName,
228
- headSegment,
229
- node
230
- );
231
- }
232
- }
233
-
180
+ const codePath = analyzer.codePath;
181
+ const state = CodePath.getState(codePath);
182
+ const currentSegments = state.currentSegments;
183
+ const headSegments = state.headSegments;
184
+ const end = Math.max(currentSegments.length, headSegments.length);
185
+ let i, currentSegment, headSegment;
186
+
187
+ // Fires leaving events.
188
+ for (i = 0; i < end; ++i) {
189
+ currentSegment = currentSegments[i];
190
+ headSegment = headSegments[i];
191
+
192
+ if (currentSegment !== headSegment && currentSegment) {
193
+ const eventName = currentSegment.reachable
194
+ ? "onCodePathSegmentEnd"
195
+ : "onUnreachableCodePathSegmentEnd";
196
+
197
+ debug.dump(`${eventName} ${currentSegment.id}`);
198
+
199
+ analyzer.emitter.emit(eventName, currentSegment, node);
200
+ }
201
+ }
202
+
203
+ // Update state.
204
+ state.currentSegments = headSegments;
205
+
206
+ // Fires entering events.
207
+ for (i = 0; i < end; ++i) {
208
+ currentSegment = currentSegments[i];
209
+ headSegment = headSegments[i];
210
+
211
+ if (currentSegment !== headSegment && headSegment) {
212
+ const eventName = headSegment.reachable
213
+ ? "onCodePathSegmentStart"
214
+ : "onUnreachableCodePathSegmentStart";
215
+
216
+ debug.dump(`${eventName} ${headSegment.id}`);
217
+ CodePathSegment.markUsed(headSegment);
218
+ analyzer.emitter.emit(eventName, headSegment, node);
219
+ }
220
+ }
234
221
  }
235
222
 
236
223
  /**
@@ -241,25 +228,21 @@ function forwardCurrentToHead(analyzer, node) {
241
228
  * @returns {void}
242
229
  */
243
230
  function leaveFromCurrentSegment(analyzer, node) {
244
- const state = CodePath.getState(analyzer.codePath);
245
- const currentSegments = state.currentSegments;
231
+ const state = CodePath.getState(analyzer.codePath);
232
+ const currentSegments = state.currentSegments;
246
233
 
247
- for (let i = 0; i < currentSegments.length; ++i) {
248
- const currentSegment = currentSegments[i];
249
- const eventName = currentSegment.reachable
250
- ? "onCodePathSegmentEnd"
251
- : "onUnreachableCodePathSegmentEnd";
234
+ for (let i = 0; i < currentSegments.length; ++i) {
235
+ const currentSegment = currentSegments[i];
236
+ const eventName = currentSegment.reachable
237
+ ? "onCodePathSegmentEnd"
238
+ : "onUnreachableCodePathSegmentEnd";
252
239
 
253
- debug.dump(`${eventName} ${currentSegment.id}`);
240
+ debug.dump(`${eventName} ${currentSegment.id}`);
254
241
 
255
- analyzer.emitter.emit(
256
- eventName,
257
- currentSegment,
258
- node
259
- );
260
- }
242
+ analyzer.emitter.emit(eventName, currentSegment, node);
243
+ }
261
244
 
262
- state.currentSegments = [];
245
+ state.currentSegments = [];
263
246
  }
264
247
 
265
248
  /**
@@ -273,128 +256,129 @@ function leaveFromCurrentSegment(analyzer, node) {
273
256
  * @returns {void}
274
257
  */
275
258
  function preprocess(analyzer, node) {
276
- const codePath = analyzer.codePath;
277
- const state = CodePath.getState(codePath);
278
- const parent = node.parent;
279
-
280
- switch (parent.type) {
281
-
282
- // The `arguments.length == 0` case is in `postprocess` function.
283
- case "CallExpression":
284
- if (parent.optional === true && parent.arguments.length >= 1 && parent.arguments[0] === node) {
285
- state.makeOptionalRight();
286
- }
287
- break;
288
- case "MemberExpression":
289
- if (parent.optional === true && parent.property === node) {
290
- state.makeOptionalRight();
291
- }
292
- break;
293
-
294
- case "LogicalExpression":
295
- if (
296
- parent.right === node &&
297
- isHandledLogicalOperator(parent.operator)
298
- ) {
299
- state.makeLogicalRight();
300
- }
301
- break;
302
-
303
- case "AssignmentExpression":
304
- if (
305
- parent.right === node &&
306
- isLogicalAssignmentOperator(parent.operator)
307
- ) {
308
- state.makeLogicalRight();
309
- }
310
- break;
311
-
312
- case "ConditionalExpression":
313
- case "IfStatement":
314
-
315
- /*
316
- * Fork if this node is at `consequent`/`alternate`.
317
- * `popForkContext()` exists at `IfStatement:exit` and
318
- * `ConditionalExpression:exit`.
319
- */
320
- if (parent.consequent === node) {
321
- state.makeIfConsequent();
322
- } else if (parent.alternate === node) {
323
- state.makeIfAlternate();
324
- }
325
- break;
326
-
327
- case "SwitchCase":
328
- if (parent.consequent[0] === node) {
329
- state.makeSwitchCaseBody(false, !parent.test);
330
- }
331
- break;
332
-
333
- case "TryStatement":
334
- if (parent.handler === node) {
335
- state.makeCatchBlock();
336
- } else if (parent.finalizer === node) {
337
- state.makeFinallyBlock();
338
- }
339
- break;
340
-
341
- case "WhileStatement":
342
- if (parent.test === node) {
343
- state.makeWhileTest(getBooleanValueIfSimpleConstant(node));
344
- } else {
345
- assert(parent.body === node);
346
- state.makeWhileBody();
347
- }
348
- break;
349
-
350
- case "DoWhileStatement":
351
- if (parent.body === node) {
352
- state.makeDoWhileBody();
353
- } else {
354
- assert(parent.test === node);
355
- state.makeDoWhileTest(getBooleanValueIfSimpleConstant(node));
356
- }
357
- break;
358
-
359
- case "ForStatement":
360
- if (parent.test === node) {
361
- state.makeForTest(getBooleanValueIfSimpleConstant(node));
362
- } else if (parent.update === node) {
363
- state.makeForUpdate();
364
- } else if (parent.body === node) {
365
- state.makeForBody();
366
- }
367
- break;
368
-
369
- case "ForInStatement":
370
- case "ForOfStatement":
371
- if (parent.left === node) {
372
- state.makeForInOfLeft();
373
- } else if (parent.right === node) {
374
- state.makeForInOfRight();
375
- } else {
376
- assert(parent.body === node);
377
- state.makeForInOfBody();
378
- }
379
- break;
380
-
381
- case "AssignmentPattern":
382
-
383
- /*
384
- * Fork if this node is at `right`.
385
- * `left` is executed always, so it uses the current path.
386
- * `popForkContext()` exists at `AssignmentPattern:exit`.
387
- */
388
- if (parent.right === node) {
389
- state.pushForkContext();
390
- state.forkBypassPath();
391
- state.forkPath();
392
- }
393
- break;
394
-
395
- default:
396
- break;
397
- }
259
+ const codePath = analyzer.codePath;
260
+ const state = CodePath.getState(codePath);
261
+ const parent = node.parent;
262
+
263
+ switch (parent.type) {
264
+ // The `arguments.length == 0` case is in `postprocess` function.
265
+ case "CallExpression":
266
+ if (
267
+ parent.optional === true &&
268
+ parent.arguments.length >= 1 &&
269
+ parent.arguments[0] === node
270
+ ) {
271
+ state.makeOptionalRight();
272
+ }
273
+ break;
274
+ case "MemberExpression":
275
+ if (parent.optional === true && parent.property === node) {
276
+ state.makeOptionalRight();
277
+ }
278
+ break;
279
+
280
+ case "LogicalExpression":
281
+ if (
282
+ parent.right === node &&
283
+ isHandledLogicalOperator(parent.operator)
284
+ ) {
285
+ state.makeLogicalRight();
286
+ }
287
+ break;
288
+
289
+ case "AssignmentExpression":
290
+ if (
291
+ parent.right === node &&
292
+ isLogicalAssignmentOperator(parent.operator)
293
+ ) {
294
+ state.makeLogicalRight();
295
+ }
296
+ break;
297
+
298
+ case "ConditionalExpression":
299
+ case "IfStatement":
300
+ /*
301
+ * Fork if this node is at `consequent`/`alternate`.
302
+ * `popForkContext()` exists at `IfStatement:exit` and
303
+ * `ConditionalExpression:exit`.
304
+ */
305
+ if (parent.consequent === node) {
306
+ state.makeIfConsequent();
307
+ } else if (parent.alternate === node) {
308
+ state.makeIfAlternate();
309
+ }
310
+ break;
311
+
312
+ case "SwitchCase":
313
+ if (parent.consequent[0] === node) {
314
+ state.makeSwitchCaseBody(false, !parent.test);
315
+ }
316
+ break;
317
+
318
+ case "TryStatement":
319
+ if (parent.handler === node) {
320
+ state.makeCatchBlock();
321
+ } else if (parent.finalizer === node) {
322
+ state.makeFinallyBlock();
323
+ }
324
+ break;
325
+
326
+ case "WhileStatement":
327
+ if (parent.test === node) {
328
+ state.makeWhileTest(getBooleanValueIfSimpleConstant(node));
329
+ } else {
330
+ assert(parent.body === node);
331
+ state.makeWhileBody();
332
+ }
333
+ break;
334
+
335
+ case "DoWhileStatement":
336
+ if (parent.body === node) {
337
+ state.makeDoWhileBody();
338
+ } else {
339
+ assert(parent.test === node);
340
+ state.makeDoWhileTest(getBooleanValueIfSimpleConstant(node));
341
+ }
342
+ break;
343
+
344
+ case "ForStatement":
345
+ if (parent.test === node) {
346
+ state.makeForTest(getBooleanValueIfSimpleConstant(node));
347
+ } else if (parent.update === node) {
348
+ state.makeForUpdate();
349
+ } else if (parent.body === node) {
350
+ state.makeForBody();
351
+ }
352
+ break;
353
+
354
+ case "ForInStatement":
355
+ case "ForOfStatement":
356
+ if (parent.left === node) {
357
+ state.makeForInOfLeft();
358
+ } else if (parent.right === node) {
359
+ state.makeForInOfRight();
360
+ } else {
361
+ assert(parent.body === node);
362
+ state.makeForInOfBody();
363
+ }
364
+ break;
365
+
366
+ case "AssignmentPattern":
367
+ /*
368
+ * Fork if this node is at `right`.
369
+ * `left` is executed always, so it uses the current path.
370
+ * `popForkContext()` exists at `AssignmentPattern:exit`.
371
+ */
372
+ if (parent.right === node) {
373
+ state.pushForkContext();
374
+ state.forkBypassPath();
375
+ state.forkPath();
376
+ }
377
+ break;
378
+
379
+ default:
380
+ break;
381
+ }
398
382
  }
399
383
 
400
384
  /**
@@ -404,155 +388,152 @@ function preprocess(analyzer, node) {
404
388
  * @returns {void}
405
389
  */
406
390
  function processCodePathToEnter(analyzer, node) {
407
- let codePath = analyzer.codePath;
408
- let state = codePath && CodePath.getState(codePath);
409
- const parent = node.parent;
410
-
411
- /**
412
- * Creates a new code path and trigger the onCodePathStart event
413
- * based on the currently selected node.
414
- * @param {string} origin The reason the code path was started.
415
- * @returns {void}
416
- */
417
- function startCodePath(origin) {
418
- if (codePath) {
419
-
420
- // Emits onCodePathSegmentStart events if updated.
421
- forwardCurrentToHead(analyzer, node);
422
- debug.dumpState(node, state, false);
423
- }
424
-
425
- // Create the code path of this scope.
426
- codePath = analyzer.codePath = new CodePath({
427
- id: analyzer.idGenerator.next(),
428
- origin,
429
- upper: codePath,
430
- onLooped: analyzer.onLooped
431
- });
432
- state = CodePath.getState(codePath);
433
-
434
- // Emits onCodePathStart events.
435
- debug.dump(`onCodePathStart ${codePath.id}`);
436
- analyzer.emitter.emit("onCodePathStart", codePath, node);
437
- }
438
-
439
- /*
440
- * Special case: The right side of class field initializer is considered
441
- * to be its own function, so we need to start a new code path in this
442
- * case.
443
- */
444
- if (isPropertyDefinitionValue(node)) {
445
- startCodePath("class-field-initializer");
446
-
447
- /*
448
- * Intentional fall through because `node` needs to also be
449
- * processed by the code below. For example, if we have:
450
- *
451
- * class Foo {
452
- * a = () => {}
453
- * }
454
- *
455
- * In this case, we also need start a second code path.
456
- */
457
-
458
- }
459
-
460
- switch (node.type) {
461
- case "Program":
462
- startCodePath("program");
463
- break;
464
-
465
- case "FunctionDeclaration":
466
- case "FunctionExpression":
467
- case "ArrowFunctionExpression":
468
- startCodePath("function");
469
- break;
470
-
471
- case "StaticBlock":
472
- startCodePath("class-static-block");
473
- break;
474
-
475
- case "ChainExpression":
476
- state.pushChainContext();
477
- break;
478
- case "CallExpression":
479
- if (node.optional === true) {
480
- state.makeOptionalNode();
481
- }
482
- break;
483
- case "MemberExpression":
484
- if (node.optional === true) {
485
- state.makeOptionalNode();
486
- }
487
- break;
488
-
489
- case "LogicalExpression":
490
- if (isHandledLogicalOperator(node.operator)) {
491
- state.pushChoiceContext(
492
- node.operator,
493
- isForkingByTrueOrFalse(node)
494
- );
495
- }
496
- break;
497
-
498
- case "AssignmentExpression":
499
- if (isLogicalAssignmentOperator(node.operator)) {
500
- state.pushChoiceContext(
501
- node.operator.slice(0, -1), // removes `=` from the end
502
- isForkingByTrueOrFalse(node)
503
- );
504
- }
505
- break;
506
-
507
- case "ConditionalExpression":
508
- case "IfStatement":
509
- state.pushChoiceContext("test", false);
510
- break;
511
-
512
- case "SwitchStatement":
513
- state.pushSwitchContext(
514
- node.cases.some(isCaseNode),
515
- getLabel(node)
516
- );
517
- break;
518
-
519
- case "TryStatement":
520
- state.pushTryContext(Boolean(node.finalizer));
521
- break;
522
-
523
- case "SwitchCase":
524
-
525
- /*
526
- * Fork if this node is after the 2st node in `cases`.
527
- * It's similar to `else` blocks.
528
- * The next `test` node is processed in this path.
529
- */
530
- if (parent.discriminant !== node && parent.cases[0] !== node) {
531
- state.forkPath();
532
- }
533
- break;
534
-
535
- case "WhileStatement":
536
- case "DoWhileStatement":
537
- case "ForStatement":
538
- case "ForInStatement":
539
- case "ForOfStatement":
540
- state.pushLoopContext(node.type, getLabel(node));
541
- break;
542
-
543
- case "LabeledStatement":
544
- if (!breakableTypePattern.test(node.body.type)) {
545
- state.pushBreakContext(false, node.label.name);
546
- }
547
- break;
548
-
549
- default:
550
- break;
551
- }
552
-
553
- // Emits onCodePathSegmentStart events if updated.
554
- forwardCurrentToHead(analyzer, node);
555
- debug.dumpState(node, state, false);
391
+ let codePath = analyzer.codePath;
392
+ let state = codePath && CodePath.getState(codePath);
393
+ const parent = node.parent;
394
+
395
+ /**
396
+ * Creates a new code path and trigger the onCodePathStart event
397
+ * based on the currently selected node.
398
+ * @param {string} origin The reason the code path was started.
399
+ * @returns {void}
400
+ */
401
+ function startCodePath(origin) {
402
+ if (codePath) {
403
+ // Emits onCodePathSegmentStart events if updated.
404
+ forwardCurrentToHead(analyzer, node);
405
+ debug.dumpState(node, state, false);
406
+ }
407
+
408
+ // Create the code path of this scope.
409
+ codePath = analyzer.codePath = new CodePath({
410
+ id: analyzer.idGenerator.next(),
411
+ origin,
412
+ upper: codePath,
413
+ onLooped: analyzer.onLooped,
414
+ });
415
+ state = CodePath.getState(codePath);
416
+
417
+ // Emits onCodePathStart events.
418
+ debug.dump(`onCodePathStart ${codePath.id}`);
419
+ analyzer.emitter.emit("onCodePathStart", codePath, node);
420
+ }
421
+
422
+ /*
423
+ * Special case: The right side of class field initializer is considered
424
+ * to be its own function, so we need to start a new code path in this
425
+ * case.
426
+ */
427
+ if (isPropertyDefinitionValue(node)) {
428
+ startCodePath("class-field-initializer");
429
+
430
+ /*
431
+ * Intentional fall through because `node` needs to also be
432
+ * processed by the code below. For example, if we have:
433
+ *
434
+ * class Foo {
435
+ * a = () => {}
436
+ * }
437
+ *
438
+ * In this case, we also need start a second code path.
439
+ */
440
+ }
441
+
442
+ switch (node.type) {
443
+ case "Program":
444
+ startCodePath("program");
445
+ break;
446
+
447
+ case "FunctionDeclaration":
448
+ case "FunctionExpression":
449
+ case "ArrowFunctionExpression":
450
+ startCodePath("function");
451
+ break;
452
+
453
+ case "StaticBlock":
454
+ startCodePath("class-static-block");
455
+ break;
456
+
457
+ case "ChainExpression":
458
+ state.pushChainContext();
459
+ break;
460
+ case "CallExpression":
461
+ if (node.optional === true) {
462
+ state.makeOptionalNode();
463
+ }
464
+ break;
465
+ case "MemberExpression":
466
+ if (node.optional === true) {
467
+ state.makeOptionalNode();
468
+ }
469
+ break;
470
+
471
+ case "LogicalExpression":
472
+ if (isHandledLogicalOperator(node.operator)) {
473
+ state.pushChoiceContext(
474
+ node.operator,
475
+ isForkingByTrueOrFalse(node),
476
+ );
477
+ }
478
+ break;
479
+
480
+ case "AssignmentExpression":
481
+ if (isLogicalAssignmentOperator(node.operator)) {
482
+ state.pushChoiceContext(
483
+ node.operator.slice(0, -1), // removes `=` from the end
484
+ isForkingByTrueOrFalse(node),
485
+ );
486
+ }
487
+ break;
488
+
489
+ case "ConditionalExpression":
490
+ case "IfStatement":
491
+ state.pushChoiceContext("test", false);
492
+ break;
493
+
494
+ case "SwitchStatement":
495
+ state.pushSwitchContext(
496
+ node.cases.some(isCaseNode),
497
+ getLabel(node),
498
+ );
499
+ break;
500
+
501
+ case "TryStatement":
502
+ state.pushTryContext(Boolean(node.finalizer));
503
+ break;
504
+
505
+ case "SwitchCase":
506
+ /*
507
+ * Fork if this node is after the 2st node in `cases`.
508
+ * It's similar to `else` blocks.
509
+ * The next `test` node is processed in this path.
510
+ */
511
+ if (parent.discriminant !== node && parent.cases[0] !== node) {
512
+ state.forkPath();
513
+ }
514
+ break;
515
+
516
+ case "WhileStatement":
517
+ case "DoWhileStatement":
518
+ case "ForStatement":
519
+ case "ForInStatement":
520
+ case "ForOfStatement":
521
+ state.pushLoopContext(node.type, getLabel(node));
522
+ break;
523
+
524
+ case "LabeledStatement":
525
+ if (!breakableTypePattern.test(node.body.type)) {
526
+ state.pushBreakContext(false, node.label.name);
527
+ }
528
+ break;
529
+
530
+ default:
531
+ break;
532
+ }
533
+
534
+ // Emits onCodePathSegmentStart events if updated.
535
+ forwardCurrentToHead(analyzer, node);
536
+ debug.dumpState(node, state, false);
556
537
  }
557
538
 
558
539
  /**
@@ -562,122 +543,120 @@ function processCodePathToEnter(analyzer, node) {
562
543
  * @returns {void}
563
544
  */
564
545
  function processCodePathToExit(analyzer, node) {
565
-
566
- const codePath = analyzer.codePath;
567
- const state = CodePath.getState(codePath);
568
- let dontForward = false;
569
-
570
- switch (node.type) {
571
- case "ChainExpression":
572
- state.popChainContext();
573
- break;
574
-
575
- case "IfStatement":
576
- case "ConditionalExpression":
577
- state.popChoiceContext();
578
- break;
579
-
580
- case "LogicalExpression":
581
- if (isHandledLogicalOperator(node.operator)) {
582
- state.popChoiceContext();
583
- }
584
- break;
585
-
586
- case "AssignmentExpression":
587
- if (isLogicalAssignmentOperator(node.operator)) {
588
- state.popChoiceContext();
589
- }
590
- break;
591
-
592
- case "SwitchStatement":
593
- state.popSwitchContext();
594
- break;
595
-
596
- case "SwitchCase":
597
-
598
- /*
599
- * This is the same as the process at the 1st `consequent` node in
600
- * `preprocess` function.
601
- * Must do if this `consequent` is empty.
602
- */
603
- if (node.consequent.length === 0) {
604
- state.makeSwitchCaseBody(true, !node.test);
605
- }
606
- if (state.forkContext.reachable) {
607
- dontForward = true;
608
- }
609
- break;
610
-
611
- case "TryStatement":
612
- state.popTryContext();
613
- break;
614
-
615
- case "BreakStatement":
616
- forwardCurrentToHead(analyzer, node);
617
- state.makeBreak(node.label && node.label.name);
618
- dontForward = true;
619
- break;
620
-
621
- case "ContinueStatement":
622
- forwardCurrentToHead(analyzer, node);
623
- state.makeContinue(node.label && node.label.name);
624
- dontForward = true;
625
- break;
626
-
627
- case "ReturnStatement":
628
- forwardCurrentToHead(analyzer, node);
629
- state.makeReturn();
630
- dontForward = true;
631
- break;
632
-
633
- case "ThrowStatement":
634
- forwardCurrentToHead(analyzer, node);
635
- state.makeThrow();
636
- dontForward = true;
637
- break;
638
-
639
- case "Identifier":
640
- if (isIdentifierReference(node)) {
641
- state.makeFirstThrowablePathInTryBlock();
642
- dontForward = true;
643
- }
644
- break;
645
-
646
- case "CallExpression":
647
- case "ImportExpression":
648
- case "MemberExpression":
649
- case "NewExpression":
650
- case "YieldExpression":
651
- state.makeFirstThrowablePathInTryBlock();
652
- break;
653
-
654
- case "WhileStatement":
655
- case "DoWhileStatement":
656
- case "ForStatement":
657
- case "ForInStatement":
658
- case "ForOfStatement":
659
- state.popLoopContext();
660
- break;
661
-
662
- case "AssignmentPattern":
663
- state.popForkContext();
664
- break;
665
-
666
- case "LabeledStatement":
667
- if (!breakableTypePattern.test(node.body.type)) {
668
- state.popBreakContext();
669
- }
670
- break;
671
-
672
- default:
673
- break;
674
- }
675
-
676
- // Emits onCodePathSegmentStart events if updated.
677
- if (!dontForward) {
678
- forwardCurrentToHead(analyzer, node);
679
- }
680
- debug.dumpState(node, state, true);
546
+ const codePath = analyzer.codePath;
547
+ const state = CodePath.getState(codePath);
548
+ let dontForward = false;
549
+
550
+ switch (node.type) {
551
+ case "ChainExpression":
552
+ state.popChainContext();
553
+ break;
554
+
555
+ case "IfStatement":
556
+ case "ConditionalExpression":
557
+ state.popChoiceContext();
558
+ break;
559
+
560
+ case "LogicalExpression":
561
+ if (isHandledLogicalOperator(node.operator)) {
562
+ state.popChoiceContext();
563
+ }
564
+ break;
565
+
566
+ case "AssignmentExpression":
567
+ if (isLogicalAssignmentOperator(node.operator)) {
568
+ state.popChoiceContext();
569
+ }
570
+ break;
571
+
572
+ case "SwitchStatement":
573
+ state.popSwitchContext();
574
+ break;
575
+
576
+ case "SwitchCase":
577
+ /*
578
+ * This is the same as the process at the 1st `consequent` node in
579
+ * `preprocess` function.
580
+ * Must do if this `consequent` is empty.
581
+ */
582
+ if (node.consequent.length === 0) {
583
+ state.makeSwitchCaseBody(true, !node.test);
584
+ }
585
+ if (state.forkContext.reachable) {
586
+ dontForward = true;
587
+ }
588
+ break;
589
+
590
+ case "TryStatement":
591
+ state.popTryContext();
592
+ break;
593
+
594
+ case "BreakStatement":
595
+ forwardCurrentToHead(analyzer, node);
596
+ state.makeBreak(node.label && node.label.name);
597
+ dontForward = true;
598
+ break;
599
+
600
+ case "ContinueStatement":
601
+ forwardCurrentToHead(analyzer, node);
602
+ state.makeContinue(node.label && node.label.name);
603
+ dontForward = true;
604
+ break;
605
+
606
+ case "ReturnStatement":
607
+ forwardCurrentToHead(analyzer, node);
608
+ state.makeReturn();
609
+ dontForward = true;
610
+ break;
611
+
612
+ case "ThrowStatement":
613
+ forwardCurrentToHead(analyzer, node);
614
+ state.makeThrow();
615
+ dontForward = true;
616
+ break;
617
+
618
+ case "Identifier":
619
+ if (isIdentifierReference(node)) {
620
+ state.makeFirstThrowablePathInTryBlock();
621
+ dontForward = true;
622
+ }
623
+ break;
624
+
625
+ case "CallExpression":
626
+ case "ImportExpression":
627
+ case "MemberExpression":
628
+ case "NewExpression":
629
+ case "YieldExpression":
630
+ state.makeFirstThrowablePathInTryBlock();
631
+ break;
632
+
633
+ case "WhileStatement":
634
+ case "DoWhileStatement":
635
+ case "ForStatement":
636
+ case "ForInStatement":
637
+ case "ForOfStatement":
638
+ state.popLoopContext();
639
+ break;
640
+
641
+ case "AssignmentPattern":
642
+ state.popForkContext();
643
+ break;
644
+
645
+ case "LabeledStatement":
646
+ if (!breakableTypePattern.test(node.body.type)) {
647
+ state.popBreakContext();
648
+ }
649
+ break;
650
+
651
+ default:
652
+ break;
653
+ }
654
+
655
+ // Emits onCodePathSegmentStart events if updated.
656
+ if (!dontForward) {
657
+ forwardCurrentToHead(analyzer, node);
658
+ }
659
+ debug.dumpState(node, state, true);
681
660
  }
682
661
 
683
662
  /**
@@ -687,73 +666,71 @@ function processCodePathToExit(analyzer, node) {
687
666
  * @returns {void}
688
667
  */
689
668
  function postprocess(analyzer, node) {
690
-
691
- /**
692
- * Ends the code path for the current node.
693
- * @returns {void}
694
- */
695
- function endCodePath() {
696
- let codePath = analyzer.codePath;
697
-
698
- // Mark the current path as the final node.
699
- CodePath.getState(codePath).makeFinal();
700
-
701
- // Emits onCodePathSegmentEnd event of the current segments.
702
- leaveFromCurrentSegment(analyzer, node);
703
-
704
- // Emits onCodePathEnd event of this code path.
705
- debug.dump(`onCodePathEnd ${codePath.id}`);
706
- analyzer.emitter.emit("onCodePathEnd", codePath, node);
707
- debug.dumpDot(codePath);
708
-
709
- codePath = analyzer.codePath = analyzer.codePath.upper;
710
- if (codePath) {
711
- debug.dumpState(node, CodePath.getState(codePath), true);
712
- }
713
-
714
- }
715
-
716
- switch (node.type) {
717
- case "Program":
718
- case "FunctionDeclaration":
719
- case "FunctionExpression":
720
- case "ArrowFunctionExpression":
721
- case "StaticBlock": {
722
- endCodePath();
723
- break;
724
- }
725
-
726
- // The `arguments.length >= 1` case is in `preprocess` function.
727
- case "CallExpression":
728
- if (node.optional === true && node.arguments.length === 0) {
729
- CodePath.getState(analyzer.codePath).makeOptionalRight();
730
- }
731
- break;
732
-
733
- default:
734
- break;
735
- }
736
-
737
- /*
738
- * Special case: The right side of class field initializer is considered
739
- * to be its own function, so we need to end a code path in this
740
- * case.
741
- *
742
- * We need to check after the other checks in order to close the
743
- * code paths in the correct order for code like this:
744
- *
745
- *
746
- * class Foo {
747
- * a = () => {}
748
- * }
749
- *
750
- * In this case, The ArrowFunctionExpression code path is closed first
751
- * and then we need to close the code path for the PropertyDefinition
752
- * value.
753
- */
754
- if (isPropertyDefinitionValue(node)) {
755
- endCodePath();
756
- }
669
+ /**
670
+ * Ends the code path for the current node.
671
+ * @returns {void}
672
+ */
673
+ function endCodePath() {
674
+ let codePath = analyzer.codePath;
675
+
676
+ // Mark the current path as the final node.
677
+ CodePath.getState(codePath).makeFinal();
678
+
679
+ // Emits onCodePathSegmentEnd event of the current segments.
680
+ leaveFromCurrentSegment(analyzer, node);
681
+
682
+ // Emits onCodePathEnd event of this code path.
683
+ debug.dump(`onCodePathEnd ${codePath.id}`);
684
+ analyzer.emitter.emit("onCodePathEnd", codePath, node);
685
+ debug.dumpDot(codePath);
686
+
687
+ codePath = analyzer.codePath = analyzer.codePath.upper;
688
+ if (codePath) {
689
+ debug.dumpState(node, CodePath.getState(codePath), true);
690
+ }
691
+ }
692
+
693
+ switch (node.type) {
694
+ case "Program":
695
+ case "FunctionDeclaration":
696
+ case "FunctionExpression":
697
+ case "ArrowFunctionExpression":
698
+ case "StaticBlock": {
699
+ endCodePath();
700
+ break;
701
+ }
702
+
703
+ // The `arguments.length >= 1` case is in `preprocess` function.
704
+ case "CallExpression":
705
+ if (node.optional === true && node.arguments.length === 0) {
706
+ CodePath.getState(analyzer.codePath).makeOptionalRight();
707
+ }
708
+ break;
709
+
710
+ default:
711
+ break;
712
+ }
713
+
714
+ /*
715
+ * Special case: The right side of class field initializer is considered
716
+ * to be its own function, so we need to end a code path in this
717
+ * case.
718
+ *
719
+ * We need to check after the other checks in order to close the
720
+ * code paths in the correct order for code like this:
721
+ *
722
+ *
723
+ * class Foo {
724
+ * a = () => {}
725
+ * }
726
+ *
727
+ * In this case, The ArrowFunctionExpression code path is closed first
728
+ * and then we need to close the code path for the PropertyDefinition
729
+ * value.
730
+ */
731
+ if (isPropertyDefinitionValue(node)) {
732
+ endCodePath();
733
+ }
757
734
  }
758
735
 
759
736
  //------------------------------------------------------------------------------
@@ -765,87 +742,88 @@ function postprocess(analyzer, node) {
765
742
  * This class implements the EventGenerator interface.
766
743
  */
767
744
  class CodePathAnalyzer {
768
-
769
- /**
770
- * @param {EventGenerator} eventGenerator An event generator to wrap.
771
- */
772
- constructor(eventGenerator) {
773
- this.original = eventGenerator;
774
- this.emitter = eventGenerator.emitter;
775
- this.codePath = null;
776
- this.idGenerator = new IdGenerator("s");
777
- this.currentNode = null;
778
- this.onLooped = this.onLooped.bind(this);
779
- }
780
-
781
- /**
782
- * Does the process to enter a given AST node.
783
- * This updates state of analysis and calls `enterNode` of the wrapped.
784
- * @param {ASTNode} node A node which is entering.
785
- * @returns {void}
786
- */
787
- enterNode(node) {
788
- this.currentNode = node;
789
-
790
- // Updates the code path due to node's position in its parent node.
791
- if (node.parent) {
792
- preprocess(this, node);
793
- }
794
-
795
- /*
796
- * Updates the code path.
797
- * And emits onCodePathStart/onCodePathSegmentStart events.
798
- */
799
- processCodePathToEnter(this, node);
800
-
801
- // Emits node events.
802
- this.original.enterNode(node);
803
-
804
- this.currentNode = null;
805
- }
806
-
807
- /**
808
- * Does the process to leave a given AST node.
809
- * This updates state of analysis and calls `leaveNode` of the wrapped.
810
- * @param {ASTNode} node A node which is leaving.
811
- * @returns {void}
812
- */
813
- leaveNode(node) {
814
- this.currentNode = node;
815
-
816
- /*
817
- * Updates the code path.
818
- * And emits onCodePathStart/onCodePathSegmentStart events.
819
- */
820
- processCodePathToExit(this, node);
821
-
822
- // Emits node events.
823
- this.original.leaveNode(node);
824
-
825
- // Emits the last onCodePathStart/onCodePathSegmentStart events.
826
- postprocess(this, node);
827
-
828
- this.currentNode = null;
829
- }
830
-
831
- /**
832
- * This is called on a code path looped.
833
- * Then this raises a looped event.
834
- * @param {CodePathSegment} fromSegment A segment of prev.
835
- * @param {CodePathSegment} toSegment A segment of next.
836
- * @returns {void}
837
- */
838
- onLooped(fromSegment, toSegment) {
839
- if (fromSegment.reachable && toSegment.reachable) {
840
- debug.dump(`onCodePathSegmentLoop ${fromSegment.id} -> ${toSegment.id}`);
841
- this.emitter.emit(
842
- "onCodePathSegmentLoop",
843
- fromSegment,
844
- toSegment,
845
- this.currentNode
846
- );
847
- }
848
- }
745
+ /**
746
+ * @param {EventGenerator} eventGenerator An event generator to wrap.
747
+ */
748
+ constructor(eventGenerator) {
749
+ this.original = eventGenerator;
750
+ this.emitter = eventGenerator.emitter;
751
+ this.codePath = null;
752
+ this.idGenerator = new IdGenerator("s");
753
+ this.currentNode = null;
754
+ this.onLooped = this.onLooped.bind(this);
755
+ }
756
+
757
+ /**
758
+ * Does the process to enter a given AST node.
759
+ * This updates state of analysis and calls `enterNode` of the wrapped.
760
+ * @param {ASTNode} node A node which is entering.
761
+ * @returns {void}
762
+ */
763
+ enterNode(node) {
764
+ this.currentNode = node;
765
+
766
+ // Updates the code path due to node's position in its parent node.
767
+ if (node.parent) {
768
+ preprocess(this, node);
769
+ }
770
+
771
+ /*
772
+ * Updates the code path.
773
+ * And emits onCodePathStart/onCodePathSegmentStart events.
774
+ */
775
+ processCodePathToEnter(this, node);
776
+
777
+ // Emits node events.
778
+ this.original.enterNode(node);
779
+
780
+ this.currentNode = null;
781
+ }
782
+
783
+ /**
784
+ * Does the process to leave a given AST node.
785
+ * This updates state of analysis and calls `leaveNode` of the wrapped.
786
+ * @param {ASTNode} node A node which is leaving.
787
+ * @returns {void}
788
+ */
789
+ leaveNode(node) {
790
+ this.currentNode = node;
791
+
792
+ /*
793
+ * Updates the code path.
794
+ * And emits onCodePathStart/onCodePathSegmentStart events.
795
+ */
796
+ processCodePathToExit(this, node);
797
+
798
+ // Emits node events.
799
+ this.original.leaveNode(node);
800
+
801
+ // Emits the last onCodePathStart/onCodePathSegmentStart events.
802
+ postprocess(this, node);
803
+
804
+ this.currentNode = null;
805
+ }
806
+
807
+ /**
808
+ * This is called on a code path looped.
809
+ * Then this raises a looped event.
810
+ * @param {CodePathSegment} fromSegment A segment of prev.
811
+ * @param {CodePathSegment} toSegment A segment of next.
812
+ * @returns {void}
813
+ */
814
+ onLooped(fromSegment, toSegment) {
815
+ if (fromSegment.reachable && toSegment.reachable) {
816
+ debug.dump(
817
+ `onCodePathSegmentLoop ${fromSegment.id} -> ${toSegment.id}`,
818
+ );
819
+ this.emitter.emit(
820
+ "onCodePathSegmentLoop",
821
+ fromSegment,
822
+ toSegment,
823
+ this.currentNode,
824
+ );
825
+ }
826
+ }
849
827
  }
850
828
 
851
829
  module.exports = CodePathAnalyzer;