QuickJsRuntime2 class - quickjs_runtime2 library

Constructors

QuickJsRuntime2({_JsModuleHandler? moduleHandler, int stackSize = 1024 * 1024, int? timeout, int? memoryLimit = kDefaultJsMemoryLimit, _JsHostPromiseRejectionHandler? hostPromiseRejectionHandler, bool autoExecutePendingJobs = true, JsWebApis webApis = const JsWebApis()})

Properties

autoExecutePendingJobs ↔ bool: When true (default), evaluate / evaluateJson / callFunction drain Promise microtasks via executePendingJobs after the call.
getter/setter pair
dartContext ↔ Map<String, dynamic>: getter/setter pairinherited
debugReferenceCount → int: no setter
hashCode → int: The hash code for this object.
no setterinherited
hasPendingJobs → bool: True if QuickJS has at least one pending job (Promise reactions, etc.).
no setter
hostPromiseRejectionHandler → _JsHostPromiseRejectionHandler?: Handler function to manage js module.
final
localContext ↔ Map<String, dynamic>: getter/setter pairinherited
memoryLimit → int?: Heap limit bytes (null/0 = unlimited).
final
moduleHandler → _JsModuleHandler?: Handler function to manage js module.
final
port ↔ ReceivePort: Message Port for event loop. Close it to stop dispatching event loop.
getter/setter pair
runtimeType → Type: A representation of the runtime type of the object.
no setterinherited
stackSize ↔ int: Max stack size for quickjs.
getter/setter pair
timeout → int?: Interrupt after this many ms of wall-clock JS work (null/0 = off).
final
webApis → JsWebApis: Web platform APIs installed into every context. See JsWebApis.
final

Methods

callFunction(Pointer<NativeType> fn, Pointer<NativeType> obj) → JsEvalResult: override
close() → void: Free Runtime and Context. After dispose, the engine cannot be reopened. After close without dispose, the next evaluate recreates the engine.
compile(String script, String fileName, {bool stripSource = false, bool asModule = false}) → Uint8List: Compile code to bytecode. stripSource drops function source text: a smaller heap, but Function.prototype.toString no longer shows it.
override
convertValue<T>(JsEvalResult jsValue) → T?: override
createWebNatives() → Object?: Engine-specific native helpers handed to the Web API layer, or null.
override
dispatch() → Future<void>: Dispatch JavaScript Event loop.
dispose() → void: override
disposeChannelFunctions() → void: Removes channel registrations for this engine (call from dispose).
inherited
enableHandlePromises() → void: Available on JavascriptRuntime, provided by the HandlePromises extension
Optional no-op friendly setup for callers that still invoke this.
evaluate(String command, {String? name, int? evalFlags, String? sourceUrl}) → JsEvalResult: Evaluate js script.
override
evaluateAsync(String code, {String? sourceUrl}) → Future<JsEvalResult>: override
evaluateAsyncBytecode(Uint8List bytecode) → Future<JsEvalResult>: override
evaluateBytecode(Uint8List bytecode) → JsEvalResult: override
evaluateJson(String command, {String? sourceUrl}) → dynamic: Evaluate js script and decode the result via a single JSON.stringify round-trip instead of recursive per-element FFI marshaling.
override
evaluateJsonBatch(Iterable<String> expressions, {String? sourceUrl}) → List: Evaluate multiple JavaScript expressions and decode the results through one JSON round-trip. Expressions must be JSON-serializable and are evaluated in order in the same runtime.
inherited
executePendingJob() → int: override
executePendingJobs({int maxJobs = 10000}) → int: Drain the QuickJS job queue until empty or maxJobs jobs run. Returns the number of jobs executed, or stops early on error (-1 job).
inherited
getEngineInstanceId() → String: override
getMemoryUsage() → JsMemoryUsage?: QuickJS heap usage snapshot, or null if unavailable.
override
handlePromise(JsEvalResult value, {Duration? timeout}) → Future<JsEvalResult>: Available on JavascriptRuntime, provided by the HandlePromises extension
init() → JavascriptRuntime: inherited
initChannelFunctions() → void: override
jsonStringify(JsEvalResult jsValue) → String: override
noSuchMethod(Invocation invocation) → dynamic: Invoked when a nonexistent method or property is accessed.
inherited
onMessage(String channelName, dynamic fn(dynamic args)) → void: inherited
registerModuleBytecode(Uint8List bytecode, {bool resolve = false}) → void: Register module bytecode in the current context without running it. See JavascriptRuntime.registerModuleBytecode.
override
reinitialize() → void: Drop native heap + channels and re-run init (bridges, Web APIs). Used by JsEnginePool when EngineResetMode.hard / resetOnRelease: true.
override
releaseHostCaches() → void: Free Dart-side JS refs that must not outlive close; call before native free. Cancels Web API timers and host work installed by init.
inherited
runGC() → void: Force a QuickJS GC pass. No-op if the engine is not ready / disposed.
override
sendMessage({required String channelName, required List<String> args, String? uuid}) → void: Dart → JS message helper. Prefer not to inject untrusted strings into evaluate; use registered bridges + sendMessage from JS instead.
inherited
setInspectable(bool inspectable) → void: override
setupBridge(String channelName, void fn(dynamic args)) → bool: override
softReset() → void: Wipe tenant state while keeping the same native runtime and instance id. Used by JsEnginePool with EngineResetMode.soft.
override
toString() → String: A string representation of this object.
inherited

Operators

operator ==(Object other) → bool: The equality operator.
inherited