mirror of
https://github.com/nodejs/node.git
synced 2025-05-23 02:29:32 +00:00

Previously when managing the importModuleDynamically callback of vm.compileFunction(), we use an ID number as the host defined option and maintain a per-Environment ID -> CompiledFnEntry map to retain the top-level referrer function returned by vm.compileFunction() in order to pass it back to the callback, but it would leak because with how we used v8::Persistent to maintain this reference, V8 would not be able to understand the cycle and would just think that the CompiledFnEntry was supposed to live forever. We made an attempt to make that reference known to V8 by making the CompiledFnEntry weak and using a private symbol to make CompiledFnEntry strongly references the top-level referrer function in https://github.com/nodejs/node/pull/46785, but that turned out to be unsound, because the there's no guarantee that the top-level function must be alive while import() can still be initiated from that function, since V8 could discard the top-level function and only keep inner functions alive, so relying on the top-level function to keep the CompiledFnEntry alive could result in use-after-free which caused a revert of that fix. With this patch we use a symbol in the host defined options instead of a number, because with the stage-3 symbol-as-weakmap-keys proposal we could directly use that symbol to keep the referrer alive using a WeakMap. As a bonus this also keeps the other kinds of referrers alive as long as import() can still be initiated from that Script/Module, so this also fixes the long-standing crash caused by vm.Script being GC'ed too early when its importModuleDynamically callback still needs it. PR-URL: https://github.com/nodejs/node/pull/48510 Refs: https://github.com/nodejs/node/issues/44211 Refs: https://github.com/nodejs/node/issues/42080 Refs: https://github.com/nodejs/node/issues/47096 Refs: https://github.com/nodejs/node/issues/43205 Refs: https://github.com/nodejs/node/issues/38695 Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Stephen Belanger <admin@stephenbelanger.com>
452 lines
12 KiB
JavaScript
452 lines
12 KiB
JavaScript
'use strict';
|
|
|
|
const assert = require('internal/assert');
|
|
const {
|
|
ArrayIsArray,
|
|
ArrayPrototypeForEach,
|
|
ArrayPrototypeIndexOf,
|
|
ArrayPrototypeSome,
|
|
ObjectDefineProperty,
|
|
ObjectGetPrototypeOf,
|
|
ObjectSetPrototypeOf,
|
|
ReflectApply,
|
|
SafePromiseAllReturnVoid,
|
|
Symbol,
|
|
SymbolToStringTag,
|
|
TypeError,
|
|
} = primordials;
|
|
|
|
const { isContext } = internalBinding('contextify');
|
|
const {
|
|
isModuleNamespaceObject,
|
|
} = require('internal/util/types');
|
|
const {
|
|
customInspectSymbol,
|
|
emitExperimentalWarning,
|
|
getConstructorOf,
|
|
kEmptyObject,
|
|
} = require('internal/util');
|
|
const {
|
|
ERR_INVALID_ARG_TYPE,
|
|
ERR_INVALID_ARG_VALUE,
|
|
ERR_VM_MODULE_ALREADY_LINKED,
|
|
ERR_VM_MODULE_DIFFERENT_CONTEXT,
|
|
ERR_VM_MODULE_CANNOT_CREATE_CACHED_DATA,
|
|
ERR_VM_MODULE_LINK_FAILURE,
|
|
ERR_VM_MODULE_NOT_MODULE,
|
|
ERR_VM_MODULE_STATUS,
|
|
} = require('internal/errors').codes;
|
|
const {
|
|
validateBoolean,
|
|
validateBuffer,
|
|
validateFunction,
|
|
validateInt32,
|
|
validateObject,
|
|
validateUint32,
|
|
validateString,
|
|
} = require('internal/validators');
|
|
|
|
const binding = internalBinding('module_wrap');
|
|
const {
|
|
ModuleWrap,
|
|
kUninstantiated,
|
|
kInstantiating,
|
|
kInstantiated,
|
|
kEvaluating,
|
|
kEvaluated,
|
|
kErrored,
|
|
} = binding;
|
|
|
|
const STATUS_MAP = {
|
|
[kUninstantiated]: 'unlinked',
|
|
[kInstantiating]: 'linking',
|
|
[kInstantiated]: 'linked',
|
|
[kEvaluating]: 'evaluating',
|
|
[kEvaluated]: 'evaluated',
|
|
[kErrored]: 'errored',
|
|
};
|
|
|
|
let globalModuleId = 0;
|
|
const defaultModuleName = 'vm:module';
|
|
|
|
const kWrap = Symbol('kWrap');
|
|
const kContext = Symbol('kContext');
|
|
const kPerContextModuleId = Symbol('kPerContextModuleId');
|
|
const kLink = Symbol('kLink');
|
|
|
|
class Module {
|
|
constructor(options) {
|
|
emitExperimentalWarning('VM Modules');
|
|
|
|
if (new.target === Module) {
|
|
// eslint-disable-next-line no-restricted-syntax
|
|
throw new TypeError('Module is not a constructor');
|
|
}
|
|
|
|
const {
|
|
context,
|
|
sourceText,
|
|
syntheticExportNames,
|
|
syntheticEvaluationSteps,
|
|
} = options;
|
|
|
|
if (context !== undefined) {
|
|
validateObject(context, 'context');
|
|
if (!isContext(context)) {
|
|
throw new ERR_INVALID_ARG_TYPE('options.context', 'vm.Context',
|
|
context);
|
|
}
|
|
}
|
|
|
|
let { identifier } = options;
|
|
if (identifier !== undefined) {
|
|
validateString(identifier, 'options.identifier');
|
|
} else if (context === undefined) {
|
|
identifier = `${defaultModuleName}(${globalModuleId++})`;
|
|
} else if (context[kPerContextModuleId] !== undefined) {
|
|
const curId = context[kPerContextModuleId];
|
|
identifier = `${defaultModuleName}(${curId})`;
|
|
context[kPerContextModuleId] += 1;
|
|
} else {
|
|
identifier = `${defaultModuleName}(0)`;
|
|
ObjectDefineProperty(context, kPerContextModuleId, {
|
|
__proto__: null,
|
|
value: 1,
|
|
writable: true,
|
|
enumerable: false,
|
|
configurable: true,
|
|
});
|
|
}
|
|
|
|
let registry = { __proto__: null };
|
|
if (sourceText !== undefined) {
|
|
this[kWrap] = new ModuleWrap(identifier, context, sourceText,
|
|
options.lineOffset, options.columnOffset,
|
|
options.cachedData);
|
|
registry = {
|
|
__proto__: null,
|
|
initializeImportMeta: options.initializeImportMeta,
|
|
importModuleDynamically: options.importModuleDynamically ?
|
|
importModuleDynamicallyWrap(options.importModuleDynamically) :
|
|
undefined,
|
|
};
|
|
} else {
|
|
assert(syntheticEvaluationSteps);
|
|
this[kWrap] = new ModuleWrap(identifier, context,
|
|
syntheticExportNames,
|
|
syntheticEvaluationSteps);
|
|
}
|
|
|
|
// This will take precedence over the referrer as the object being
|
|
// passed into the callbacks.
|
|
registry.callbackReferrer = this;
|
|
const { registerModule } = require('internal/modules/esm/utils');
|
|
registerModule(this[kWrap], registry);
|
|
|
|
this[kContext] = context;
|
|
}
|
|
|
|
get identifier() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
return this[kWrap].url;
|
|
}
|
|
|
|
get context() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
return this[kContext];
|
|
}
|
|
|
|
get namespace() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (this[kWrap].getStatus() < kInstantiated) {
|
|
throw new ERR_VM_MODULE_STATUS('must not be unlinked or linking');
|
|
}
|
|
return this[kWrap].getNamespace();
|
|
}
|
|
|
|
get status() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
return STATUS_MAP[this[kWrap].getStatus()];
|
|
}
|
|
|
|
get error() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (this[kWrap].getStatus() !== kErrored) {
|
|
throw new ERR_VM_MODULE_STATUS('must be errored');
|
|
}
|
|
return this[kWrap].getError();
|
|
}
|
|
|
|
async link(linker) {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
validateFunction(linker, 'linker');
|
|
if (this.status === 'linked') {
|
|
throw new ERR_VM_MODULE_ALREADY_LINKED();
|
|
}
|
|
if (this.status !== 'unlinked') {
|
|
throw new ERR_VM_MODULE_STATUS('must be unlinked');
|
|
}
|
|
await this[kLink](linker);
|
|
this[kWrap].instantiate();
|
|
}
|
|
|
|
async evaluate(options = kEmptyObject) {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
|
|
validateObject(options, 'options');
|
|
|
|
let timeout = options.timeout;
|
|
if (timeout === undefined) {
|
|
timeout = -1;
|
|
} else {
|
|
validateUint32(timeout, 'options.timeout', true);
|
|
}
|
|
const { breakOnSigint = false } = options;
|
|
validateBoolean(breakOnSigint, 'options.breakOnSigint');
|
|
const status = this[kWrap].getStatus();
|
|
if (status !== kInstantiated &&
|
|
status !== kEvaluated &&
|
|
status !== kErrored) {
|
|
throw new ERR_VM_MODULE_STATUS(
|
|
'must be one of linked, evaluated, or errored',
|
|
);
|
|
}
|
|
await this[kWrap].evaluate(timeout, breakOnSigint);
|
|
}
|
|
|
|
[customInspectSymbol](depth, options) {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (typeof depth === 'number' && depth < 0)
|
|
return this;
|
|
|
|
const constructor = getConstructorOf(this) || Module;
|
|
const o = { __proto__: { constructor } };
|
|
o.status = this.status;
|
|
o.identifier = this.identifier;
|
|
o.context = this.context;
|
|
|
|
ObjectSetPrototypeOf(o, ObjectGetPrototypeOf(this));
|
|
ObjectDefineProperty(o, SymbolToStringTag, {
|
|
__proto__: null,
|
|
value: constructor.name,
|
|
configurable: true,
|
|
});
|
|
|
|
// Lazy to avoid circular dependency
|
|
const { inspect } = require('internal/util/inspect');
|
|
return inspect(o, { ...options, customInspect: false });
|
|
}
|
|
}
|
|
|
|
const kDependencySpecifiers = Symbol('kDependencySpecifiers');
|
|
const kNoError = Symbol('kNoError');
|
|
|
|
class SourceTextModule extends Module {
|
|
#error = kNoError;
|
|
#statusOverride;
|
|
|
|
constructor(sourceText, options = kEmptyObject) {
|
|
validateString(sourceText, 'sourceText');
|
|
validateObject(options, 'options');
|
|
|
|
const {
|
|
lineOffset = 0,
|
|
columnOffset = 0,
|
|
initializeImportMeta,
|
|
importModuleDynamically,
|
|
context,
|
|
identifier,
|
|
cachedData,
|
|
} = options;
|
|
|
|
validateInt32(lineOffset, 'options.lineOffset');
|
|
validateInt32(columnOffset, 'options.columnOffset');
|
|
|
|
if (initializeImportMeta !== undefined) {
|
|
validateFunction(initializeImportMeta, 'options.initializeImportMeta');
|
|
}
|
|
|
|
if (importModuleDynamically !== undefined) {
|
|
validateFunction(importModuleDynamically, 'options.importModuleDynamically');
|
|
}
|
|
|
|
if (cachedData !== undefined) {
|
|
validateBuffer(cachedData, 'options.cachedData');
|
|
}
|
|
|
|
super({
|
|
sourceText,
|
|
context,
|
|
identifier,
|
|
lineOffset,
|
|
columnOffset,
|
|
cachedData,
|
|
initializeImportMeta,
|
|
importModuleDynamically,
|
|
});
|
|
|
|
this[kLink] = async (linker) => {
|
|
this.#statusOverride = 'linking';
|
|
|
|
const promises = this[kWrap].link(async (identifier, assert) => {
|
|
const module = await linker(identifier, this, { assert });
|
|
if (module[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (module.context !== this.context) {
|
|
throw new ERR_VM_MODULE_DIFFERENT_CONTEXT();
|
|
}
|
|
if (module.status === 'errored') {
|
|
throw new ERR_VM_MODULE_LINK_FAILURE(`request for '${identifier}' resolved to an errored module`, module.error);
|
|
}
|
|
if (module.status === 'unlinked') {
|
|
await module[kLink](linker);
|
|
}
|
|
return module[kWrap];
|
|
});
|
|
|
|
try {
|
|
if (promises !== undefined) {
|
|
await SafePromiseAllReturnVoid(promises);
|
|
}
|
|
} catch (e) {
|
|
this.#error = e;
|
|
throw e;
|
|
} finally {
|
|
this.#statusOverride = undefined;
|
|
}
|
|
};
|
|
|
|
this[kDependencySpecifiers] = undefined;
|
|
}
|
|
|
|
get dependencySpecifiers() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (this[kDependencySpecifiers] === undefined) {
|
|
this[kDependencySpecifiers] = this[kWrap].getStaticDependencySpecifiers();
|
|
}
|
|
return this[kDependencySpecifiers];
|
|
}
|
|
|
|
get status() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (this.#error !== kNoError) {
|
|
return 'errored';
|
|
}
|
|
if (this.#statusOverride) {
|
|
return this.#statusOverride;
|
|
}
|
|
return super.status;
|
|
}
|
|
|
|
get error() {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (this.#error !== kNoError) {
|
|
return this.#error;
|
|
}
|
|
return super.error;
|
|
}
|
|
|
|
createCachedData() {
|
|
const { status } = this;
|
|
if (status === 'evaluating' ||
|
|
status === 'evaluated' ||
|
|
status === 'errored') {
|
|
throw new ERR_VM_MODULE_CANNOT_CREATE_CACHED_DATA();
|
|
}
|
|
return this[kWrap].createCachedData();
|
|
}
|
|
}
|
|
|
|
class SyntheticModule extends Module {
|
|
constructor(exportNames, evaluateCallback, options = kEmptyObject) {
|
|
if (!ArrayIsArray(exportNames) ||
|
|
ArrayPrototypeSome(exportNames, (e) => typeof e !== 'string')) {
|
|
throw new ERR_INVALID_ARG_TYPE('exportNames',
|
|
'Array of unique strings',
|
|
exportNames);
|
|
} else {
|
|
ArrayPrototypeForEach(exportNames, (name, i) => {
|
|
if (ArrayPrototypeIndexOf(exportNames, name, i + 1) !== -1) {
|
|
throw new ERR_INVALID_ARG_VALUE(`exportNames.${name}`,
|
|
name,
|
|
'is duplicated');
|
|
}
|
|
});
|
|
}
|
|
validateFunction(evaluateCallback, 'evaluateCallback');
|
|
|
|
validateObject(options, 'options');
|
|
|
|
const { context, identifier } = options;
|
|
|
|
super({
|
|
syntheticExportNames: exportNames,
|
|
syntheticEvaluationSteps: evaluateCallback,
|
|
context,
|
|
identifier,
|
|
});
|
|
|
|
this[kLink] = () => this[kWrap].link(() => {
|
|
assert.fail('link callback should not be called');
|
|
});
|
|
}
|
|
|
|
setExport(name, value) {
|
|
if (this[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
validateString(name, 'name');
|
|
if (this[kWrap].getStatus() < kInstantiated) {
|
|
throw new ERR_VM_MODULE_STATUS('must be linked');
|
|
}
|
|
this[kWrap].setExport(name, value);
|
|
}
|
|
}
|
|
|
|
function importModuleDynamicallyWrap(importModuleDynamically) {
|
|
const importModuleDynamicallyWrapper = async (...args) => {
|
|
const m = await ReflectApply(importModuleDynamically, this, args);
|
|
if (isModuleNamespaceObject(m)) {
|
|
return m;
|
|
}
|
|
if (!m || m[kWrap] === undefined) {
|
|
throw new ERR_VM_MODULE_NOT_MODULE();
|
|
}
|
|
if (m.status === 'errored') {
|
|
throw m.error;
|
|
}
|
|
return m.namespace;
|
|
};
|
|
return importModuleDynamicallyWrapper;
|
|
}
|
|
|
|
module.exports = {
|
|
Module,
|
|
SourceTextModule,
|
|
SyntheticModule,
|
|
importModuleDynamicallyWrap,
|
|
};
|