oxlint-疑問集.md

eslint から oxlint に乗り換えようとして、疑問に思ったことをまとめておく。どれもドキュメントを読んでもよく分からなかった。oxlint のソースコードを読んだり、挙動を観察する必要がありそう。あとで調べる。

• デフォルトでは JavaScript ファイルはどの ECMA Script バージョンのファイルとしてパースされる? ESLint では languageOptions.ecmaVersion で指定できて、そのデフォルト値は "latest" だが、oxlint ではどうか?
  • A. おそらく 最新の ECMA Script バージョンとしてパースされる。
  • 少なくとも js-plugin に渡す Context#languageOptions.ecmaVersion は "2026" に固定されている。
    • https://github.com/oxc-project/oxc/blob/04a28710332a39d4b70e12ae3ba16bfd44e3307d/apps/oxlint/src-js/plugins/context.ts#L258-L274
    • https://github.com/oxc-project/oxc/blob/04a28710332a39d4b70e12ae3ba16bfd44e3307d/apps/oxlint/src-js/plugins/context.ts#L71
• globals['es-latest'] 的なものはある?
  • A. globals.builtin
    • sindresorhus/globals#140 (comment)
• デフォルトでは JavaScript ファイルはどのモードでパースされる? ESLint では languageOptions.sourceType でモードを指定できて、そのデフォルト値は "module" だが、oxlint ではどうか?
  • A. ファイルの拡張子からモードが判別できればそのモードでパースし、無ければパースしてみてソーステキストの内容を元に最終的なモードを判定する。
    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_linter/src/service/runtime.rs#L317
    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_linter/src/service/runtime.rs#L1018
    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_parser/src/lib.rs#L487-L496
  • 厳密には拡張子から判定不能なファイルについては package.json の type field を考慮してモードを判定すべきな気がするが、oxlint はそうなってない模様。oxlint のバグとして報告すべき?
• デフォルトではどの拡張子のファイルが lint 対象になる?
  • A. js, mjs, cjs, jsx, ts, mts, cts, tsx, vue, astro, svelte が lint 対象になる。
    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_linter/src/loader/partial_loader/mod.rs#L24-L25
• typescript plugin の rule を有効にする時、files で .ts のみに適用範囲を絞るべき? 絞らなかった場合どうなる?
  • A. わからない...
  • "files": ["*.ts"] にすると、その rule　は .vue の中にある TypeScript コードに適用されなくなってしまう。
    • .vue にも適用したいなら、"files": ["*.ts", "*.vue"] にするか、"overrides" を使わずに rule を有効にするべき
  • typescript plugin の rule は "overrides" を使わずに有効にするか、"files": ["*.ts", "*.mts", "*.cts", "*.tsx", "*.vue", "*.astro", "*.svelte"] を使って有効化するのが良いのでは
    • 前者のほうがシンプルだが、後者のほうが rule が適用されるファイルが減る分、lint 実行時間が減ると思う。
    • まあ削減される時間大したことないと思うから、前者で良いのでは。
  • ところで前者を採用すると .ts 向けの rule を .js でも有効にすることになる
    • .js に対して require-await と typescript/require-await の両方が有効になる訳だけど、それっておかしなことになったりしないか...?
    • .js に対して typescript/require-await が報告されて変な感じはするが、まあそれくらいだなー
    • 
  • typescript plugin の rule は files で絞らずに有効化する、で良いのでは。
• 以下のような config がある時、arrow-body-style は .vue ファイル中の JavaScript コードに対して有効になる?

  • {
      "$schema": "./node_modules/oxlint/configuration_schema.json",
      "overrides": [
        {
          "files": ["*.js"],
          "rules": {
            "arrow-body-style": "error"
          }
        }
      ]
    }

  • A. いいえ。
  • .js に対してのみ、arrow-body-style が有効になる模様。
• デフォルトで有効化される rule があるらしいが、その severity は何になる?
  • A. warning になる。
  • ちなみにデフォルトで有効化される rule の定義は「デフォルトで有効化される plugin のうち、correctness category の rule 全て」
    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_linter/src/config/config_builder.rs#L49
  • さらに踏み込むと、追加で読み込まれた plugin の correctness category の rule もデフォルトで有効化される
    • https://oxc.rs/docs/guide/usage/linter/plugins.html#enable-with-the-cli

      • Correctness rules are enabled by default.

    • https://github.com/oxc-project/oxc/blob/e51857f0030df88b105f3b4636c7ff2a67b1142c/crates/oxc_linter/src/config/config_builder.rs#L196-L199
• --disable-unicorn-plugin を渡すと、no-new-array (unicorn plugin のデフォルト有効の rule) は無効化される?
  • A. 無効化されない。
  • 多分 oxlint のバグ?
• 以下のような config がある時、*.js に対して no-new-array (unicorn plugin のデフォルト有効の rule) は有効になる?

  • {
      "$schema": "./node_modules/oxlint/configuration_schema.json",
      "plugins": [],
      "overrides": [
        {
          "files": ["*.cjs"],
          "plugins": ["unicorn"]
        }
      ]
    }

  • A. いいえ。
  • ちなみに *.cjs に対しても有効にならない。多分 oxlint のバグ?
• oxfmt と競合する組み込みの rule は存在するか? 存在する場合、どのような rule がそれに該当するのか?
  • A. わからない...
  • 実際に oxfmt 使って確認してみる。