v8
8.6.395 (node 15.0.1)
V8 is Google's open source JavaScript engine
|
#include <v8.h>
Public Types | |
enum | Status { kUninstantiated , kInstantiating , kInstantiated , kEvaluating , kEvaluated , kErrored } |
typedef MaybeLocal< Module >(* | ResolveCallback) (Local< Context > context, Local< String > specifier, Local< Module > referrer) |
typedef MaybeLocal< Value >(* | SyntheticModuleEvaluationSteps) (Local< Context > context, Local< Module > module) |
Static Public Member Functions | |
static Local< Module > | CreateSyntheticModule (Isolate *isolate, Local< String > module_name, const std::vector< Local< String >> &export_names, SyntheticModuleEvaluationSteps evaluation_steps) |
Data Fields | |
Local< Value > | export_value |
enum Status |
|
static |
Creates a new SyntheticModule with the specified export names, where evaluation_steps will be executed upon module evaluation. export_names must not contain duplicates. module_name is used solely for logging/debugging and doesn't affect module behavior.
V8_WARN_UNUSED_RESULT MaybeLocal<Value> Evaluate | ( | Local< Context > | context | ) |
Evaluates the module and its dependencies.
If status is kInstantiated, run the module's code. On success, set status to kEvaluated and return the completion value; on failure, set status to kErrored and propagate the thrown exception (which is then also available via |GetException|).
For a module in kErrored status, this returns the corresponding exception.
int GetIdentityHash | ( | ) | const |
Returns the identity hash for this object.
Returns the namespace object of this module.
The module's status must be at least kInstantiated.
Returns the ith module specifier in this module. i must be < GetModuleRequestsLength() and >= 0.
Location GetModuleRequestLocation | ( | int | i | ) | const |
Returns the source location (line number and column number) of the ith module specifier's first occurrence in this module.
int GetModuleRequestsLength | ( | ) | const |
Returns the number of modules requested by this module.
Status GetStatus | ( | ) | const |
Returns the module's current status.
Local<UnboundModuleScript> GetUnboundModuleScript | ( | ) |
Returns the corresponding context-unbound module script.
The module must be unevaluated, i.e. its status must not be kEvaluating, kEvaluated or kErrored.
V8_WARN_UNUSED_RESULT Maybe<bool> InstantiateModule | ( | Local< Context > | context, |
ResolveCallback | callback | ||
) |
Instantiates the module and its dependencies.
Returns an empty Maybe<bool> if an exception occurred during instantiation. (In the case where the callback throws an exception, that exception is propagated.)
bool IsSourceTextModule | ( | ) | const |
Returns whether the module is a SourceTextModule.
bool IsSyntheticModule | ( | ) | const |
Returns whether the module is a SyntheticModule.
int ScriptId | ( | ) |
Returns the underlying script's id.
The module must be a SourceTextModule and must not have a kErrored status.
V8_WARN_UNUSED_RESULT Maybe<bool> SetSyntheticModuleExport | ( | Isolate * | isolate, |
Local< String > | export_name, | ||
Local< Value > | export_value | ||
) |
Set this module's exported value for the name export_name to the specified export_value. This method must be called only on Modules created via CreateSyntheticModule. An error will be thrown if export_name is not one of the export_names that were passed in that CreateSyntheticModule call. Returns Just(true) on success, Nothing<bool>() if an error was thrown.
V8_DEPRECATE_SOON | ( | "Use the preceding SetSyntheticModuleExport with an Isolate | parameter, |
" "instead of the one that follows. The former will throw a runtime " "error if called for an export that doesn 't exist(as per spec);" "the latter will crash with a failed CHECK()." | |||
) |