[8.18] fix dysfunctional read_jest_help.mjs (#236143) (#236229)

# Backport

This will backport the following commits from `main` to `8.18`:
- [fix dysfunctional `read_jest_help.mjs`
(#236143)](#236143)

<!--- Backport version: 9.6.6 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Alex
Szabo","email":"[email protected]"},"sourceCommit":{"committedDate":"2025-09-24T08:24:02Z","message":"fix
dysfunctional `read_jest_help.mjs` (#236143)\n\n##
Summary\n`src/platform/packages/shared/kbn-test/src/jest/run.ts` makes
a\nreference to an existing script, `read_jest_help.mjs`. However this
file\ndoesn't work as
advertised.\n\n```\nnode:internal/modules/esm/resolve:204\n const
resolvedOption = FSLegacyMainResolve(pkgPath, packageConfig.main,
baseStringified);\n ^\n\nError: Cannot find package
'/Users/alex/Git/elastic-kibana/node_modules/@kbn/dev-cli-errors/index.js'
imported from
/Users/alex/Git/elastic-kibana/scripts/read_jest_help.mjs\n at
legacyMainResolve (node:internal/modules/esm/resolve:204:26)\n at
packageResolve (node:internal/modules/esm/resolve:778:12)\n```\n\nAn
easy way to fix this was to move it to cjs, updating the imports,
and\nit started working again.\nThe update to
the\n`src/platform/packages/shared/kbn-test/src/jest/jest_flags.json`
is\nthrough running the
script.","sha":"06971a36690b2bd34c7cd4b1db53ed8312515e6d","branchLabelMapping":{"^v9.2.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["release_note:skip","backport:all-open","v9.2.0"],"title":"fix
dysfunctional
`read_jest_help.mjs`","number":236143,"url":"https://github.com/elastic/kibana/pull/236143","mergeCommit":{"message":"fix
dysfunctional `read_jest_help.mjs` (#236143)\n\n##
Summary\n`src/platform/packages/shared/kbn-test/src/jest/run.ts` makes
a\nreference to an existing script, `read_jest_help.mjs`. However this
file\ndoesn't work as
advertised.\n\n```\nnode:internal/modules/esm/resolve:204\n const
resolvedOption = FSLegacyMainResolve(pkgPath, packageConfig.main,
baseStringified);\n ^\n\nError: Cannot find package
'/Users/alex/Git/elastic-kibana/node_modules/@kbn/dev-cli-errors/index.js'
imported from
/Users/alex/Git/elastic-kibana/scripts/read_jest_help.mjs\n at
legacyMainResolve (node:internal/modules/esm/resolve:204:26)\n at
packageResolve (node:internal/modules/esm/resolve:778:12)\n```\n\nAn
easy way to fix this was to move it to cjs, updating the imports,
and\nit started working again.\nThe update to
the\n`src/platform/packages/shared/kbn-test/src/jest/jest_flags.json`
is\nthrough running the
script.","sha":"06971a36690b2bd34c7cd4b1db53ed8312515e6d"}},"sourceBranch":"main","suggestedTargetBranches":[],"targetPullRequestStates":[{"branch":"main","label":"v9.2.0","branchLabelMappingKey":"^v9.2.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/236143","number":236143,"mergeCommit":{"message":"fix
dysfunctional `read_jest_help.mjs` (#236143)\n\n##
Summary\n`src/platform/packages/shared/kbn-test/src/jest/run.ts` makes
a\nreference to an existing script, `read_jest_help.mjs`. However this
file\ndoesn't work as
advertised.\n\n```\nnode:internal/modules/esm/resolve:204\n const
resolvedOption = FSLegacyMainResolve(pkgPath, packageConfig.main,
baseStringified);\n ^\n\nError: Cannot find package
'/Users/alex/Git/elastic-kibana/node_modules/@kbn/dev-cli-errors/index.js'
imported from
/Users/alex/Git/elastic-kibana/scripts/read_jest_help.mjs\n at
legacyMainResolve (node:internal/modules/esm/resolve:204:26)\n at
packageResolve (node:internal/modules/esm/resolve:778:12)\n```\n\nAn
easy way to fix this was to move it to cjs, updating the imports,
and\nit started working again.\nThe update to
the\n`src/platform/packages/shared/kbn-test/src/jest/jest_flags.json`
is\nthrough running the
script.","sha":"06971a36690b2bd34c7cd4b1db53ed8312515e6d"}}]}]
BACKPORT-->

Co-authored-by: Alex Szabo <[email protected]>

Author: kibanamachine

scripts/read_jest_help.mjs renamed to scripts/read_jest_help.cjs

@@ -7,12 +7,14 @@
  * License v3.0 only", or the "Server Side Public License, v 1".
  */
 
-import Fsp from 'fs/promises';
-import Path from 'path';
+require('../src/setup_node_env');
 
-import { createFailError } from '@kbn/dev-cli-errors';
-import { run } from '@kbn/dev-cli-runner';
-import { REPO_ROOT } from '@kbn/repo-info';
+const Fsp = require('fs/promises');
+const Path = require('path');
+
+const { createFailError } = require('@kbn/dev-cli-errors');
+const { run } = require('@kbn/dev-cli-runner');
+const { REPO_ROOT } = require('@kbn/repo-info');
 
 const FLAGS_FILE = 'src/platform/packages/shared/kbn-test/src/jest/jest_flags.json';
 
@@ -21,7 +23,7 @@ function readStdin() {
     let buffer = '';
     let timer = setTimeout(() => {
       reject(
-        createFailError('you must pipe the output of `yarn jest --help` to this script', {
+        new Error('you must pipe the output of `yarn jest --help` to this script', {
           showHelp: true,
         })
       );
@@ -113,7 +115,7 @@ run(
     log.warning('make sure you bootstrap to rebuild @kbn/test');
   },
   {
-    usage: `yarn jest --help | node scripts/read_jest_help.mjs`,
+    usage: `yarn jest --help | node scripts/read_jest_help.cjs`,
     description: `
       Jest no longer exposes the ability to parse CLI flags externally, so we use this
       script to read the help output and convert it into parameters we can pass to getopts()

src/platform/packages/shared/kbn-test/src/jest/jest_flags.json

@@ -24,6 +24,7 @@
     "modulePathIgnorePatterns",
     "modulePaths",
     "notifyMode",
+    "openHandlesTimeout",
     "outputFile",
     "preset",
     "prettierPath",
@@ -88,6 +89,7 @@
     "onlyChanged",
     "onlyFailures",
     "passWithNoTests",
+    "randomize",
     "resetMocks",
     "resetModules",
     "restoreMocks",
@@ -104,7 +106,8 @@
     "version",
     "watch",
     "watchAll",
-    "watchman"
+    "watchman",
+    "workerThreads"
   ],
   "alias": {
     "b": "bail",

src/platform/packages/shared/kbn-test/src/jest/run.ts

@@ -56,7 +56,7 @@ export function runJest(configName = 'jest.config.js') {
 
   If this flag is valid you might need to update the flags in "src/platform/packages/shared/kbn-test/src/jest/run.js".
 
-  Run 'yarn jest --help | node scripts/read_jest_help.mjs' to update this scripts knowledge of what
+  Run 'yarn jest --help | node scripts/read_jest_help.cjs' to update this scripts knowledge of what
   flags jest supports
 
 `