mirror of
https://github.com/hanzoai/quickjs-emscripten.git
synced 2026-10-30 19:37:29 +00:00
* Actually clean up functions after disposed * update vscode settings * new HostRef system for handling functions & generic host references * tests * HostRef * document why returning raw JS_EXCEPTION is valid here * fix ref * bugfixes * dont leak HostRef instance * fix double-free * doc * prettier * FIX MEasdfasdf * update docs
444 lines
13 KiB
TypeScript
444 lines
13 KiB
TypeScript
// This file generated by "generate.ts ffi" in the root of the repo.
|
|
import {
|
|
QuickJSEmscriptenModule,
|
|
JSRuntimePointer,
|
|
JSContextPointer,
|
|
JSContextPointerPointer,
|
|
JSModuleDefPointer,
|
|
JSValuePointer,
|
|
JSValueConstPointer,
|
|
JSValuePointerPointer,
|
|
JSValuePointerPointerPointer,
|
|
JSValueConstPointerPointer,
|
|
QTS_C_To_HostCallbackFuncPointer,
|
|
QTS_C_To_HostInterruptFuncPointer,
|
|
QTS_C_To_HostLoadModuleFuncPointer,
|
|
BorrowedHeapCharPointer,
|
|
OwnedHeapCharPointer,
|
|
JSBorrowedCharPointer,
|
|
JSVoidPointer,
|
|
UInt32Pointer,
|
|
EvalFlags,
|
|
IntrinsicsFlags,
|
|
EvalDetectModule,
|
|
GetOwnPropertyNamesFlags,
|
|
IsEqualOp,
|
|
HostRefId,
|
|
JSPromiseStateEnum,
|
|
} from "@jitl/quickjs-ffi-types"
|
|
|
|
/**
|
|
* Low-level FFI bindings to QuickJS's Emscripten module.
|
|
* See instead {@link QuickJSContext}, the public Javascript interface exposed by this
|
|
* library.
|
|
*
|
|
* @unstable The FFI interface is considered private and may change.
|
|
*/
|
|
export class QuickJSFFI {
|
|
constructor(private module: QuickJSEmscriptenModule) {}
|
|
/** Set at compile time. */
|
|
readonly DEBUG = false
|
|
|
|
QTS_Throw: (
|
|
ctx: JSContextPointer,
|
|
error: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_Throw", "number", ["number", "number"])
|
|
|
|
QTS_NewError: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
|
|
"QTS_NewError",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_RuntimeSetMemoryLimit: (rt: JSRuntimePointer, limit: number) => void = this.module.cwrap(
|
|
"QTS_RuntimeSetMemoryLimit",
|
|
null,
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_RuntimeComputeMemoryUsage: (rt: JSRuntimePointer, ctx: JSContextPointer) => JSValuePointer =
|
|
this.module.cwrap("QTS_RuntimeComputeMemoryUsage", "number", ["number", "number"])
|
|
|
|
QTS_RuntimeDumpMemoryUsage: (rt: JSRuntimePointer) => OwnedHeapCharPointer = this.module.cwrap(
|
|
"QTS_RuntimeDumpMemoryUsage",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_RecoverableLeakCheck: () => number = this.module.cwrap(
|
|
"QTS_RecoverableLeakCheck",
|
|
"number",
|
|
[],
|
|
)
|
|
|
|
QTS_BuildIsSanitizeLeak: () => number = this.module.cwrap("QTS_BuildIsSanitizeLeak", "number", [])
|
|
|
|
QTS_RuntimeSetMaxStackSize: (rt: JSRuntimePointer, stack_size: number) => void =
|
|
this.module.cwrap("QTS_RuntimeSetMaxStackSize", null, ["number", "number"])
|
|
|
|
QTS_GetUndefined: () => JSValueConstPointer = this.module.cwrap("QTS_GetUndefined", "number", [])
|
|
|
|
QTS_GetNull: () => JSValueConstPointer = this.module.cwrap("QTS_GetNull", "number", [])
|
|
|
|
QTS_GetFalse: () => JSValueConstPointer = this.module.cwrap("QTS_GetFalse", "number", [])
|
|
|
|
QTS_GetTrue: () => JSValueConstPointer = this.module.cwrap("QTS_GetTrue", "number", [])
|
|
|
|
QTS_NewHostRef: (ctx: JSContextPointer, id: HostRefId) => JSValuePointer = this.module.cwrap(
|
|
"QTS_NewHostRef",
|
|
"number",
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_GetHostRefId: (value: JSValuePointer | JSValueConstPointer) => HostRefId = this.module.cwrap(
|
|
"QTS_GetHostRefId",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_NewRuntime: () => JSRuntimePointer = this.module.cwrap("QTS_NewRuntime", "number", [])
|
|
|
|
QTS_FreeRuntime: (rt: JSRuntimePointer) => void = this.module.cwrap("QTS_FreeRuntime", null, [
|
|
"number",
|
|
])
|
|
|
|
QTS_NewContext: (rt: JSRuntimePointer, intrinsics: IntrinsicsFlags) => JSContextPointer =
|
|
this.module.cwrap("QTS_NewContext", "number", ["number", "number"])
|
|
|
|
QTS_FreeContext: (ctx: JSContextPointer) => void = this.module.cwrap("QTS_FreeContext", null, [
|
|
"number",
|
|
])
|
|
|
|
QTS_FreeValuePointer: (ctx: JSContextPointer, value: JSValuePointer) => void = this.module.cwrap(
|
|
"QTS_FreeValuePointer",
|
|
null,
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_FreeValuePointerRuntime: (rt: JSRuntimePointer, value: JSValuePointer) => void =
|
|
this.module.cwrap("QTS_FreeValuePointerRuntime", null, ["number", "number"])
|
|
|
|
QTS_FreeVoidPointer: (ctx: JSContextPointer, ptr: JSVoidPointer) => void = this.module.cwrap(
|
|
"QTS_FreeVoidPointer",
|
|
null,
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_FreeCString: (ctx: JSContextPointer, str: JSBorrowedCharPointer) => void = this.module.cwrap(
|
|
"QTS_FreeCString",
|
|
null,
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_DupValuePointer: (
|
|
ctx: JSContextPointer,
|
|
val: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_DupValuePointer", "number", ["number", "number"])
|
|
|
|
QTS_NewObject: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
|
|
"QTS_NewObject",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_NewObjectProto: (
|
|
ctx: JSContextPointer,
|
|
proto: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_NewObjectProto", "number", ["number", "number"])
|
|
|
|
QTS_NewArray: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
|
|
"QTS_NewArray",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_NewArrayBuffer: (
|
|
ctx: JSContextPointer,
|
|
buffer: JSVoidPointer,
|
|
length: number,
|
|
) => JSValuePointer = this.module.cwrap("QTS_NewArrayBuffer", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_NewFloat64: (ctx: JSContextPointer, num: number) => JSValuePointer = this.module.cwrap(
|
|
"QTS_NewFloat64",
|
|
"number",
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_GetFloat64: (ctx: JSContextPointer, value: JSValuePointer | JSValueConstPointer) => number =
|
|
this.module.cwrap("QTS_GetFloat64", "number", ["number", "number"])
|
|
|
|
QTS_NewString: (ctx: JSContextPointer, string: BorrowedHeapCharPointer) => JSValuePointer =
|
|
this.module.cwrap("QTS_NewString", "number", ["number", "number"])
|
|
|
|
QTS_GetString: (
|
|
ctx: JSContextPointer,
|
|
value: JSValuePointer | JSValueConstPointer,
|
|
) => JSBorrowedCharPointer = this.module.cwrap("QTS_GetString", "number", ["number", "number"])
|
|
|
|
QTS_GetArrayBuffer: (
|
|
ctx: JSContextPointer,
|
|
data: JSValuePointer | JSValueConstPointer,
|
|
) => JSVoidPointer = this.module.cwrap("QTS_GetArrayBuffer", "number", ["number", "number"])
|
|
|
|
QTS_GetArrayBufferLength: (
|
|
ctx: JSContextPointer,
|
|
data: JSValuePointer | JSValueConstPointer,
|
|
) => number = this.module.cwrap("QTS_GetArrayBufferLength", "number", ["number", "number"])
|
|
|
|
QTS_NewSymbol: (
|
|
ctx: JSContextPointer,
|
|
description: BorrowedHeapCharPointer,
|
|
isGlobal: number,
|
|
) => JSValuePointer = this.module.cwrap("QTS_NewSymbol", "number", ["number", "number", "number"])
|
|
|
|
QTS_GetSymbolDescriptionOrKey: (
|
|
ctx: JSContextPointer,
|
|
value: JSValuePointer | JSValueConstPointer,
|
|
) => JSBorrowedCharPointer = this.module.cwrap("QTS_GetSymbolDescriptionOrKey", "number", [
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_IsGlobalSymbol: (
|
|
ctx: JSContextPointer,
|
|
value: JSValuePointer | JSValueConstPointer,
|
|
) => number = this.module.cwrap("QTS_IsGlobalSymbol", "number", ["number", "number"])
|
|
|
|
QTS_IsJobPending: (rt: JSRuntimePointer) => number = this.module.cwrap(
|
|
"QTS_IsJobPending",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_ExecutePendingJob: (
|
|
rt: JSRuntimePointer,
|
|
maxJobsToExecute: number,
|
|
lastJobContext: JSContextPointerPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_ExecutePendingJob", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_GetProp: (
|
|
ctx: JSContextPointer,
|
|
this_val: JSValuePointer | JSValueConstPointer,
|
|
prop_name: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_GetProp", "number", ["number", "number", "number"])
|
|
|
|
QTS_GetPropNumber: (
|
|
ctx: JSContextPointer,
|
|
this_val: JSValuePointer | JSValueConstPointer,
|
|
prop_name: number,
|
|
) => JSValuePointer = this.module.cwrap("QTS_GetPropNumber", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_SetProp: (
|
|
ctx: JSContextPointer,
|
|
this_val: JSValuePointer | JSValueConstPointer,
|
|
prop_name: JSValuePointer | JSValueConstPointer,
|
|
prop_value: JSValuePointer | JSValueConstPointer,
|
|
) => void = this.module.cwrap("QTS_SetProp", null, ["number", "number", "number", "number"])
|
|
|
|
QTS_DefineProp: (
|
|
ctx: JSContextPointer,
|
|
this_val: JSValuePointer | JSValueConstPointer,
|
|
prop_name: JSValuePointer | JSValueConstPointer,
|
|
prop_value: JSValuePointer | JSValueConstPointer,
|
|
get: JSValuePointer | JSValueConstPointer,
|
|
set: JSValuePointer | JSValueConstPointer,
|
|
configurable: boolean,
|
|
enumerable: boolean,
|
|
has_value: boolean,
|
|
) => void = this.module.cwrap("QTS_DefineProp", null, [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"boolean",
|
|
"boolean",
|
|
"boolean",
|
|
])
|
|
|
|
QTS_GetOwnPropertyNames: (
|
|
ctx: JSContextPointer,
|
|
out_ptrs: JSValuePointerPointerPointer,
|
|
out_len: UInt32Pointer,
|
|
obj: JSValuePointer | JSValueConstPointer,
|
|
flags: number,
|
|
) => JSValuePointer = this.module.cwrap("QTS_GetOwnPropertyNames", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_Call: (
|
|
ctx: JSContextPointer,
|
|
func_obj: JSValuePointer | JSValueConstPointer,
|
|
this_obj: JSValuePointer | JSValueConstPointer,
|
|
argc: number,
|
|
argv_ptrs: JSValueConstPointerPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_Call", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_ResolveException: (ctx: JSContextPointer, maybe_exception: JSValuePointer) => JSValuePointer =
|
|
this.module.cwrap("QTS_ResolveException", "number", ["number", "number"])
|
|
|
|
QTS_Dump: (
|
|
ctx: JSContextPointer,
|
|
obj: JSValuePointer | JSValueConstPointer,
|
|
) => JSBorrowedCharPointer = this.module.cwrap("QTS_Dump", "number", ["number", "number"])
|
|
|
|
QTS_Eval: (
|
|
ctx: JSContextPointer,
|
|
js_code: BorrowedHeapCharPointer,
|
|
js_code_length: number,
|
|
filename: string,
|
|
detectModule: EvalDetectModule,
|
|
evalFlags: EvalFlags,
|
|
) => JSValuePointer = this.module.cwrap("QTS_Eval", "number", [
|
|
"number",
|
|
"number",
|
|
"number",
|
|
"string",
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_GetModuleNamespace: (
|
|
ctx: JSContextPointer,
|
|
module_func_obj: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_GetModuleNamespace", "number", ["number", "number"])
|
|
|
|
QTS_Typeof: (
|
|
ctx: JSContextPointer,
|
|
value: JSValuePointer | JSValueConstPointer,
|
|
) => OwnedHeapCharPointer = this.module.cwrap("QTS_Typeof", "number", ["number", "number"])
|
|
|
|
QTS_GetLength: (
|
|
ctx: JSContextPointer,
|
|
out_len: UInt32Pointer,
|
|
value: JSValuePointer | JSValueConstPointer,
|
|
) => number = this.module.cwrap("QTS_GetLength", "number", ["number", "number", "number"])
|
|
|
|
QTS_IsEqual: (
|
|
ctx: JSContextPointer,
|
|
a: JSValuePointer | JSValueConstPointer,
|
|
b: JSValuePointer | JSValueConstPointer,
|
|
op: IsEqualOp,
|
|
) => number = this.module.cwrap("QTS_IsEqual", "number", ["number", "number", "number", "number"])
|
|
|
|
QTS_GetGlobalObject: (ctx: JSContextPointer) => JSValuePointer = this.module.cwrap(
|
|
"QTS_GetGlobalObject",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_NewPromiseCapability: (
|
|
ctx: JSContextPointer,
|
|
resolve_funcs_out: JSValuePointerPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_NewPromiseCapability", "number", [
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_PromiseState: (
|
|
ctx: JSContextPointer,
|
|
promise: JSValuePointer | JSValueConstPointer,
|
|
) => JSPromiseStateEnum = this.module.cwrap("QTS_PromiseState", "number", ["number", "number"])
|
|
|
|
QTS_PromiseResult: (
|
|
ctx: JSContextPointer,
|
|
promise: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_PromiseResult", "number", ["number", "number"])
|
|
|
|
QTS_TestStringArg: (string: string) => void = this.module.cwrap("QTS_TestStringArg", null, [
|
|
"string",
|
|
])
|
|
|
|
QTS_GetDebugLogEnabled: (rt: JSRuntimePointer) => number = this.module.cwrap(
|
|
"QTS_GetDebugLogEnabled",
|
|
"number",
|
|
["number"],
|
|
)
|
|
|
|
QTS_SetDebugLogEnabled: (rt: JSRuntimePointer, is_enabled: number) => void = this.module.cwrap(
|
|
"QTS_SetDebugLogEnabled",
|
|
null,
|
|
["number", "number"],
|
|
)
|
|
|
|
QTS_BuildIsDebug: () => number = this.module.cwrap("QTS_BuildIsDebug", "number", [])
|
|
|
|
QTS_BuildIsAsyncify: () => number = this.module.cwrap("QTS_BuildIsAsyncify", "number", [])
|
|
|
|
QTS_NewFunction: (
|
|
ctx: JSContextPointer,
|
|
name: string,
|
|
arg_length: number,
|
|
is_constructor: boolean,
|
|
host_ref_id: HostRefId,
|
|
) => JSValuePointer = this.module.cwrap("QTS_NewFunction", "number", [
|
|
"number",
|
|
"string",
|
|
"number",
|
|
"boolean",
|
|
"number",
|
|
])
|
|
|
|
QTS_ArgvGetJSValueConstPointer: (
|
|
argv: JSValuePointer | JSValueConstPointer,
|
|
index: number,
|
|
) => JSValueConstPointer = this.module.cwrap("QTS_ArgvGetJSValueConstPointer", "number", [
|
|
"number",
|
|
"number",
|
|
])
|
|
|
|
QTS_RuntimeEnableInterruptHandler: (rt: JSRuntimePointer) => void = this.module.cwrap(
|
|
"QTS_RuntimeEnableInterruptHandler",
|
|
null,
|
|
["number"],
|
|
)
|
|
|
|
QTS_RuntimeDisableInterruptHandler: (rt: JSRuntimePointer) => void = this.module.cwrap(
|
|
"QTS_RuntimeDisableInterruptHandler",
|
|
null,
|
|
["number"],
|
|
)
|
|
|
|
QTS_RuntimeEnableModuleLoader: (rt: JSRuntimePointer, use_custom_normalize: number) => void =
|
|
this.module.cwrap("QTS_RuntimeEnableModuleLoader", null, ["number", "number"])
|
|
|
|
QTS_RuntimeDisableModuleLoader: (rt: JSRuntimePointer) => void = this.module.cwrap(
|
|
"QTS_RuntimeDisableModuleLoader",
|
|
null,
|
|
["number"],
|
|
)
|
|
|
|
QTS_bjson_encode: (
|
|
ctx: JSContextPointer,
|
|
val: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_bjson_encode", "number", ["number", "number"])
|
|
|
|
QTS_bjson_decode: (
|
|
ctx: JSContextPointer,
|
|
data: JSValuePointer | JSValueConstPointer,
|
|
) => JSValuePointer = this.module.cwrap("QTS_bjson_decode", "number", ["number", "number"])
|
|
}
|