chore: convert CLI run command to ESM

Refs #5967.

Author: macayu17

.github/workflows/mocha.yml

@@ -76,7 +76,7 @@ jobs:
       os: "ubuntu-latest,windows-latest"
       # We pin exact versions here per https://github.com/mochajs/mocha/issues/5052
       # Ref https://nodejs.org/en/about/previous-releases
-      node-versions: "20.19.4,22.18.0,24.6.0"
+      node-versions: "20.19.4,22.22.3,24.6.0"
       npm-script: test-node:${{ matrix.test-part }}
       coverage: ${{ matrix.coverage }}
 

lib/cli/commands.mjs

@@ -5,6 +5,9 @@
  * @module
  */
 
+import { createRequire } from "node:module";
+
 export * as init from "./init.mjs";
 // default command
-export { default as run } from "./run.js";
+/* istanbul ignore next */
+export const run = createRequire(import.meta.url)("./run.mjs");

lib/cli/run.js lib/cli/run.mjslib/cli/run.js renamed to lib/cli/run.mjs

@@ -1,31 +1,28 @@
-"use strict";
-
 /**
  * Definition for Mocha's default ("run tests") command
  *
  * @module
  * @private
  */
 
-const pc = require("picocolors");
-const Mocha = require("../mocha");
-const {
+import pc from "picocolors";
+import Mocha from "../mocha.js";
+import {
   createUnsupportedError,
   createInvalidArgumentValueError,
   createMissingArgumentError,
-} = require("../errors.mjs");
+} from "../errors.mjs";
+
+import runHelpers from "./run-helpers.js";
+import { ONE_AND_DONES, ONE_AND_DONE_ARGS } from "./one-and-dones.mjs";
+import debugModule from "debug";
+import defaults from "../mocharc.json" with { type: "json" };
+import { types, aliases } from "./run-option-metadata.mjs";
+import utils from "../utils.js";
 
-const {
-  list,
-  handleRequires,
-  validateLegacyPlugin,
-  runMocha,
-} = require("./run-helpers");
-const { ONE_AND_DONES, ONE_AND_DONE_ARGS } = require("./one-and-dones.mjs");
-const debug = require("debug")("mocha:cli:run");
-const defaults = require("../mocharc.json");
-const { types, aliases } = require("./run-option-metadata.mjs");
-const { isCI, logSymbols } = require("../utils");
+const { list, handleRequires, validateLegacyPlugin, runMocha } = runHelpers;
+const { isCI, logSymbols } = utils;
+const debug = debugModule("mocha:cli:run");
 
 /**
  * Logical option groups
@@ -40,11 +37,11 @@ const GROUPS = {
   CONFIG: "Configuration",
 };
 
-exports.command = ["$0 [spec..]", "inspect"];
+export const command = ["$0 [spec..]", "inspect"];
 
-exports.describe = "Run tests with Mocha";
+export const describe = "Run tests with Mocha";
 
-exports.builder = (yargs) =>
+export const builder = (yargs) =>
   yargs
     .options({
       "allow-uncaught": {
@@ -368,7 +365,7 @@ exports.builder = (yargs) =>
     .number(types.number)
     .alias(aliases);
 
-exports.handler = async function (argv) {
+export async function handler(argv) {
   debug("post-yargs config", argv);
   const mocha = new Mocha(argv);
 
@@ -378,4 +375,4 @@ exports.handler = async function (argv) {
     console.error("\n Exception during run:", err);
     process.exit(1);
   }
-};
+}

test/node-unit/cli/run.spec.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const { builder } = require("../../../lib/cli/run");
+const { builder } = require("../../../lib/cli/run.mjs");
 const { types } = require("../../../lib/cli/run-option-metadata.mjs");
 
 describe("command", function () {
@@ -20,5 +20,16 @@ describe("command", function () {
         });
       });
     });
+
+    it("is available as an ESM command module", async function () {
+      const runModule = await import("../../../lib/cli/run.mjs");
+
+      expect(runModule, "to satisfy", {
+        command: ["$0 [spec..]", "inspect"],
+        describe: "Run tests with Mocha",
+        builder: expect.it("to be a function"),
+        handler: expect.it("to be a function"),
+      });
+    });
   });
 });