691 lines
29 KiB
JavaScript
691 lines
29 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.QuickJSContext = void 0;
|
|
const debug_1 = require("./debug");
|
|
const deferred_promise_1 = require("./deferred-promise");
|
|
const errors_1 = require("./errors");
|
|
const lifetime_1 = require("./lifetime");
|
|
const memory_1 = require("./memory");
|
|
const types_1 = require("./types");
|
|
/**
|
|
* @private
|
|
*/
|
|
class ContextMemory extends memory_1.ModuleMemory {
|
|
/** @private */
|
|
constructor(args) {
|
|
super(args.module);
|
|
this.scope = new lifetime_1.Scope();
|
|
this.copyJSValue = (ptr) => {
|
|
return this.ffi.QTS_DupValuePointer(this.ctx.value, ptr);
|
|
};
|
|
this.freeJSValue = (ptr) => {
|
|
this.ffi.QTS_FreeValuePointer(this.ctx.value, ptr);
|
|
};
|
|
args.ownedLifetimes?.forEach((lifetime) => this.scope.manage(lifetime));
|
|
this.owner = args.owner;
|
|
this.module = args.module;
|
|
this.ffi = args.ffi;
|
|
this.rt = args.rt;
|
|
this.ctx = this.scope.manage(args.ctx);
|
|
}
|
|
get alive() {
|
|
return this.scope.alive;
|
|
}
|
|
dispose() {
|
|
return this.scope.dispose();
|
|
}
|
|
/**
|
|
* Track `lifetime` so that it is disposed when this scope is disposed.
|
|
*/
|
|
manage(lifetime) {
|
|
return this.scope.manage(lifetime);
|
|
}
|
|
consumeJSCharPointer(ptr) {
|
|
const str = this.module.UTF8ToString(ptr);
|
|
this.ffi.QTS_FreeCString(this.ctx.value, ptr);
|
|
return str;
|
|
}
|
|
heapValueHandle(ptr) {
|
|
return new lifetime_1.Lifetime(ptr, this.copyJSValue, this.freeJSValue, this.owner);
|
|
}
|
|
}
|
|
/**
|
|
* QuickJSContext wraps a QuickJS Javascript context (JSContext*) within a
|
|
* runtime. The contexts within the same runtime may exchange objects freely.
|
|
* You can think of separate runtimes like different domains in a browser, and
|
|
* the contexts within a runtime like the different windows open to the same
|
|
* domain. The {@link runtime} references the context's runtime.
|
|
*
|
|
* This class's methods return {@link QuickJSHandle}, which wrap C pointers (JSValue*).
|
|
* It's the caller's responsibility to call `.dispose()` on any
|
|
* handles you create to free memory once you're done with the handle.
|
|
*
|
|
* Use {@link QuickJSRuntime.newContext} or {@link QuickJSWASMModule.newContext}
|
|
* to create a new QuickJSContext.
|
|
*
|
|
* Create QuickJS values inside the interpreter with methods like
|
|
* [[newNumber]], [[newString]], [[newArray]], [[newObject]],
|
|
* [[newFunction]], and [[newPromise]].
|
|
*
|
|
* Call [[setProp]] or [[defineProp]] to customize objects. Use those methods
|
|
* with [[global]] to expose the values you create to the interior of the
|
|
* interpreter, so they can be used in [[evalCode]].
|
|
*
|
|
* Use [[evalCode]] or [[callFunction]] to execute Javascript inside the VM. If
|
|
* you're using asynchronous code inside the QuickJSContext, you may need to also
|
|
* call [[executePendingJobs]]. Executing code inside the runtime returns a
|
|
* result object representing successful execution or an error. You must dispose
|
|
* of any such results to avoid leaking memory inside the VM.
|
|
*
|
|
* Implement memory and CPU constraints at the runtime level, using [[runtime]].
|
|
* See {@link QuickJSRuntime} for more information.
|
|
*
|
|
*/
|
|
// TODO: Manage own callback registration
|
|
class QuickJSContext {
|
|
/**
|
|
* Use {@link QuickJS.createVm} to create a QuickJSContext instance.
|
|
*/
|
|
constructor(args) {
|
|
/** @private */
|
|
this._undefined = undefined;
|
|
/** @private */
|
|
this._null = undefined;
|
|
/** @private */
|
|
this._false = undefined;
|
|
/** @private */
|
|
this._true = undefined;
|
|
/** @private */
|
|
this._global = undefined;
|
|
/** @private */
|
|
this._BigInt = undefined;
|
|
/** @private */
|
|
this.fnNextId = -32768; // min value of signed 16bit int used by Quickjs
|
|
/** @private */
|
|
this.fnMaps = new Map();
|
|
/**
|
|
* @hidden
|
|
*/
|
|
this.cToHostCallbacks = {
|
|
callFunction: (ctx, this_ptr, argc, argv, fn_id) => {
|
|
if (ctx !== this.ctx.value) {
|
|
throw new Error("QuickJSContext instance received C -> JS call with mismatched ctx");
|
|
}
|
|
const fn = this.getFunction(fn_id);
|
|
if (!fn) {
|
|
// this "throw" is not catch-able from the TS side. could we somehow handle this higher up?
|
|
throw new Error(`QuickJSContext had no callback with id ${fn_id}`);
|
|
}
|
|
return lifetime_1.Scope.withScopeMaybeAsync(this, function* (awaited, scope) {
|
|
const thisHandle = scope.manage(new lifetime_1.WeakLifetime(this_ptr, this.memory.copyJSValue, this.memory.freeJSValue, this.runtime));
|
|
const argHandles = new Array(argc);
|
|
for (let i = 0; i < argc; i++) {
|
|
const ptr = this.ffi.QTS_ArgvGetJSValueConstPointer(argv, i);
|
|
argHandles[i] = scope.manage(new lifetime_1.WeakLifetime(ptr, this.memory.copyJSValue, this.memory.freeJSValue, this.runtime));
|
|
}
|
|
try {
|
|
const result = yield* awaited(fn.apply(thisHandle, argHandles));
|
|
if (result) {
|
|
if ("error" in result && result.error) {
|
|
(0, debug_1.debugLog)("throw error", result.error);
|
|
throw result.error;
|
|
}
|
|
const handle = scope.manage(result instanceof lifetime_1.Lifetime ? result : result.value);
|
|
return this.ffi.QTS_DupValuePointer(this.ctx.value, handle.value);
|
|
}
|
|
return 0;
|
|
}
|
|
catch (error) {
|
|
return this.errorToHandle(error).consume((errorHandle) => this.ffi.QTS_Throw(this.ctx.value, errorHandle.value));
|
|
}
|
|
});
|
|
},
|
|
};
|
|
this.runtime = args.runtime;
|
|
this.module = args.module;
|
|
this.ffi = args.ffi;
|
|
this.rt = args.rt;
|
|
this.ctx = args.ctx;
|
|
this.memory = new ContextMemory({
|
|
...args,
|
|
owner: this.runtime,
|
|
});
|
|
args.callbacks.setContextCallbacks(this.ctx.value, this.cToHostCallbacks);
|
|
this.dump = this.dump.bind(this);
|
|
this.getString = this.getString.bind(this);
|
|
this.getNumber = this.getNumber.bind(this);
|
|
this.resolvePromise = this.resolvePromise.bind(this);
|
|
}
|
|
// @implement Disposable ----------------------------------------------------
|
|
get alive() {
|
|
return this.memory.alive;
|
|
}
|
|
/**
|
|
* Dispose of this VM's underlying resources.
|
|
*
|
|
* @throws Calling this method without disposing of all created handles
|
|
* will result in an error.
|
|
*/
|
|
dispose() {
|
|
this.memory.dispose();
|
|
}
|
|
// Globals ------------------------------------------------------------------
|
|
/**
|
|
* [`undefined`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined).
|
|
*/
|
|
get undefined() {
|
|
if (this._undefined) {
|
|
return this._undefined;
|
|
}
|
|
// Undefined is a constant, immutable value in QuickJS.
|
|
const ptr = this.ffi.QTS_GetUndefined();
|
|
return (this._undefined = new lifetime_1.StaticLifetime(ptr));
|
|
}
|
|
/**
|
|
* [`null`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/null).
|
|
*/
|
|
get null() {
|
|
if (this._null) {
|
|
return this._null;
|
|
}
|
|
// Null is a constant, immutable value in QuickJS.
|
|
const ptr = this.ffi.QTS_GetNull();
|
|
return (this._null = new lifetime_1.StaticLifetime(ptr));
|
|
}
|
|
/**
|
|
* [`true`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/true).
|
|
*/
|
|
get true() {
|
|
if (this._true) {
|
|
return this._true;
|
|
}
|
|
// True is a constant, immutable value in QuickJS.
|
|
const ptr = this.ffi.QTS_GetTrue();
|
|
return (this._true = new lifetime_1.StaticLifetime(ptr));
|
|
}
|
|
/**
|
|
* [`false`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/false).
|
|
*/
|
|
get false() {
|
|
if (this._false) {
|
|
return this._false;
|
|
}
|
|
// False is a constant, immutable value in QuickJS.
|
|
const ptr = this.ffi.QTS_GetFalse();
|
|
return (this._false = new lifetime_1.StaticLifetime(ptr));
|
|
}
|
|
/**
|
|
* [`global`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects).
|
|
* A handle to the global object inside the interpreter.
|
|
* You can set properties to create global variables.
|
|
*/
|
|
get global() {
|
|
if (this._global) {
|
|
return this._global;
|
|
}
|
|
// The global is a JSValue, but since it's lifetime is as long as the VM's,
|
|
// we should manage it.
|
|
const ptr = this.ffi.QTS_GetGlobalObject(this.ctx.value);
|
|
// Automatically clean up this reference when we dispose
|
|
this.memory.manage(this.memory.heapValueHandle(ptr));
|
|
// This isn't technically a static lifetime, but since it has the same
|
|
// lifetime as the VM, it's okay to fake one since when the VM is
|
|
// disposed, no other functions will accept the value.
|
|
this._global = new lifetime_1.StaticLifetime(ptr, this.runtime);
|
|
return this._global;
|
|
}
|
|
// New values ---------------------------------------------------------------
|
|
/**
|
|
* Converts a Javascript number into a QuickJS value.
|
|
*/
|
|
newNumber(num) {
|
|
return this.memory.heapValueHandle(this.ffi.QTS_NewFloat64(this.ctx.value, num));
|
|
}
|
|
/**
|
|
* Create a QuickJS [string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String) value.
|
|
*/
|
|
newString(str) {
|
|
const ptr = this.memory
|
|
.newHeapCharPointer(str)
|
|
.consume((charHandle) => this.ffi.QTS_NewString(this.ctx.value, charHandle.value));
|
|
return this.memory.heapValueHandle(ptr);
|
|
}
|
|
/**
|
|
* Create a QuickJS [symbol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol) value.
|
|
* No two symbols created with this function will be the same value.
|
|
*/
|
|
newUniqueSymbol(description) {
|
|
const key = (typeof description === "symbol" ? description.description : description) ?? "";
|
|
const ptr = this.memory
|
|
.newHeapCharPointer(key)
|
|
.consume((charHandle) => this.ffi.QTS_NewSymbol(this.ctx.value, charHandle.value, 0));
|
|
return this.memory.heapValueHandle(ptr);
|
|
}
|
|
/**
|
|
* Get a symbol from the [global registry](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol#shared_symbols_in_the_global_symbol_registry) for the given key.
|
|
* All symbols created with the same key will be the same value.
|
|
*/
|
|
newSymbolFor(key) {
|
|
const description = (typeof key === "symbol" ? key.description : key) ?? "";
|
|
const ptr = this.memory
|
|
.newHeapCharPointer(description)
|
|
.consume((charHandle) => this.ffi.QTS_NewSymbol(this.ctx.value, charHandle.value, 1));
|
|
return this.memory.heapValueHandle(ptr);
|
|
}
|
|
/**
|
|
* Create a QuickJS [bigint](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) value.
|
|
*/
|
|
newBigInt(num) {
|
|
if (!this._BigInt) {
|
|
const bigIntHandle = this.getProp(this.global, "BigInt");
|
|
this.memory.manage(bigIntHandle);
|
|
this._BigInt = new lifetime_1.StaticLifetime(bigIntHandle.value, this.runtime);
|
|
}
|
|
const bigIntHandle = this._BigInt;
|
|
const asString = String(num);
|
|
return this.newString(asString).consume((handle) => this.unwrapResult(this.callFunction(bigIntHandle, this.undefined, handle)));
|
|
}
|
|
/**
|
|
* `{}`.
|
|
* Create a new QuickJS [object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Object_initializer).
|
|
*
|
|
* @param prototype - Like [`Object.create`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/create).
|
|
*/
|
|
newObject(prototype) {
|
|
if (prototype) {
|
|
this.runtime.assertOwned(prototype);
|
|
}
|
|
const ptr = prototype
|
|
? this.ffi.QTS_NewObjectProto(this.ctx.value, prototype.value)
|
|
: this.ffi.QTS_NewObject(this.ctx.value);
|
|
return this.memory.heapValueHandle(ptr);
|
|
}
|
|
/**
|
|
* `[]`.
|
|
* Create a new QuickJS [array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array).
|
|
*/
|
|
newArray() {
|
|
const ptr = this.ffi.QTS_NewArray(this.ctx.value);
|
|
return this.memory.heapValueHandle(ptr);
|
|
}
|
|
newPromise(value) {
|
|
const deferredPromise = lifetime_1.Scope.withScope((scope) => {
|
|
const mutablePointerArray = scope.manage(this.memory.newMutablePointerArray(2));
|
|
const promisePtr = this.ffi.QTS_NewPromiseCapability(this.ctx.value, mutablePointerArray.value.ptr);
|
|
const promiseHandle = this.memory.heapValueHandle(promisePtr);
|
|
const [resolveHandle, rejectHandle] = Array.from(mutablePointerArray.value.typedArray).map((jsvaluePtr) => this.memory.heapValueHandle(jsvaluePtr));
|
|
return new deferred_promise_1.QuickJSDeferredPromise({
|
|
context: this,
|
|
promiseHandle,
|
|
resolveHandle,
|
|
rejectHandle,
|
|
});
|
|
});
|
|
if (value && typeof value === "function") {
|
|
value = new Promise(value);
|
|
}
|
|
if (value) {
|
|
Promise.resolve(value).then(deferredPromise.resolve, (error) => error instanceof lifetime_1.Lifetime
|
|
? deferredPromise.reject(error)
|
|
: this.newError(error).consume(deferredPromise.reject));
|
|
}
|
|
return deferredPromise;
|
|
}
|
|
/**
|
|
* Convert a Javascript function into a QuickJS function value.
|
|
* See [[VmFunctionImplementation]] for more details.
|
|
*
|
|
* A [[VmFunctionImplementation]] should not free its arguments or its return
|
|
* value. A VmFunctionImplementation should also not retain any references to
|
|
* its return value.
|
|
*
|
|
* To implement an async function, create a promise with [[newPromise]], then
|
|
* return the deferred promise handle from `deferred.handle` from your
|
|
* function implementation:
|
|
*
|
|
* ```
|
|
* const deferred = vm.newPromise()
|
|
* someNativeAsyncFunction().then(deferred.resolve)
|
|
* return deferred.handle
|
|
* ```
|
|
*/
|
|
newFunction(name, fn) {
|
|
const fnId = ++this.fnNextId;
|
|
this.setFunction(fnId, fn);
|
|
return this.memory.heapValueHandle(this.ffi.QTS_NewFunction(this.ctx.value, fnId, name));
|
|
}
|
|
newError(error) {
|
|
const errorHandle = this.memory.heapValueHandle(this.ffi.QTS_NewError(this.ctx.value));
|
|
if (error && typeof error === "object") {
|
|
if (error.name !== undefined) {
|
|
this.newString(error.name).consume((handle) => this.setProp(errorHandle, "name", handle));
|
|
}
|
|
if (error.message !== undefined) {
|
|
this.newString(error.message).consume((handle) => this.setProp(errorHandle, "message", handle));
|
|
}
|
|
}
|
|
else if (typeof error === "string") {
|
|
this.newString(error).consume((handle) => this.setProp(errorHandle, "message", handle));
|
|
}
|
|
else if (error !== undefined) {
|
|
// This isn't supported in the type signature but maybe it will make life easier.
|
|
this.newString(String(error)).consume((handle) => this.setProp(errorHandle, "message", handle));
|
|
}
|
|
return errorHandle;
|
|
}
|
|
// Read values --------------------------------------------------------------
|
|
/**
|
|
* `typeof` operator. **Not** [standards compliant](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof).
|
|
*
|
|
* @remarks
|
|
* Does not support BigInt values correctly.
|
|
*/
|
|
typeof(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
return this.memory.consumeHeapCharPointer(this.ffi.QTS_Typeof(this.ctx.value, handle.value));
|
|
}
|
|
/**
|
|
* Converts `handle` into a Javascript number.
|
|
* @returns `NaN` on error, otherwise a `number`.
|
|
*/
|
|
getNumber(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
return this.ffi.QTS_GetFloat64(this.ctx.value, handle.value);
|
|
}
|
|
/**
|
|
* Converts `handle` to a Javascript string.
|
|
*/
|
|
getString(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
return this.memory.consumeJSCharPointer(this.ffi.QTS_GetString(this.ctx.value, handle.value));
|
|
}
|
|
/**
|
|
* Converts `handle` into a Javascript symbol. If the symbol is in the global
|
|
* registry in the guest, it will be created with Symbol.for on the host.
|
|
*/
|
|
getSymbol(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
const key = this.memory.consumeJSCharPointer(this.ffi.QTS_GetSymbolDescriptionOrKey(this.ctx.value, handle.value));
|
|
const isGlobal = this.ffi.QTS_IsGlobalSymbol(this.ctx.value, handle.value);
|
|
return isGlobal ? Symbol.for(key) : Symbol(key);
|
|
}
|
|
/**
|
|
* Converts `handle` to a Javascript bigint.
|
|
*/
|
|
getBigInt(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
const asString = this.getString(handle);
|
|
return BigInt(asString);
|
|
}
|
|
/**
|
|
* `Promise.resolve(value)`.
|
|
* Convert a handle containing a Promise-like value inside the VM into an
|
|
* actual promise on the host.
|
|
*
|
|
* @remarks
|
|
* You may need to call [[executePendingJobs]] to ensure that the promise is resolved.
|
|
*
|
|
* @param promiseLikeHandle - A handle to a Promise-like value with a `.then(onSuccess, onError)` method.
|
|
*/
|
|
resolvePromise(promiseLikeHandle) {
|
|
this.runtime.assertOwned(promiseLikeHandle);
|
|
const vmResolveResult = lifetime_1.Scope.withScope((scope) => {
|
|
const vmPromise = scope.manage(this.getProp(this.global, "Promise"));
|
|
const vmPromiseResolve = scope.manage(this.getProp(vmPromise, "resolve"));
|
|
return this.callFunction(vmPromiseResolve, vmPromise, promiseLikeHandle);
|
|
});
|
|
if (vmResolveResult.error) {
|
|
return Promise.resolve(vmResolveResult);
|
|
}
|
|
return new Promise((resolve) => {
|
|
lifetime_1.Scope.withScope((scope) => {
|
|
const resolveHandle = scope.manage(this.newFunction("resolve", (value) => {
|
|
resolve({ value: value && value.dup() });
|
|
}));
|
|
const rejectHandle = scope.manage(this.newFunction("reject", (error) => {
|
|
resolve({ error: error && error.dup() });
|
|
}));
|
|
const promiseHandle = scope.manage(vmResolveResult.value);
|
|
const promiseThenHandle = scope.manage(this.getProp(promiseHandle, "then"));
|
|
this.unwrapResult(this.callFunction(promiseThenHandle, promiseHandle, resolveHandle, rejectHandle)).dispose();
|
|
});
|
|
});
|
|
}
|
|
// Properties ---------------------------------------------------------------
|
|
/**
|
|
* `handle[key]`.
|
|
* Get a property from a JSValue.
|
|
*
|
|
* @param key - The property may be specified as a JSValue handle, or as a
|
|
* Javascript string (which will be converted automatically).
|
|
*/
|
|
getProp(handle, key) {
|
|
this.runtime.assertOwned(handle);
|
|
const ptr = this.borrowPropertyKey(key).consume((quickJSKey) => this.ffi.QTS_GetProp(this.ctx.value, handle.value, quickJSKey.value));
|
|
const result = this.memory.heapValueHandle(ptr);
|
|
return result;
|
|
}
|
|
/**
|
|
* `handle[key] = value`.
|
|
* Set a property on a JSValue.
|
|
*
|
|
* @remarks
|
|
* Note that the QuickJS authors recommend using [[defineProp]] to define new
|
|
* properties.
|
|
*
|
|
* @param key - The property may be specified as a JSValue handle, or as a
|
|
* Javascript string or number (which will be converted automatically to a JSValue).
|
|
*/
|
|
setProp(handle, key, value) {
|
|
this.runtime.assertOwned(handle);
|
|
// free newly allocated value if key was a string or number. No-op if string was already
|
|
// a QuickJS handle.
|
|
this.borrowPropertyKey(key).consume((quickJSKey) => this.ffi.QTS_SetProp(this.ctx.value, handle.value, quickJSKey.value, value.value));
|
|
}
|
|
/**
|
|
* [`Object.defineProperty(handle, key, descriptor)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty).
|
|
*
|
|
* @param key - The property may be specified as a JSValue handle, or as a
|
|
* Javascript string or number (which will be converted automatically to a JSValue).
|
|
*/
|
|
defineProp(handle, key, descriptor) {
|
|
this.runtime.assertOwned(handle);
|
|
lifetime_1.Scope.withScope((scope) => {
|
|
const quickJSKey = scope.manage(this.borrowPropertyKey(key));
|
|
const value = descriptor.value || this.undefined;
|
|
const configurable = Boolean(descriptor.configurable);
|
|
const enumerable = Boolean(descriptor.enumerable);
|
|
const hasValue = Boolean(descriptor.value);
|
|
const get = descriptor.get
|
|
? scope.manage(this.newFunction(descriptor.get.name, descriptor.get))
|
|
: this.undefined;
|
|
const set = descriptor.set
|
|
? scope.manage(this.newFunction(descriptor.set.name, descriptor.set))
|
|
: this.undefined;
|
|
this.ffi.QTS_DefineProp(this.ctx.value, handle.value, quickJSKey.value, value.value, get.value, set.value, configurable, enumerable, hasValue);
|
|
});
|
|
}
|
|
// Evaluation ---------------------------------------------------------------
|
|
/**
|
|
* [`func.call(thisVal, ...args)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call).
|
|
* Call a JSValue as a function.
|
|
*
|
|
* See [[unwrapResult]], which will throw if the function returned an error, or
|
|
* return the result handle directly. If evaluation returned a handle containing
|
|
* a promise, use [[resolvePromise]] to convert it to a native promise and
|
|
* [[executePendingJobs]] to finish evaluating the promise.
|
|
*
|
|
* @returns A result. If the function threw synchronously, `result.error` be a
|
|
* handle to the exception. Otherwise `result.value` will be a handle to the
|
|
* value.
|
|
*/
|
|
callFunction(func, thisVal, ...args) {
|
|
this.runtime.assertOwned(func);
|
|
const resultPtr = this.memory
|
|
.toPointerArray(args)
|
|
.consume((argsArrayPtr) => this.ffi.QTS_Call(this.ctx.value, func.value, thisVal.value, args.length, argsArrayPtr.value));
|
|
const errorPtr = this.ffi.QTS_ResolveException(this.ctx.value, resultPtr);
|
|
if (errorPtr) {
|
|
this.ffi.QTS_FreeValuePointer(this.ctx.value, resultPtr);
|
|
return { error: this.memory.heapValueHandle(errorPtr) };
|
|
}
|
|
return { value: this.memory.heapValueHandle(resultPtr) };
|
|
}
|
|
/**
|
|
* Like [`eval(code)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval#Description).
|
|
* Evaluates the Javascript source `code` in the global scope of this VM.
|
|
* When working with async code, you many need to call [[executePendingJobs]]
|
|
* to execute callbacks pending after synchronous evaluation returns.
|
|
*
|
|
* See [[unwrapResult]], which will throw if the function returned an error, or
|
|
* return the result handle directly. If evaluation returned a handle containing
|
|
* a promise, use [[resolvePromise]] to convert it to a native promise and
|
|
* [[executePendingJobs]] to finish evaluating the promise.
|
|
*
|
|
* *Note*: to protect against infinite loops, provide an interrupt handler to
|
|
* [[setInterruptHandler]]. You can use [[shouldInterruptAfterDeadline]] to
|
|
* create a time-based deadline.
|
|
*
|
|
* @returns The last statement's value. If the code threw synchronously,
|
|
* `result.error` will be a handle to the exception. If execution was
|
|
* interrupted, the error will have name `InternalError` and message
|
|
* `interrupted`.
|
|
*/
|
|
evalCode(code, filename = "eval.js",
|
|
/**
|
|
* If no options are passed, a heuristic will be used to detect if `code` is
|
|
* an ES module.
|
|
*
|
|
* See [[EvalFlags]] for number semantics.
|
|
*/
|
|
options) {
|
|
const detectModule = (options === undefined ? 1 : 0);
|
|
const flags = (0, types_1.evalOptionsToFlags)(options);
|
|
const resultPtr = this.memory
|
|
.newHeapCharPointer(code)
|
|
.consume((charHandle) => this.ffi.QTS_Eval(this.ctx.value, charHandle.value, filename, detectModule, flags));
|
|
const errorPtr = this.ffi.QTS_ResolveException(this.ctx.value, resultPtr);
|
|
if (errorPtr) {
|
|
this.ffi.QTS_FreeValuePointer(this.ctx.value, resultPtr);
|
|
return { error: this.memory.heapValueHandle(errorPtr) };
|
|
}
|
|
return { value: this.memory.heapValueHandle(resultPtr) };
|
|
}
|
|
/**
|
|
* Throw an error in the VM, interrupted whatever current execution is in progress when execution resumes.
|
|
* @experimental
|
|
*/
|
|
throw(error) {
|
|
return this.errorToHandle(error).consume((handle) => this.ffi.QTS_Throw(this.ctx.value, handle.value));
|
|
}
|
|
/**
|
|
* @private
|
|
*/
|
|
borrowPropertyKey(key) {
|
|
if (typeof key === "number") {
|
|
return this.newNumber(key);
|
|
}
|
|
if (typeof key === "string") {
|
|
return this.newString(key);
|
|
}
|
|
// key is already a JSValue, but we're borrowing it. Return a static handle
|
|
// for internal use only.
|
|
return new lifetime_1.StaticLifetime(key.value, this.runtime);
|
|
}
|
|
/**
|
|
* @private
|
|
*/
|
|
getMemory(rt) {
|
|
if (rt === this.rt.value) {
|
|
return this.memory;
|
|
}
|
|
else {
|
|
throw new Error("Private API. Cannot get memory from a different runtime");
|
|
}
|
|
}
|
|
// Utilities ----------------------------------------------------------------
|
|
/**
|
|
* Dump a JSValue to Javascript in a best-effort fashion.
|
|
* Returns `handle.toString()` if it cannot be serialized to JSON.
|
|
*/
|
|
dump(handle) {
|
|
this.runtime.assertOwned(handle);
|
|
const type = this.typeof(handle);
|
|
if (type === "string") {
|
|
return this.getString(handle);
|
|
}
|
|
else if (type === "number") {
|
|
return this.getNumber(handle);
|
|
}
|
|
else if (type === "bigint") {
|
|
return this.getBigInt(handle);
|
|
}
|
|
else if (type === "undefined") {
|
|
return undefined;
|
|
}
|
|
else if (type === "symbol") {
|
|
return this.getSymbol(handle);
|
|
}
|
|
const str = this.memory.consumeJSCharPointer(this.ffi.QTS_Dump(this.ctx.value, handle.value));
|
|
try {
|
|
return JSON.parse(str);
|
|
}
|
|
catch (err) {
|
|
return str;
|
|
}
|
|
}
|
|
/**
|
|
* Unwrap a SuccessOrFail result such as a [[VmCallResult]] or a
|
|
* [[ExecutePendingJobsResult]], where the fail branch contains a handle to a QuickJS error value.
|
|
* If the result is a success, returns the value.
|
|
* If the result is an error, converts the error to a native object and throws the error.
|
|
*/
|
|
unwrapResult(result) {
|
|
if (result.error) {
|
|
const context = "context" in result.error ? result.error.context : this;
|
|
const cause = result.error.consume((error) => this.dump(error));
|
|
if (cause && typeof cause === "object" && typeof cause.message === "string") {
|
|
const { message, name, stack } = cause;
|
|
const exception = new errors_1.QuickJSUnwrapError("");
|
|
const hostStack = exception.stack;
|
|
if (typeof name === "string") {
|
|
exception.name = cause.name;
|
|
}
|
|
if (typeof stack === "string") {
|
|
exception.stack = `${name}: ${message}\n${cause.stack}Host: ${hostStack}`;
|
|
}
|
|
Object.assign(exception, { cause, context, message });
|
|
throw exception;
|
|
}
|
|
throw new errors_1.QuickJSUnwrapError(cause, context);
|
|
}
|
|
return result.value;
|
|
}
|
|
/** @private */
|
|
getFunction(fn_id) {
|
|
const map_id = fn_id >> 8;
|
|
const fnMap = this.fnMaps.get(map_id);
|
|
if (!fnMap) {
|
|
return undefined;
|
|
}
|
|
return fnMap.get(fn_id);
|
|
}
|
|
/** @private */
|
|
setFunction(fn_id, handle) {
|
|
const map_id = fn_id >> 8;
|
|
let fnMap = this.fnMaps.get(map_id);
|
|
if (!fnMap) {
|
|
fnMap = new Map();
|
|
this.fnMaps.set(map_id, fnMap);
|
|
}
|
|
return fnMap.set(fn_id, handle);
|
|
}
|
|
errorToHandle(error) {
|
|
if (error instanceof lifetime_1.Lifetime) {
|
|
return error;
|
|
}
|
|
return this.newError(error);
|
|
}
|
|
}
|
|
exports.QuickJSContext = QuickJSContext;
|
|
//# sourceMappingURL=context.js.map
|