mirror of
https://github.com/nodejs/node.git
synced 2025-05-15 12:45:25 +00:00
df22736d80
doc: update ESM hook examples esm: fix unsafe primordial doc: fix ESM example linting esm: allow source of type ArrayBuffer doc: update ESM hook changelog to include resolve format esm: allow all ArrayBuffers and TypedArrays for load hook source doc: tidy code & API docs doc: convert ESM source table header from Title Case to Sentence case doc: add detailed explanation for getPackageType esm: add caveat that ESMLoader::import() must NOT be renamed esm: tidy code declaration of getFormat protocolHandlers doc: correct ESM doc link (bad conflict resolution) doc: update ESM hook limitation for CJS esm: tweak preload description doc: update ESM getPackageType() example explanation PR-URL: https://github.com/nodejs/node/pull/37468 Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Guy Bedford <guybedford@gmail.com> Reviewed-By: Bradley Farias <bradley.meck@gmail.com> Reviewed-By: Geoffrey Booth <webmaster@geoffreybooth.com>
89 lines
2.6 KiB
JavaScript
89 lines
2.6 KiB
JavaScript
'use strict';
|
|
|
|
const {
|
|
StringPrototypeEndsWith,
|
|
} = primordials;
|
|
const CJSLoader = require('internal/modules/cjs/loader');
|
|
const { Module, toRealPath, readPackageScope } = CJSLoader;
|
|
const { getOptionValue } = require('internal/options');
|
|
const path = require('path');
|
|
|
|
function resolveMainPath(main) {
|
|
// Note extension resolution for the main entry point can be deprecated in a
|
|
// future major.
|
|
// Module._findPath is monkey-patchable here.
|
|
let mainPath = Module._findPath(path.resolve(main), null, true);
|
|
if (!mainPath)
|
|
return;
|
|
|
|
const preserveSymlinksMain = getOptionValue('--preserve-symlinks-main');
|
|
if (!preserveSymlinksMain)
|
|
mainPath = toRealPath(mainPath);
|
|
|
|
return mainPath;
|
|
}
|
|
|
|
function shouldUseESMLoader(mainPath) {
|
|
const userLoader = getOptionValue('--experimental-loader');
|
|
if (userLoader)
|
|
return true;
|
|
const esModuleSpecifierResolution =
|
|
getOptionValue('--experimental-specifier-resolution');
|
|
if (esModuleSpecifierResolution === 'node')
|
|
return true;
|
|
// Determine the module format of the main
|
|
if (mainPath && StringPrototypeEndsWith(mainPath, '.mjs'))
|
|
return true;
|
|
if (!mainPath || StringPrototypeEndsWith(mainPath, '.cjs'))
|
|
return false;
|
|
const pkg = readPackageScope(mainPath);
|
|
return pkg && pkg.data.type === 'module';
|
|
}
|
|
|
|
function runMainESM(mainPath) {
|
|
const { loadESM } = require('internal/process/esm_loader');
|
|
const { pathToFileURL } = require('internal/url');
|
|
|
|
handleMainPromise(loadESM((esmLoader) => {
|
|
const main = path.isAbsolute(mainPath) ?
|
|
pathToFileURL(mainPath).href :
|
|
mainPath;
|
|
return esmLoader.import(main);
|
|
}));
|
|
}
|
|
|
|
async function handleMainPromise(promise) {
|
|
// Handle a Promise from running code that potentially does Top-Level Await.
|
|
// In that case, it makes sense to set the exit code to a specific non-zero
|
|
// value if the main code never finishes running.
|
|
function handler() {
|
|
if (process.exitCode === undefined)
|
|
process.exitCode = 13;
|
|
}
|
|
process.on('exit', handler);
|
|
try {
|
|
return await promise;
|
|
} finally {
|
|
process.off('exit', handler);
|
|
}
|
|
}
|
|
|
|
// For backwards compatibility, we have to run a bunch of
|
|
// monkey-patchable code that belongs to the CJS loader (exposed by
|
|
// `require('module')`) even when the entry point is ESM.
|
|
function executeUserEntryPoint(main = process.argv[1]) {
|
|
const resolvedMain = resolveMainPath(main);
|
|
const useESMLoader = shouldUseESMLoader(resolvedMain);
|
|
if (useESMLoader) {
|
|
runMainESM(resolvedMain || main);
|
|
} else {
|
|
// Module._load is the monkey-patchable CJS module loader.
|
|
Module._load(main, null, true);
|
|
}
|
|
}
|
|
|
|
module.exports = {
|
|
executeUserEntryPoint,
|
|
handleMainPromise,
|
|
};
|