eslint 9.22.0 → 9.24.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 (417) hide show
  1. package/README.md +48 -46
  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 +830 -810
  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 +638 -457
  21. package/lib/config/config-loader.js +726 -622
  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 +72 -72
  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 +2 -2
  29. package/lib/eslint/eslint-helpers.js +756 -681
  30. package/lib/eslint/eslint.js +934 -912
  31. package/lib/eslint/index.js +2 -2
  32. package/lib/eslint/legacy-eslint.js +577 -533
  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 +1128 -1057
  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 +2403 -2045
  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 +36 -36
  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 +404 -361
  71. package/lib/rule-tester/index.js +1 -1
  72. package/lib/rule-tester/rule-tester.js +1308 -1046
  73. package/lib/rules/accessor-pairs.js +298 -263
  74. package/lib/rules/array-bracket-newline.js +250 -238
  75. package/lib/rules/array-bracket-spacing.js +263 -224
  76. package/lib/rules/array-callback-return.js +402 -356
  77. package/lib/rules/array-element-newline.js +358 -313
  78. package/lib/rules/arrow-body-style.js +400 -281
  79. package/lib/rules/arrow-parens.js +206 -173
  80. package/lib/rules/arrow-spacing.js +169 -163
  81. package/lib/rules/block-scoped-var.js +125 -123
  82. package/lib/rules/block-spacing.js +186 -176
  83. package/lib/rules/brace-style.js +262 -199
  84. package/lib/rules/callback-return.js +203 -190
  85. package/lib/rules/camelcase.js +403 -392
  86. package/lib/rules/capitalized-comments.js +253 -232
  87. package/lib/rules/class-methods-use-this.js +224 -172
  88. package/lib/rules/comma-dangle.js +379 -346
  89. package/lib/rules/comma-spacing.js +193 -195
  90. package/lib/rules/comma-style.js +375 -316
  91. package/lib/rules/complexity.js +173 -169
  92. package/lib/rules/computed-property-spacing.js +236 -211
  93. package/lib/rules/consistent-return.js +181 -170
  94. package/lib/rules/consistent-this.js +167 -147
  95. package/lib/rules/constructor-super.js +412 -404
  96. package/lib/rules/curly.js +407 -332
  97. package/lib/rules/default-case-last.js +38 -31
  98. package/lib/rules/default-case.js +89 -85
  99. package/lib/rules/default-param-last.js +69 -54
  100. package/lib/rules/dot-location.js +122 -110
  101. package/lib/rules/dot-notation.js +192 -156
  102. package/lib/rules/eol-last.js +122 -120
  103. package/lib/rules/eqeqeq.js +168 -155
  104. package/lib/rules/for-direction.js +146 -121
  105. package/lib/rules/func-call-spacing.js +261 -231
  106. package/lib/rules/func-name-matching.js +293 -209
  107. package/lib/rules/func-names.js +165 -164
  108. package/lib/rules/func-style.js +159 -127
  109. package/lib/rules/function-call-argument-newline.js +152 -129
  110. package/lib/rules/function-paren-newline.js +349 -291
  111. package/lib/rules/generator-star-spacing.js +229 -210
  112. package/lib/rules/getter-return.js +208 -172
  113. package/lib/rules/global-require.js +85 -74
  114. package/lib/rules/grouped-accessor-pairs.js +170 -150
  115. package/lib/rules/guard-for-in.js +72 -63
  116. package/lib/rules/handle-callback-err.js +108 -103
  117. package/lib/rules/id-blacklist.js +182 -199
  118. package/lib/rules/id-denylist.js +168 -187
  119. package/lib/rules/id-length.js +197 -171
  120. package/lib/rules/id-match.js +344 -289
  121. package/lib/rules/implicit-arrow-linebreak.js +102 -79
  122. package/lib/rules/indent-legacy.js +1344 -1118
  123. package/lib/rules/indent.js +2272 -1759
  124. package/lib/rules/index.js +317 -292
  125. package/lib/rules/init-declarations.js +137 -107
  126. package/lib/rules/jsx-quotes.js +94 -82
  127. package/lib/rules/key-spacing.js +750 -633
  128. package/lib/rules/keyword-spacing.js +648 -605
  129. package/lib/rules/line-comment-position.js +142 -128
  130. package/lib/rules/linebreak-style.js +107 -106
  131. package/lib/rules/lines-around-comment.js +540 -448
  132. package/lib/rules/lines-around-directive.js +233 -203
  133. package/lib/rules/lines-between-class-members.js +305 -234
  134. package/lib/rules/logical-assignment-operators.js +582 -399
  135. package/lib/rules/max-classes-per-file.js +69 -68
  136. package/lib/rules/max-depth.js +146 -143
  137. package/lib/rules/max-len.js +473 -434
  138. package/lib/rules/max-lines-per-function.js +201 -176
  139. package/lib/rules/max-lines.js +158 -162
  140. package/lib/rules/max-nested-callbacks.js +102 -104
  141. package/lib/rules/max-params.js +78 -76
  142. package/lib/rules/max-statements-per-line.js +205 -198
  143. package/lib/rules/max-statements.js +168 -164
  144. package/lib/rules/multiline-comment-style.js +637 -479
  145. package/lib/rules/multiline-ternary.js +241 -176
  146. package/lib/rules/new-cap.js +233 -213
  147. package/lib/rules/new-parens.js +88 -79
  148. package/lib/rules/newline-after-var.js +287 -250
  149. package/lib/rules/newline-before-return.js +229 -222
  150. package/lib/rules/newline-per-chained-call.js +142 -127
  151. package/lib/rules/no-alert.js +90 -79
  152. package/lib/rules/no-array-constructor.js +125 -113
  153. package/lib/rules/no-async-promise-executor.js +30 -24
  154. package/lib/rules/no-await-in-loop.js +69 -71
  155. package/lib/rules/no-bitwise.js +124 -100
  156. package/lib/rules/no-buffer-constructor.js +55 -47
  157. package/lib/rules/no-caller.js +39 -33
  158. package/lib/rules/no-case-declarations.js +61 -57
  159. package/lib/rules/no-catch-shadow.js +76 -73
  160. package/lib/rules/no-class-assign.js +51 -48
  161. package/lib/rules/no-compare-neg-zero.js +62 -48
  162. package/lib/rules/no-cond-assign.js +148 -132
  163. package/lib/rules/no-confusing-arrow.js +98 -81
  164. package/lib/rules/no-console.js +202 -199
  165. package/lib/rules/no-const-assign.js +47 -41
  166. package/lib/rules/no-constant-binary-expression.js +500 -405
  167. package/lib/rules/no-constant-condition.js +158 -143
  168. package/lib/rules/no-constructor-return.js +49 -49
  169. package/lib/rules/no-continue.js +25 -27
  170. package/lib/rules/no-control-regex.js +125 -121
  171. package/lib/rules/no-debugger.js +28 -30
  172. package/lib/rules/no-delete-var.js +29 -29
  173. package/lib/rules/no-div-regex.js +47 -41
  174. package/lib/rules/no-dupe-args.js +68 -69
  175. package/lib/rules/no-dupe-class-members.js +102 -89
  176. package/lib/rules/no-dupe-else-if.js +100 -77
  177. package/lib/rules/no-dupe-keys.js +133 -110
  178. package/lib/rules/no-duplicate-case.js +50 -43
  179. package/lib/rules/no-duplicate-imports.js +179 -176
  180. package/lib/rules/no-else-return.js +430 -385
  181. package/lib/rules/no-empty-character-class.js +57 -50
  182. package/lib/rules/no-empty-function.js +127 -128
  183. package/lib/rules/no-empty-pattern.js +63 -58
  184. package/lib/rules/no-empty-static-block.js +37 -35
  185. package/lib/rules/no-empty.js +98 -86
  186. package/lib/rules/no-eq-null.js +37 -32
  187. package/lib/rules/no-eval.js +256 -250
  188. package/lib/rules/no-ex-assign.js +42 -39
  189. package/lib/rules/no-extend-native.js +161 -159
  190. package/lib/rules/no-extra-bind.js +201 -190
  191. package/lib/rules/no-extra-boolean-cast.js +398 -348
  192. package/lib/rules/no-extra-label.js +150 -131
  193. package/lib/rules/no-extra-parens.js +1654 -1325
  194. package/lib/rules/no-extra-semi.js +146 -144
  195. package/lib/rules/no-fallthrough.js +199 -157
  196. package/lib/rules/no-floating-decimal.js +74 -66
  197. package/lib/rules/no-func-assign.js +54 -55
  198. package/lib/rules/no-global-assign.js +78 -73
  199. package/lib/rules/no-implicit-coercion.js +349 -293
  200. package/lib/rules/no-implicit-globals.js +158 -135
  201. package/lib/rules/no-implied-eval.js +140 -112
  202. package/lib/rules/no-import-assign.js +145 -159
  203. package/lib/rules/no-inline-comments.js +101 -95
  204. package/lib/rules/no-inner-declarations.js +115 -101
  205. package/lib/rules/no-invalid-regexp.js +222 -190
  206. package/lib/rules/no-invalid-this.js +123 -117
  207. package/lib/rules/no-irregular-whitespace.js +266 -252
  208. package/lib/rules/no-iterator.js +29 -33
  209. package/lib/rules/no-label-var.js +59 -62
  210. package/lib/rules/no-labels.js +138 -133
  211. package/lib/rules/no-lone-blocks.js +127 -123
  212. package/lib/rules/no-lonely-if.js +108 -77
  213. package/lib/rules/no-loop-func.js +238 -213
  214. package/lib/rules/no-loss-of-precision.js +218 -201
  215. package/lib/rules/no-magic-numbers.js +246 -218
  216. package/lib/rules/no-misleading-character-class.js +499 -446
  217. package/lib/rules/no-mixed-operators.js +188 -182
  218. package/lib/rules/no-mixed-requires.js +253 -240
  219. package/lib/rules/no-mixed-spaces-and-tabs.js +134 -121
  220. package/lib/rules/no-multi-assign.js +46 -44
  221. package/lib/rules/no-multi-spaces.js +163 -143
  222. package/lib/rules/no-multi-str.js +42 -41
  223. package/lib/rules/no-multiple-empty-lines.js +196 -158
  224. package/lib/rules/no-native-reassign.js +90 -85
  225. package/lib/rules/no-negated-condition.js +79 -75
  226. package/lib/rules/no-negated-in-lhs.js +45 -43
  227. package/lib/rules/no-nested-ternary.js +33 -32
  228. package/lib/rules/no-new-func.js +71 -62
  229. package/lib/rules/no-new-native-nonconstructor.js +43 -39
  230. package/lib/rules/no-new-object.js +48 -48
  231. package/lib/rules/no-new-require.js +48 -47
  232. package/lib/rules/no-new-symbol.js +52 -50
  233. package/lib/rules/no-new-wrappers.js +43 -41
  234. package/lib/rules/no-new.js +28 -29
  235. package/lib/rules/no-nonoctal-decimal-escape.js +141 -121
  236. package/lib/rules/no-obj-calls.js +66 -53
  237. package/lib/rules/no-object-constructor.js +104 -97
  238. package/lib/rules/no-octal-escape.js +40 -43
  239. package/lib/rules/no-octal.js +32 -32
  240. package/lib/rules/no-param-reassign.js +235 -217
  241. package/lib/rules/no-path-concat.js +66 -67
  242. package/lib/rules/no-plusplus.js +60 -61
  243. package/lib/rules/no-process-env.js +49 -48
  244. package/lib/rules/no-process-exit.js +54 -50
  245. package/lib/rules/no-promise-executor-return.js +214 -182
  246. package/lib/rules/no-proto.js +26 -29
  247. package/lib/rules/no-prototype-builtins.js +146 -124
  248. package/lib/rules/no-redeclare.js +154 -152
  249. package/lib/rules/no-regex-spaces.js +183 -161
  250. package/lib/rules/no-restricted-exports.js +208 -185
  251. package/lib/rules/no-restricted-globals.js +111 -112
  252. package/lib/rules/no-restricted-imports.js +657 -537
  253. package/lib/rules/no-restricted-modules.js +222 -202
  254. package/lib/rules/no-restricted-properties.js +181 -153
  255. package/lib/rules/no-restricted-syntax.js +56 -52
  256. package/lib/rules/no-return-assign.js +55 -50
  257. package/lib/rules/no-return-await.js +148 -124
  258. package/lib/rules/no-script-url.js +52 -45
  259. package/lib/rules/no-self-assign.js +148 -146
  260. package/lib/rules/no-self-compare.js +63 -46
  261. package/lib/rules/no-sequences.js +135 -116
  262. package/lib/rules/no-setter-return.js +185 -152
  263. package/lib/rules/no-shadow-restricted-names.js +61 -46
  264. package/lib/rules/no-shadow.js +342 -316
  265. package/lib/rules/no-spaced-func.js +82 -77
  266. package/lib/rules/no-sparse-arrays.js +54 -59
  267. package/lib/rules/no-sync.js +61 -60
  268. package/lib/rules/no-tabs.js +83 -72
  269. package/lib/rules/no-template-curly-in-string.js +33 -32
  270. package/lib/rules/no-ternary.js +25 -29
  271. package/lib/rules/no-this-before-super.js +321 -319
  272. package/lib/rules/no-throw-literal.js +31 -36
  273. package/lib/rules/no-trailing-spaces.js +199 -191
  274. package/lib/rules/no-undef-init.js +76 -61
  275. package/lib/rules/no-undef.js +51 -48
  276. package/lib/rules/no-undefined.js +73 -75
  277. package/lib/rules/no-underscore-dangle.js +370 -327
  278. package/lib/rules/no-unexpected-multiline.js +112 -102
  279. package/lib/rules/no-unmodified-loop-condition.js +254 -254
  280. package/lib/rules/no-unneeded-ternary.js +212 -147
  281. package/lib/rules/no-unreachable-loop.js +145 -142
  282. package/lib/rules/no-unreachable.js +255 -248
  283. package/lib/rules/no-unsafe-finally.js +93 -85
  284. package/lib/rules/no-unsafe-negation.js +105 -83
  285. package/lib/rules/no-unsafe-optional-chaining.js +192 -178
  286. package/lib/rules/no-unused-expressions.js +178 -162
  287. package/lib/rules/no-unused-labels.js +139 -124
  288. package/lib/rules/no-unused-private-class-members.js +206 -182
  289. package/lib/rules/no-unused-vars.js +1669 -1449
  290. package/lib/rules/no-use-before-define.js +229 -231
  291. package/lib/rules/no-useless-assignment.js +590 -511
  292. package/lib/rules/no-useless-backreference.js +212 -193
  293. package/lib/rules/no-useless-call.js +58 -53
  294. package/lib/rules/no-useless-catch.js +40 -40
  295. package/lib/rules/no-useless-computed-key.js +144 -115
  296. package/lib/rules/no-useless-concat.js +65 -60
  297. package/lib/rules/no-useless-constructor.js +158 -111
  298. package/lib/rules/no-useless-escape.js +342 -291
  299. package/lib/rules/no-useless-rename.js +183 -156
  300. package/lib/rules/no-useless-return.js +344 -312
  301. package/lib/rules/no-var.js +233 -212
  302. package/lib/rules/no-void.js +50 -48
  303. package/lib/rules/no-warning-comments.js +191 -186
  304. package/lib/rules/no-whitespace-before-property.js +131 -115
  305. package/lib/rules/no-with.js +24 -26
  306. package/lib/rules/nonblock-statement-body-position.js +149 -130
  307. package/lib/rules/object-curly-newline.js +306 -265
  308. package/lib/rules/object-curly-spacing.js +360 -314
  309. package/lib/rules/object-property-newline.js +137 -106
  310. package/lib/rules/object-shorthand.js +607 -502
  311. package/lib/rules/one-var-declaration-per-line.js +104 -100
  312. package/lib/rules/one-var.js +653 -537
  313. package/lib/rules/operator-assignment.js +219 -161
  314. package/lib/rules/operator-linebreak.js +295 -251
  315. package/lib/rules/padded-blocks.js +346 -308
  316. package/lib/rules/padding-line-between-statements.js +443 -439
  317. package/lib/rules/prefer-arrow-callback.js +362 -313
  318. package/lib/rules/prefer-const.js +418 -377
  319. package/lib/rules/prefer-destructuring.js +301 -279
  320. package/lib/rules/prefer-exponentiation-operator.js +176 -133
  321. package/lib/rules/prefer-named-capture-group.js +153 -140
  322. package/lib/rules/prefer-numeric-literals.js +121 -113
  323. package/lib/rules/prefer-object-has-own.js +116 -82
  324. package/lib/rules/prefer-object-spread.js +213 -193
  325. package/lib/rules/prefer-promise-reject-errors.js +140 -122
  326. package/lib/rules/prefer-reflect.js +127 -107
  327. package/lib/rules/prefer-regex-literals.js +578 -466
  328. package/lib/rules/prefer-rest-params.js +79 -80
  329. package/lib/rules/prefer-spread.js +47 -44
  330. package/lib/rules/prefer-template.js +266 -195
  331. package/lib/rules/quote-props.js +373 -307
  332. package/lib/rules/quotes.js +374 -326
  333. package/lib/rules/radix.js +152 -136
  334. package/lib/rules/require-atomic-updates.js +316 -285
  335. package/lib/rules/require-await.js +144 -116
  336. package/lib/rules/require-unicode-regexp.js +282 -177
  337. package/lib/rules/require-yield.js +53 -54
  338. package/lib/rules/rest-spread-spacing.js +128 -116
  339. package/lib/rules/semi-spacing.js +281 -250
  340. package/lib/rules/semi-style.js +176 -134
  341. package/lib/rules/semi.js +456 -436
  342. package/lib/rules/sort-imports.js +306 -233
  343. package/lib/rules/sort-keys.js +219 -188
  344. package/lib/rules/sort-vars.js +127 -93
  345. package/lib/rules/space-before-blocks.js +199 -189
  346. package/lib/rules/space-before-function-paren.js +186 -166
  347. package/lib/rules/space-in-parens.js +359 -288
  348. package/lib/rules/space-infix-ops.js +237 -201
  349. package/lib/rules/space-unary-ops.js +356 -298
  350. package/lib/rules/spaced-comment.js +363 -319
  351. package/lib/rules/strict.js +265 -230
  352. package/lib/rules/switch-colon-spacing.js +130 -122
  353. package/lib/rules/symbol-description.js +45 -48
  354. package/lib/rules/template-curly-spacing.js +148 -142
  355. package/lib/rules/template-tag-spacing.js +98 -88
  356. package/lib/rules/unicode-bom.js +54 -56
  357. package/lib/rules/use-isnan.js +237 -206
  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 +153 -111
  370. package/lib/rules/vars-on-top.js +152 -145
  371. package/lib/rules/wrap-iife.js +204 -191
  372. package/lib/rules/wrap-regex.js +70 -58
  373. package/lib/rules/yield-star-spacing.js +145 -134
  374. package/lib/rules/yoda.js +283 -272
  375. package/lib/services/parser-service.js +35 -35
  376. package/lib/services/processor-service.js +66 -73
  377. package/lib/services/suppressions-service.js +289 -0
  378. package/lib/shared/ajv.js +14 -14
  379. package/lib/shared/assert.js +3 -4
  380. package/lib/shared/ast-utils.js +7 -6
  381. package/lib/shared/deep-merge-arrays.js +24 -22
  382. package/lib/shared/directives.js +3 -2
  383. package/lib/shared/flags.js +50 -17
  384. package/lib/shared/logging.js +24 -25
  385. package/lib/shared/option-utils.js +43 -36
  386. package/lib/shared/runtime-info.js +136 -127
  387. package/lib/shared/serialization.js +27 -27
  388. package/lib/shared/severity.js +22 -22
  389. package/lib/shared/stats.js +5 -5
  390. package/lib/shared/string-utils.js +16 -16
  391. package/lib/shared/text-table.js +28 -27
  392. package/lib/shared/traverser.js +153 -146
  393. package/lib/shared/types.js +4 -27
  394. package/lib/types/index.d.ts +2010 -1559
  395. package/lib/types/rules.d.ts +5253 -5140
  396. package/lib/types/use-at-your-own-risk.d.ts +32 -30
  397. package/lib/unsupported-api.js +5 -5
  398. package/messages/all-files-ignored.js +3 -3
  399. package/messages/all-matched-files-ignored.js +3 -3
  400. package/messages/config-file-missing.js +2 -2
  401. package/messages/config-plugin-missing.js +3 -3
  402. package/messages/config-serialize-function.js +9 -7
  403. package/messages/eslintrc-incompat.js +13 -15
  404. package/messages/eslintrc-plugins.js +3 -4
  405. package/messages/extend-config-missing.js +3 -3
  406. package/messages/failed-to-read-json.js +3 -3
  407. package/messages/file-not-found.js +3 -3
  408. package/messages/invalid-rule-options.js +2 -2
  409. package/messages/invalid-rule-severity.js +2 -2
  410. package/messages/no-config-found.js +3 -3
  411. package/messages/plugin-conflict.js +8 -8
  412. package/messages/plugin-invalid.js +3 -3
  413. package/messages/plugin-missing.js +3 -3
  414. package/messages/print-config-with-directory-path.js +2 -2
  415. package/messages/shared.js +6 -1
  416. package/messages/whitespace-found.js +3 -3
  417. package/package.json +14 -20
@@ -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;