Fix documentation of running ESM jest

[edemaine]

Summary

node --experimental-vm-modules node_modules/.bin/jest doesn't work (at least on Windows) because node_modules/.bin/jest is a shell script:

#!/bin/sh
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")

case `uname` in
    *CYGWIN*|*MINGW*|*MSYS*) basedir=`cygpath -w "$basedir"`;;
esac

if [ -x "$basedir/node" ]; then
  exec "$basedir/node"  "$basedir/../jest/bin/jest.js" "$@"
else
  exec node  "$basedir/../jest/bin/jest.js" "$@"
fi

node --experimental-vm-modules node_modules/jest/bin/jest.js works well for me by pointing directly to the JavaScript that Node can run. I saw this version
in this StackOverflow post.

Test plan

$ node --experimental-vm-modules node_modules/.bin/jest
C:\...\node_modules\.bin\jest:2
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
          ^^^^^^^

SyntaxError: missing ) after argument list
    at Object.compileFunction (node:vm:352:18)
    at wrapSafe (node:internal/modules/cjs/loader:1031:15)
    at Module._compile (node:internal/modules/cjs/loader:1065:27)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1153:10)
    at Module.load (node:internal/modules/cjs/loader:981:32)
    at Function.Module._load (node:internal/modules/cjs/loader:822:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:79:12)
    at node:internal/main/run_main_module:17:47

$ node --experimental-vm-modules node_modules/jest/bin/jest.js
(node:11736) ExperimentalWarning: VM Modules is an experimental feature. This feature could change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
 PASS  ./index.test.js
...

[orta]

Looks good, and we can ignore the reds - can you duplicate the change in https://github.com/facebook/jest/blob/master/docs/ECMAScriptModules.md so that it ends up in all future docs too please 👍🏻

[SimenB]

@edemaine could you update all editions of the versioned docs as well?

[edemaine]

Sorry for the delay. This should be fully propagated now.

[SimenB]

thanks!

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
Please note this issue tracker is not a help forum. We recommend using StackOverflow or our discord channel for questions.