v8::Module Class Reference

#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)

Public Member Functions
Status	GetStatus () const
Local< Value >	GetException () const
int	GetModuleRequestsLength () const
Local< String >	GetModuleRequest (int i) const
Location	GetModuleRequestLocation (int i) const
int	GetIdentityHash () const
V8_WARN_UNUSED_RESULT Maybe< bool >	InstantiateModule (Local< Context > context, ResolveCallback callback)
V8_WARN_UNUSED_RESULT MaybeLocal< Value >	Evaluate (Local< Context > context)
Local< Value >	GetModuleNamespace ()
Local< UnboundModuleScript >	GetUnboundModuleScript ()

Detailed Description

A compiled JavaScript module.

Member Enumeration Documentation

Status

enum v8::Module::Status

The different states a module can be in.

This corresponds to the states used in ECMAScript except that "evaluated" is split into kEvaluated and kErrored, indicating success and failure, respectively.

Member Function Documentation

Evaluate()

V8_WARN_UNUSED_RESULT MaybeLocal<Value> v8::Module::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|).

GetException()

Local<Value> v8::Module::GetException

(

)

const

For a module in kErrored status, this returns the corresponding exception.

GetIdentityHash()

int v8::Module::GetIdentityHash

(

)

const

Returns the identity hash for this object.

GetModuleNamespace()

Local<Value> v8::Module::GetModuleNamespace

(

)

Returns the namespace object of this module.

The module's status must be at least kInstantiated.

GetModuleRequest()

Local<String> v8::Module::GetModuleRequest

(

int

i

)

const

Returns the ith module specifier in this module. i must be < GetModuleRequestsLength() and >= 0.

GetModuleRequestLocation()

Location v8::Module::GetModuleRequestLocation

(

int

i

)

const

Returns the source location (line number and column number) of the ith module specifier's first occurrence in this module.

GetModuleRequestsLength()

int v8::Module::GetModuleRequestsLength

(

)

const

Returns the number of modules requested by this module.

GetStatus()

Status v8::Module::GetStatus

(

)

const

Returns the module's current status.

GetUnboundModuleScript()

Local<UnboundModuleScript> v8::Module::GetUnboundModuleScript

(

)

Returns the corresponding context-unbound module script.

The module must be unevaluated, i.e. its status must not be kEvaluating, kEvaluated or kErrored.

InstantiateModule()

V8_WARN_UNUSED_RESULT Maybe<bool> v8::Module::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.)

---

The documentation for this class was generated from the following file:

• v8/include/v8.h