Skip to main content

Function: createPointer()

createPointer(value): NativePointer | null

Rebuild a NativePointer from a raw address obtained via NativePointer.value. The argument must be a bigint (a number is rejected — it cannot represent every 64-bit address exactly); 0n returns null, matching how null pointers are represented.

The main use is moving a pointer to a Worker: postMessage(p.value), then createPointer(addr) on the receiving thread. See NativePointer.value for why this is valid and for the lifetime and thread-safety caveats — this fabricates a pointer from an arbitrary integer, so dereferencing a bogus address is undefined behaviour.

Parameters​

value​

bigint

Returns​

NativePointer | null