JavaScriptBridge

public static JavaScriptBridgeInstance Singleton { get; }

Engine-owned JavaScriptBridge object. Do not create another instance or Free/Dispose it. Desktop singleton availability does not establish browser support: methods may be stubs. Distinct from your own RefCounted wrappers returned by GetInterface/CreateCallback.

public static JavaScriptObject CreateCallback(Callable callable);

Creates a RefCounted JavaScriptObject function from a Callable accepting one engine Array containing all JS arguments. Retain its wrapper through subscription/waiting and stop external delivery before releasing it. Not GetInterface. Current native code does not forward the Callable return value to JS; threaded proxy may defer delivery. Null outside Web/without javascript_eval.

public static Variant CreateObject(string @object, params Variant[] args);

Calls new windowname, returning a Variant containing the new JS-object wrapper. Exact name, not a dotted path; the page constructor must be ready. Constructor absence/failure can produce an empty result with diagnostics. Does not promise arbitrary engine-collection conversion; use supported scalar/wrapper values. Stub outside Web/without javascript_eval.

public static Variant CreateObject(string @object, ReadOnlySpan<Variant> args);

Calls new windowname, returning a Variant containing the new JS-object wrapper. Exact name, not a dotted path; the page constructor must be ready. Constructor absence/failure can produce an empty result with diagnostics. Does not promise arbitrary engine-collection conversion; use supported scalar/wrapper values. Stub outside Web/without javascript_eval.

public static void DownloadBuffer(byte[] buffer, string name, string mime = "application/octet-stream");

Requests a browser download of copied bytes through a Blob and temporary link. Returns no disk-save confirmation, exports no project and does not synchronize user://. Does nothing outside Web. Check the actual file and browser policy; MIME labels content without converting bytes.

public static void DownloadBuffer(ReadOnlySpan<byte> buffer, string name, string mime);

Requests a browser download of copied bytes through a Blob and temporary link. Returns no disk-save confirmation, exports no project and does not synchronize user://. Does nothing outside Web. Check the actual file and browser policy; MIME labels content without converting bytes.

public static Variant Eval(string code, bool useGlobalExecutionContext = false);

Executes JS code, using local execution context by default. JS numbers return a floating Variant; strings and byte buffers have dedicated paths, ordinary objects/functions return nil. Exceptions are logged and can also yield nil. DataView/non-Uint8Array views currently copy the whole backing buffer: normalize with copyViewBytes first. A JS bool tag exists but C++ returns a uint32 field into Variant; native bool fidelity is unverified. Nil outside Web/without javascript_eval.

public static void ForceFsSync();

Marks the filesystem for later synchronization when browser persistence is available. Void method: does not await writeback, confirm durability or initiate a download. Does nothing outside Web. A successful virtual-FS write and completed IndexedDB persistence are separate states.

public static JavaScriptObject GetInterface(string @interface);

Gets a new wrapper for exact window[name]. Does not interpret app.sdk as a path; expose an explicit page-global adapter and wait for readiness. A missing Web name gives native error/null; null outside Web or without javascript_eval. The wrapper is a RefCounted handle: releasing your own reference does not delete the global JS object. Do not release the bridge singleton.

public static bool IsJsBuffer(JavaScriptObject javascriptObject);

Checks whether a JavaScriptObject is an ArrayBuffer or ArrayBuffer view. False for null and outside Web/without javascript_eval. True validates neither expected length/format nor view-range preservation: current DataView/nonbyte copy paths may include the entire backing buffer.

public static byte[] JsBufferToPackedByteArray(JavaScriptObject javascriptBuffer);

Copies a JavaScript buffer into a new byte[]. Checks IsJsBuffer first; invalid input emits a native error and gives an empty array. DataView/non-Uint8Array views currently expand to their whole backing ArrayBuffer without offset/length. Supply a fresh Uint8Array for the intended range, for example the guide’s copyViewBytes result. Copy, not shared memory or JS-buffer ownership transfer.

public static bool PwaNeedsUpdate();

Reads the cached OS waiting-PWA-update flag; false outside Web. Performs no network/version check and does not establish that registration still has a waiting update. True is set by the service-worker notification path; verify update application separately.

public static Error PwaUpdate();

Requests an update from the waiting service worker. On Web the bridge asynchronously gets registration and sends waiting.postMessage("update"). Ok means the synchronous bridge accepted a request, not completed installation/reload; registration may no longer have waiting. Save state first. Unavailable outside Web; the actual PWA workflow was not executed here.

public static event Action PwaUpdateAvailable;

Parameterless notification that a PWA update is waiting; native code sets the waiting flag first. Not an engine-release notification or proof of installed update. Save state and decide when to call PwaUpdate; avoid unconditionally reloading unfinished gameplay.