v8 12.4.254 (node 22.4.1)
V8 is Google's open source JavaScript engine
|
#include <v8-wasm.h>
Public Member Functions | |
WasmStreaming (std::unique_ptr< WasmStreamingImpl > impl) | |
~WasmStreaming () | |
void | OnBytesReceived (const uint8_t *bytes, size_t size) |
void | Finish (bool can_use_compiled_module=true) |
void | Abort (MaybeLocal< Value > exception) |
bool | SetCompiledModuleBytes (const uint8_t *bytes, size_t size) |
void | SetMoreFunctionsCanBeSerializedCallback (std::function< void(CompiledWasmModule)>) |
void | SetUrl (const char *url, size_t length) |
Static Public Member Functions | |
static std::shared_ptr< WasmStreaming > | Unpack (Isolate *isolate, Local< Value > value) |
The V8 interface for WebAssembly streaming compilation. When streaming compilation is initiated, V8 passes a {WasmStreaming} object to the embedder such that the embedder can pass the input bytes for streaming compilation to V8.
|
explicit |
~WasmStreaming | ( | ) |
void Abort | ( | MaybeLocal< Value > | exception | ) |
Abort streaming compilation. If {exception} has a value, then the promise associated with streaming compilation is rejected with that value. If {exception} does not have value, the promise does not get rejected. {Abort} must not be called repeatedly, or after {Finish}.
void Finish | ( | bool | can_use_compiled_module = true | ) |
{Finish} should be called after all received bytes where passed to {OnBytesReceived} to tell V8 that there will be no more bytes. {Finish} must not be called after {Abort} has been called already. If {can_use_compiled_module} is true and {SetCompiledModuleBytes} was previously called, the compiled module bytes can be used. If {can_use_compiled_module} is false, the compiled module bytes previously set by {SetCompiledModuleBytes} should not be used.
void OnBytesReceived | ( | const uint8_t * | bytes, |
size_t | size | ||
) |
Pass a new chunk of bytes to WebAssembly streaming compilation. The buffer passed into {OnBytesReceived} is owned by the caller.
bool SetCompiledModuleBytes | ( | const uint8_t * | bytes, |
size_t | size | ||
) |
Passes previously compiled module bytes. This must be called before {OnBytesReceived}, {Finish}, or {Abort}. Returns true if the module bytes can be used, false otherwise. The buffer passed via {bytes} and {size} is owned by the caller. If {SetCompiledModuleBytes} returns true, the buffer must remain valid until either {Finish} or {Abort} completes. The compiled module bytes should not be used until {Finish(true)} is called, because they can be invalidated later by {Finish(false)}.
void SetMoreFunctionsCanBeSerializedCallback | ( | std::function< void(CompiledWasmModule)> | ) |
Sets a callback which is called whenever a significant number of new functions are ready for serialization.
void SetUrl | ( | const char * | url, |
size_t | length | ||
) |
|
static |
Unpacks a {WasmStreaming} object wrapped in a {Managed} for the embedder. Since the embedder is on the other side of the API, it cannot unpack the {Managed} itself.