Namespaces
	base

	debug

	internal

	metrics

	platform

Data Structures
class	JSMember

class	JSVisitor

class	CTypeInfo

class	CFunctionInfo

struct	ApiObject

class	CFunction

class	Task

class	IdleTask

class	TaskRunner

class	JobDelegate

class	JobHandle

class	JobTask

class	ConvertableToTraceFormat

class	TracingController

class	PageAllocator

class	Platform

struct	CpuProfileDeoptFrame

struct	CpuProfileDeoptInfo

class	CpuProfileNode

class	CpuProfile

class	CpuProfilingOptions

class	CpuProfiler

class	HeapGraphEdge

class	HeapGraphNode

class	OutputStream

class	HeapSnapshot

class	ActivityControl

class	AllocationProfile

class	EmbedderGraph

class	HeapProfiler

struct	HeapStatsUpdate

class	CodeEvent

class	CodeEventHandler

class	StdMapTraits

class	DefaultPersistentValueMapTraits

class	DefaultGlobalMapTraits

class	PersistentValueMapBase

class	PersistentValueMap

class	GlobalValueMap

class	StdPersistentValueMap

class	StdGlobalValueMap

class	DefaultPersistentValueVectorTraits

class	PersistentValueVector

class	Maybe

class	Local

class	MaybeLocal

class	Eternal

class	NonCopyablePersistentTraits

class	PersistentBase

class	Persistent

class	Global

class	TracedGlobal

class	TracedReference

class	TracedReferenceBase

class	WeakCallbackObject

class	FunctionCallbackInfo

class	PropertyCallbackInfo

class	ReturnValue

class	WeakCallbackInfo

struct	CopyablePersistentTraits

struct	TracedGlobalTrait

class	HandleScope

class	EscapableHandleScope

class	SealHandleScope

class	Data

class	ScriptOrModule

class	PrimitiveArray

class	ScriptOriginOptions

class	ScriptOrigin

class	UnboundScript

class	UnboundModuleScript

class	Location

class	Module

class	Script

class	ScriptCompiler

class	Message

class	StackTrace

class	StackFrame

struct	RegisterState

struct	SampleInfo

struct	MemoryRange

struct	JSEntryStub

struct	UnwindState

struct	JSEntryStubs

class	JSON

class	ValueSerializer

class	ValueDeserializer

class	Value

class	Primitive

class	Boolean

class	Name

class	String

class	Symbol

class	Private

class	Number

class	Integer

class	Int32

class	Uint32

class	BigInt

class	Object

class	Array

class	Map

class	Set

class	Function

class	Promise

class	PropertyDescriptor

class	Proxy

class	MemorySpan

struct	OwnedBuffer

class	CompiledWasmModule

class	WasmModuleObject

class	WasmStreaming

class	WasmModuleObjectBuilderStreaming

class	BackingStore

class	ArrayBuffer

class	ArrayBufferView

class	TypedArray

class	Uint8Array

class	Uint8ClampedArray

class	Int8Array

class	Uint16Array

class	Int16Array

class	Uint32Array

class	Int32Array

class	Float32Array

class	Float64Array

class	BigInt64Array

class	BigUint64Array

class	DataView

class	SharedArrayBuffer

class	Date

class	NumberObject

class	BigIntObject

class	BooleanObject

class	StringObject

class	SymbolObject

class	RegExp

class	External

class	Template

class	FunctionTemplate

struct	NamedPropertyHandlerConfiguration

struct	IndexedPropertyHandlerConfiguration

class	ObjectTemplate

class	Signature

class	AccessorSignature

class	Extension

class	ResourceConstraints

class	Exception

class	PromiseRejectMessage

class	MicrotaskQueue

class	MicrotasksScope

struct	ModifyCodeGenerationFromStringsResult

class	SharedMemoryStatistics

class	HeapStatistics

class	HeapSpaceStatistics

class	HeapObjectStatistics

class	HeapCodeStatistics

struct	JitCodeEvent

class	ExternalResourceVisitor

class	PersistentHandleVisitor

class	EmbedderHeapTracer

struct	SerializeInternalFieldsCallback

struct	DeserializeInternalFieldsCallback

class	MeasureMemoryDelegate

class	Isolate

class	StartupData

class	V8

class	SnapshotCreator

class	Maybe< void >

class	TryCatch

class	ExtensionConfiguration

class	Context

class	Unlocker

class	Locker

class	Unwinder

Typedefs
using	NativeObject = void *

using	SnapshotObjectId = uint32_t

typedef uintptr_t	PersistentContainerValue

template<class T >
using	Handle = Local< T >

template<class T >
using	UniquePersistent = Global< T >

typedef void(*	AccessorGetterCallback) (Local< String > property, const PropertyCallbackInfo< Value > &info)

typedef void(*	AccessorNameGetterCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

typedef void(*	AccessorSetterCallback) (Local< String > property, Local< Value > value, const PropertyCallbackInfo< void > &info)

typedef void(*	AccessorNameSetterCallback) (Local< Name > property, Local< Value > value, const PropertyCallbackInfo< void > &info)

typedef void(*	FunctionCallback) (const FunctionCallbackInfo< Value > &info)

using	BackingStoreDeleterCallback = void()(void data, size_t length, void *deleter_data)

typedef void(*	GenericNamedPropertyGetterCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

typedef void(*	GenericNamedPropertySetterCallback) (Local< Name > property, Local< Value > value, const PropertyCallbackInfo< Value > &info)

typedef void(*	GenericNamedPropertyQueryCallback) (Local< Name > property, const PropertyCallbackInfo< Integer > &info)

typedef void(*	GenericNamedPropertyDeleterCallback) (Local< Name > property, const PropertyCallbackInfo< Boolean > &info)

typedef void(*	GenericNamedPropertyEnumeratorCallback) (const PropertyCallbackInfo< Array > &info)

typedef void(*	GenericNamedPropertyDefinerCallback) (Local< Name > property, const PropertyDescriptor &desc, const PropertyCallbackInfo< Value > &info)

typedef void(*	GenericNamedPropertyDescriptorCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

typedef void(*	IndexedPropertyGetterCallback) (uint32_t index, const PropertyCallbackInfo< Value > &info)

typedef void(*	IndexedPropertySetterCallback) (uint32_t index, Local< Value > value, const PropertyCallbackInfo< Value > &info)

typedef void(*	IndexedPropertyQueryCallback) (uint32_t index, const PropertyCallbackInfo< Integer > &info)

typedef void(*	IndexedPropertyDeleterCallback) (uint32_t index, const PropertyCallbackInfo< Boolean > &info)

typedef void(*	IndexedPropertyEnumeratorCallback) (const PropertyCallbackInfo< Array > &info)

typedef void(*	IndexedPropertyDefinerCallback) (uint32_t index, const PropertyDescriptor &desc, const PropertyCallbackInfo< Value > &info)

typedef void(*	IndexedPropertyDescriptorCallback) (uint32_t index, const PropertyCallbackInfo< Value > &info)

typedef bool(*	AccessCheckCallback) (Local< Context > accessing_context, Local< Object > accessed_object, Local< Value > data)

typedef void(*	FatalErrorCallback) (const char location, const char message)

typedef void(*	OOMErrorCallback) (const char *location, bool is_heap_oom)

typedef void(*	DcheckErrorCallback) (const char file, int line, const char message)

typedef void(*	MessageCallback) (Local< Message > message, Local< Value > data)

typedef void(*	LogEventCallback) (const char *name, int event)

typedef int (	CounterLookupCallback) (const char *name)

typedef void (	CreateHistogramCallback) (const char *name, int min, int max, size_t buckets)

typedef void(*	AddHistogramSampleCallback) (void *histogram, int sample)

typedef void(*	AddCrashKeyCallback) (CrashKeyId id, const std::string &value)

typedef void(*	BeforeCallEnteredCallback) (Isolate *)

typedef void(*	CallCompletedCallback) (Isolate *)

typedef MaybeLocal< Promise >(*	HostImportModuleDynamicallyCallback) (Local< Context > context, Local< ScriptOrModule > referrer, Local< String > specifier)

typedef void(*	HostInitializeImportMetaObjectCallback) (Local< Context > context, Local< Module > module, Local< Object > meta)

typedef MaybeLocal< Value >(*	PrepareStackTraceCallback) (Local< Context > context, Local< Value > error, Local< Array > sites)

typedef void(*	PromiseHook) (PromiseHookType type, Local< Promise > promise, Local< Value > parent)

typedef void(*	PromiseRejectCallback) (PromiseRejectMessage message)

typedef void(*	MicrotasksCompletedCallback) (Isolate *)

typedef void(*	MicrotasksCompletedCallbackWithData) (Isolate , void )

typedef void(*	MicrotaskCallback) (void *data)

typedef void(*	FailedAccessCheckCallback) (Local< Object > target, AccessType type, Local< Value > data)

typedef bool(*	AllowCodeGenerationFromStringsCallback) (Local< Context > context, Local< String > source)

typedef ModifyCodeGenerationFromStringsResult(*	ModifyCodeGenerationFromStringsCallback) (Local< Context > context, Local< Value > source)

typedef bool(*	ExtensionCallback) (const FunctionCallbackInfo< Value > &)

typedef bool(*	AllowWasmCodeGenerationCallback) (Local< Context > context, Local< String > source)

typedef void(*	ApiImplementationCallback) (const FunctionCallbackInfo< Value > &)

typedef void(*	WasmStreamingCallback) (const FunctionCallbackInfo< Value > &)

typedef bool(*	WasmThreadsEnabledCallback) (Local< Context > context)

typedef Local< String >(*	WasmLoadSourceMapCallback) (Isolate isolate, const char name)

typedef bool(*	WasmSimdEnabledCallback) (Local< Context > context)

typedef void(*	GCCallback) (GCType type, GCCallbackFlags flags)

typedef void(*	InterruptCallback) (Isolate isolate, void data)

typedef size_t(*	NearHeapLimitCallback) (void *data, size_t current_heap_limit, size_t initial_heap_limit)

typedef void(*	JitCodeEventHandler) (const JitCodeEvent *event)

typedef SerializeInternalFieldsCallback	SerializeEmbedderFieldsCallback

typedef DeserializeInternalFieldsCallback	DeserializeEmbedderFieldsCallback

typedef bool(*	EntropySource) (unsigned char *buffer, size_t length)

typedef uintptr_t(*	ReturnAddressLocationResolver) (uintptr_t return_addr_location)

Enumerations
enum class	TaskPriority : uint8_t { kBestEffort , kUserVisible , kUserBlocking }

enum	CpuProfilingMode { kLeafNodeLineNumbers , kCallerLineNumbers }

enum	CpuProfilingNamingMode { kStandardNaming , kDebugNaming }

enum	CpuProfilingLoggingMode { kLazyLogging , kEagerLogging }

enum	CodeEventType { kUnknownType }

enum	PersistentContainerCallbackType { kNotWeak , kWeakWithParameter , kWeakWithInternalFields }

enum class	WeakCallbackType { kParameter , kInternalFields , kFinalizer }

enum	StateTag { JS , GC , PARSER , BYTECODE_COMPILER , COMPILER , OTHER , EXTERNAL , ATOMICS_WAIT , IDLE }

enum class	NewStringType { kNormal , kInternalized }

enum	PropertyAttribute { None = 0 , ReadOnly = 1 << 0 , DontEnum = 1 << 1 , DontDelete = 1 << 2 }

enum	AccessControl { DEFAULT = 0 , ALL_CAN_READ = 1 , ALL_CAN_WRITE = 1 << 1 , PROHIBITS_OVERWRITING = 1 << 2 }

enum	PropertyFilter { ALL_PROPERTIES = 0 , ONLY_WRITABLE = 1 , ONLY_ENUMERABLE = 2 , ONLY_CONFIGURABLE = 4 , SKIP_STRINGS = 8 , SKIP_SYMBOLS = 16 }

enum class	SideEffectType { kHasSideEffect , kHasNoSideEffect , kHasSideEffectToReceiver }

enum class	KeyCollectionMode { kOwnOnly , kIncludePrototypes }

enum class	IndexFilter { kIncludeIndices , kSkipIndices }

enum class	KeyConversionMode { kConvertToString , kKeepNumbers , kNoNumbers }

enum class	IntegrityLevel { kFrozen , kSealed }

enum class	ConstructorBehavior { kThrow , kAllow }

enum class	ArrayBufferCreationMode { kInternalized , kExternalized }

enum	Intrinsic

enum	AccessType { ACCESS_GET , ACCESS_SET , ACCESS_HAS , ACCESS_DELETE , ACCESS_KEYS }

enum class	PropertyHandlerFlags { kNone = 0 , kAllCanRead = 1 , kNonMasking = 1 << 1 , kOnlyInterceptStrings = 1 << 2 , kHasNoSideEffect = 1 << 3 }

enum class	CrashKeyId { kIsolateAddress , kReadonlySpaceFirstPageAddress , kMapSpaceFirstPageAddress , kCodeSpaceFirstPageAddress , kDumpType }

enum class	PromiseHookType { kInit , kResolve , kBefore , kAfter }

enum	PromiseRejectEvent { kPromiseRejectWithNoHandler = 0 , kPromiseHandlerAddedAfterReject = 1 , kPromiseRejectAfterResolved = 2 , kPromiseResolveAfterResolved = 3 }

enum class	MicrotasksPolicy { kExplicit , kScoped , kAuto }

enum	GCType { kGCTypeScavenge = 1 << 0 , kGCTypeMarkSweepCompact = 1 << 1 , kGCTypeIncrementalMarking = 1 << 2 , kGCTypeProcessWeakCallbacks = 1 << 3 , kGCTypeAll }

enum	GCCallbackFlags { kNoGCCallbackFlags = 0 , kGCCallbackFlagConstructRetainedObjectInfos = 1 << 1 , kGCCallbackFlagForced = 1 << 2 , kGCCallbackFlagSynchronousPhantomCallbackProcessing = 1 << 3 , kGCCallbackFlagCollectAllAvailableGarbage = 1 << 4 , kGCCallbackFlagCollectAllExternalMemory = 1 << 5 , kGCCallbackScheduleIdleGarbageCollection = 1 << 6 }

enum	RAILMode : unsigned { PERFORMANCE_RESPONSE , PERFORMANCE_ANIMATION , PERFORMANCE_IDLE , PERFORMANCE_LOAD }

enum	JitCodeEventOptions { kJitCodeEventDefault = 0 , kJitCodeEventEnumExisting = 1 }

enum class	MemoryPressureLevel { kNone , kModerate , kCritical }

enum class	MeasureMemoryMode { kSummary , kDetailed }

enum class	MeasureMemoryExecution { kDefault , kEager , kLazy }

Functions
template<typename T1 , typename T2 , typename = std::enable_if_t<std::is_base_of<T2, T1>::value \|\| std::is_base_of<T1, T2>::value>>
bool	operator== (const JSMember< T1 > &lhs, const JSMember< T2 > &rhs)

template<typename T1 , typename T2 , typename = std::enable_if_t<std::is_base_of<T2, T1>::value \|\| std::is_base_of<T1, T2>::value>>
bool	operator!= (const JSMember< T1 > &lhs, const JSMember< T2 > &rhs)

template<typename T1 , typename T2 , typename = std::enable_if_t<std::is_base_of<T2, T1>::value \|\| std::is_base_of<T1, T2>::value>>
bool	operator== (const JSMember< T1 > &lhs, const Local< T2 > &rhs)

template<typename T1 , typename T2 , typename = std::enable_if_t<std::is_base_of<T2, T1>::value \|\| std::is_base_of<T1, T2>::value>>
bool	operator== (const Local< T1 > &lhs, const JSMember< T2 > rhs)

template<typename T1 , typename T2 >
bool	operator!= (const JSMember< T1 > &lhs, const T2 &rhs)

template<typename T1 , typename T2 >
bool	operator!= (const T1 &lhs, const JSMember< T2 > &rhs)

constexpr uint32_t	CurrentValueSerializerFormatVersion ()

V8_EXPORT bool	TryHandleWebAssemblyTrapPosix (int sig_code, siginfo_t info, void context)

V8_EXPORT bool	TryHandleWebAssemblyTrapWindows (EXCEPTION_POINTERS *exception)

void V8_EXPORT	RegisterExtension (std::unique_ptr< Extension >)

V8_INLINE Local< Primitive >	Undefined (Isolate *isolate)

V8_INLINE Local< Primitive >	Null (Isolate *isolate)

V8_INLINE Local< Boolean >	True (Isolate *isolate)

V8_INLINE Local< Boolean >	False (Isolate *isolate)

template<class T >
Maybe< T >	Nothing ()

template<class T >
Maybe< T >	Just (const T &t)

Maybe< void >	JustVoid ()

Detailed Description

This file provides additional API on top of the default one for making API calls, which come from embedder C++ functions. The functions are being called directly from optimized code, doing all the necessary typechecks in the compiler itself, instead of on the embedder side. Hence the "fast" in the name. Example usage might look like:

void FastMethod(int param, bool another_param);
 
v8::FunctionTemplate::New(isolate, SlowCallback, data,
                          signature, length, constructor_behavior
                          side_effect_type,
                          &v8::CFunction::Make(FastMethod));

An example for custom embedder type support might employ a way to wrap/ unwrap various C++ types in JSObject instances, e.g:

// Helper method with a check for field count.
template <typename T, int offset>
inline T* GetInternalField(v8::Local<v8::Object> wrapper) {
  assert(offset < wrapper->InternalFieldCount());
  return reinterpret_cast<T*>(
      wrapper->GetAlignedPointerFromInternalField(offset));
}
 
class CustomEmbedderType {
 public:
  // Returns the raw C object from a wrapper JS object.
  static CustomEmbedderType* Unwrap(v8::Local<v8::Object> wrapper) {
    return GetInternalField<CustomEmbedderType,
                            kV8EmbedderWrapperObjectIndex>(wrapper);
  }
  static void FastMethod(v8::ApiObject receiver_obj, int param) {
    v8::Object* v8_object = reinterpret_cast<v8::Object*>(&api_object);
    CustomEmbedderType* receiver = static_cast<CustomEmbedderType*>(
      receiver_obj->GetAlignedPointerFromInternalField(
        kV8EmbedderWrapperObjectIndex));
 
    // Type checks are already done by the optimized code.
    // Then call some performance-critical method like:
    // receiver->Method(param);
  }
 
  static void SlowMethod(
      const v8::FunctionCallbackInfo<v8::Value>& info) {
    v8::Local<v8::Object> instance =
      v8::Local<v8::Object>::Cast(info.Holder());
    CustomEmbedderType* receiver = Unwrap(instance);
    // TODO: Do type checks and extract {param}.
    receiver->Method(param);
  }
};
 
// TODO(mslekova): Clean-up these constants
// The constants kV8EmbedderWrapperTypeIndex and
// kV8EmbedderWrapperObjectIndex describe the offsets for the type info
// struct and the native object, when expressed as internal field indices
// within a JSObject. The existance of this helper function assumes that
// all embedder objects have their JSObject-side type info at the same
// offset, but this is not a limitation of the API itself. For a detailed
// use case, see the third example.
static constexpr int kV8EmbedderWrapperTypeIndex = 0;
static constexpr int kV8EmbedderWrapperObjectIndex = 1;
 
// The following setup function can be templatized based on
// the {embedder_object} argument.
void SetupCustomEmbedderObject(v8::Isolate* isolate,
                               v8::Local<v8::Context> context,
                               CustomEmbedderType* embedder_object) {
  isolate->set_embedder_wrapper_type_index(
    kV8EmbedderWrapperTypeIndex);
  isolate->set_embedder_wrapper_object_index(
    kV8EmbedderWrapperObjectIndex);
 
  v8::CFunction c_func =
    MakeV8CFunction(CustomEmbedderType::FastMethod);
 
  Local<v8::FunctionTemplate> method_template =
    v8::FunctionTemplate::New(
      isolate, CustomEmbedderType::SlowMethod, v8::Local<v8::Value>(),
      v8::Local<v8::Signature>(), 1, v8::ConstructorBehavior::kAllow,
      v8::SideEffectType::kHasSideEffect, &c_func);
 
  v8::Local<v8::ObjectTemplate> object_template =
    v8::ObjectTemplate::New(isolate);
  object_template->SetInternalFieldCount(
    kV8EmbedderWrapperObjectIndex + 1);
  object_template->Set(isolate, "method", method_template);
 
  // Instantiate the wrapper JS object.
  v8::Local<v8::Object> object =
      object_template->NewInstance(context).ToLocalChecked();
  object->SetAlignedPointerInInternalField(
    kV8EmbedderWrapperObjectIndex,
    reinterpret_cast<void*>(embedder_object));
 
  // TODO: Expose {object} where it's necessary.
}

For instance if {object} is exposed via a global "obj" variable, one could write in JS: function hot_func() { obj.method(42); } and once {hot_func} gets optimized, CustomEmbedderType::FastMethod will be called instead of the slow version, with the following arguments: receiver := the {embedder_object} from above param := 42

Currently only void return types are supported. Currently supported argument types:

pointer to an embedder type
bool
int32_t
uint32_t
int64_t
uint64_t The 64-bit integer types currently have the IDL (unsigned) long long semantics: https://heycam.github.io/webidl/#abstract-opdef-converttoint In the future we'll extend the API to also provide conversions from/to BigInt to preserve full precision. To be supported types:
float32_t
float64_t
arrays of C types
arrays of embedder types

Profiler support for the V8 JavaScript engine.

Support for Persistent containers.

C++11 embedders can use STL containers with Global values, but pre-C++11 does not support the required move semantic and hence may want these container classes.

Compile-time constants.

This header provides access to information about the value serializer at compile time, without declaring or defining any symbols that require linking to V8.

The v8 JavaScript engine.

Typedef Documentation

◆ AccessCheckCallback

typedef bool(* AccessCheckCallback) (Local< Context > accessing_context, Local< Object > accessed_object, Local< Value > data)

Returns true if the given context should be allowed to access the given object.

Definition at line 6356 of file v8.h.

◆ AccessorGetterCallback

typedef void(* AccessorGetterCallback) (Local< String > property, const PropertyCallbackInfo< Value > &info)

Accessor[Getter|Setter] are used as callback functions when setting|getting a particular property. See Object and ObjectTemplate's method SetAccessor.

Definition at line 3617 of file v8.h.

◆ AccessorNameGetterCallback

typedef void(* AccessorNameGetterCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

Definition at line 3620 of file v8.h.

◆ AccessorNameSetterCallback

typedef void(* AccessorNameSetterCallback) (Local< Name > property, Local< Value > value, const PropertyCallbackInfo< void > &info)

Definition at line 3629 of file v8.h.

◆ AccessorSetterCallback

typedef void(* AccessorSetterCallback) (Local< String > property, Local< Value > value, const PropertyCallbackInfo< void > &info)

Definition at line 3625 of file v8.h.

◆ AddCrashKeyCallback

typedef void(* AddCrashKeyCallback) (CrashKeyId id, const std::string &value)

Definition at line 7239 of file v8.h.

◆ AddHistogramSampleCallback

typedef void(* AddHistogramSampleCallback) (void *histogram, int sample)

Definition at line 7228 of file v8.h.

◆ AllowCodeGenerationFromStringsCallback

typedef bool(* AllowCodeGenerationFromStringsCallback) (Local< Context > context, Local< String > source)

Callback to check if code generation from strings is allowed. See Context::AllowCodeGenerationFromStrings.

Definition at line 7494 of file v8.h.

◆ AllowWasmCodeGenerationCallback

typedef bool(* AllowWasmCodeGenerationCallback) (Local< Context > context, Local< String > source)

Definition at line 7517 of file v8.h.

◆ ApiImplementationCallback

typedef void(* ApiImplementationCallback) (const FunctionCallbackInfo< Value > &)

Definition at line 7522 of file v8.h.

◆ BackingStoreDeleterCallback

using BackingStoreDeleterCallback = void (*)(void* data, size_t length, void* deleter_data)

Definition at line 5059 of file v8.h.

◆ BeforeCallEnteredCallback

typedef void(* BeforeCallEnteredCallback) (Isolate *)

Definition at line 7242 of file v8.h.

◆ CallCompletedCallback

typedef void(* CallCompletedCallback) (Isolate *)

Definition at line 7243 of file v8.h.

◆ CounterLookupCallback

typedef int*(* CounterLookupCallback) (const char *name)

Definition at line 7221 of file v8.h.

◆ CreateHistogramCallback

typedef void*(* CreateHistogramCallback) (const char *name, int min, int max, size_t buckets)

Definition at line 7223 of file v8.h.

◆ DcheckErrorCallback

typedef void(* DcheckErrorCallback) (const char *file, int line, const char *message)

Definition at line 7180 of file v8.h.

◆ DeserializeEmbedderFieldsCallback

typedef DeserializeInternalFieldsCallback DeserializeEmbedderFieldsCallback

Definition at line 8105 of file v8.h.

◆ EntropySource

typedef bool(* EntropySource) (unsigned char *buffer, size_t length)

EntropySource is used as a callback function when v8 needs a source of entropy.

Definition at line 9584 of file v8.h.

◆ ExtensionCallback

typedef bool(* ExtensionCallback) (const FunctionCallbackInfo< Value > &)

Definition at line 7515 of file v8.h.

◆ FailedAccessCheckCallback

typedef void(* FailedAccessCheckCallback) (Local< Object > target, AccessType type, Local< Value > data)

Definition at line 7484 of file v8.h.

◆ FatalErrorCallback

typedef void(* FatalErrorCallback) (const char *location, const char *message)

Definition at line 7176 of file v8.h.

◆ FunctionCallback

typedef void(* FunctionCallback) (const FunctionCallbackInfo< Value > &info)

Definition at line 4476 of file v8.h.

◆ GCCallback

typedef void(* GCCallback) (GCType type, GCCallbackFlags flags)

Definition at line 7579 of file v8.h.

◆ GenericNamedPropertyDefinerCallback

typedef void(* GenericNamedPropertyDefinerCallback) (Local< Name > property, const PropertyDescriptor &desc, const PropertyCallbackInfo< Value > &info)

Interceptor for defineProperty requests on an object.

Use info.GetReturnValue() to indicate whether the request was intercepted or not. If the definer successfully intercepts the request, i.e., if the request should not be further executed, call info.GetReturnValue().Set(value). If the definer did not intercept the request, i.e., if the request should be handled as if no interceptor is present, do not not call Set().

Parameters

property	The name of the property for which the request was intercepted.
desc	The property descriptor which is used to define the property if the request is not intercepted.
info	Information about the intercepted request, such as isolate, receiver, return value, or whether running in ‘'use strict’`mode. See`PropertyCallbackInfo`.

◆ GenericNamedPropertyDeleterCallback

typedef void(* GenericNamedPropertyDeleterCallback) (Local< Name > property, const PropertyCallbackInfo< Boolean > &info)

Interceptor for delete requests on an object.

Use info.GetReturnValue() to indicate whether the request was intercepted or not. If the deleter successfully intercepts the request, i.e., if the request should not be further executed, call info.GetReturnValue().Set(value) with a boolean value. The value is used as the return value of delete.

Parameters

property	The name of the property for which the request was intercepted.
info	Information about the intercepted request, such as isolate, receiver, return value, or whether running in ‘'use strict’`mode. See`PropertyCallbackInfo`.

Note: If you need to mimic the behavior of delete, i.e., throw in strict mode instead of returning false, use info.ShouldThrowOnError() to determine if you are in strict mode.

◆ GenericNamedPropertyDescriptorCallback

typedef void(* GenericNamedPropertyDescriptorCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

Interceptor for getOwnPropertyDescriptor requests on an object.

Use info.GetReturnValue().Set() to set the return value of the intercepted request. The return value must be an object that can be converted to a PropertyDescriptor, e.g., a v8::value returned from v8::Object::getOwnPropertyDescriptor.

Parameters

property The name of the property for which the request was intercepted. \info Information about the intercepted request, such as isolate, receiver, return value, or whether running in ‘'use strict’mode. SeePropertyCallbackInfo`.

Note: If GetOwnPropertyDescriptor is intercepted, it will always return true, i.e., indicate that the property was found.

◆ GenericNamedPropertyEnumeratorCallback

typedef void(* GenericNamedPropertyEnumeratorCallback) (const PropertyCallbackInfo< Array > &info)

Returns an array containing the names of the properties the named property getter intercepts.

Note: The values in the array must be of type v8::Name.

Definition at line 6240 of file v8.h.

◆ GenericNamedPropertyGetterCallback

typedef void(* GenericNamedPropertyGetterCallback) (Local< Name > property, const PropertyCallbackInfo< Value > &info)

Interceptor for get requests on an object.

Use info.GetReturnValue().Set() to set the return value of the intercepted get request.

Parameters

property	The name of the property for which the request was intercepted.
info	Information about the intercepted request, such as isolate, receiver, return value, or whether running in `'use strict`' mode. See `PropertyCallbackInfo`.

void GetterCallback(
  Local<Name> name,
  const v8::PropertyCallbackInfo<v8::Value>& info) {
    info.GetReturnValue().Set(v8_num(42));
}
 
v8::Local<v8::FunctionTemplate> templ =
    v8::FunctionTemplate::New(isolate);
templ->InstanceTemplate()->SetHandler(
    v8::NamedPropertyHandlerConfiguration(GetterCallback));
LocalContext env;
env->Global()
    ->Set(env.local(), v8_str("obj"), templ->GetFunction(env.local())
                                           .ToLocalChecked()
                                           ->NewInstance(env.local())
                                           .ToLocalChecked())
    .FromJust();
v8::Local<v8::Value> result = CompileRun("obj.a = 17; obj.a");
CHECK(v8_num(42)->Equals(env.local(), result).FromJust());

◆ GenericNamedPropertyQueryCallback

typedef void(* GenericNamedPropertyQueryCallback) (Local< Name > property, const PropertyCallbackInfo< Integer > &info)

Intercepts all requests that query the attributes of the property, e.g., getOwnPropertyDescriptor(), propertyIsEnumerable(), and defineProperty().

Use info.GetReturnValue().Set(value) to set the property attributes. The value is an integer encoding a v8::PropertyAttribute.

Parameters

property	The name of the property for which the request was intercepted.
info	Information about the intercepted request, such as isolate, receiver, return value, or whether running in ‘'use strict’`mode. See`PropertyCallbackInfo`.

Note: Some functions query the property attributes internally, even though they do not return the attributes. For example, hasOwnProperty() can trigger this interceptor depending on the state of the object.

◆ GenericNamedPropertySetterCallback

typedef void(* GenericNamedPropertySetterCallback) (Local< Name > property, Local< Value > value, const PropertyCallbackInfo< Value > &info)

Interceptor for set requests on an object.

Use info.GetReturnValue() to indicate whether the request was intercepted or not. If the setter successfully intercepts the request, i.e., if the request should not be further executed, call info.GetReturnValue().Set(value). If the setter did not intercept the request, i.e., if the request should be handled as if no interceptor is present, do not not call Set().

Parameters

property	The name of the property for which the request was intercepted.
value	The value which the property will have if the request is not intercepted.
info	Information about the intercepted request, such as isolate, receiver, return value, or whether running in ‘'use strict’`mode. See`PropertyCallbackInfo`.

◆ Handle

using Handle = Local<T>

Definition at line 350 of file v8.h.

◆ HostImportModuleDynamicallyCallback

typedef MaybeLocal<Promise>(* HostImportModuleDynamicallyCallback) (Local< Context > context, Local< ScriptOrModule > referrer, Local< String > specifier)

HostImportModuleDynamicallyCallback is called when we require the embedder to load a module. This is used as part of the dynamic import syntax.

The referrer contains metadata about the script/module that calls import.

The specifier is the name of the module that should be imported.

The embedder must compile, instantiate, evaluate the Module, and obtain it's namespace object.

The Promise returned from this function is forwarded to userland JavaScript. The embedder must resolve this promise with the module namespace object. In case of an exception, the embedder must reject this promise with the exception. If the promise creation itself fails (e.g. due to stack overflow), the embedder must propagate that exception by returning an empty MaybeLocal.

Definition at line 7265 of file v8.h.

◆ HostInitializeImportMetaObjectCallback

typedef void(* HostInitializeImportMetaObjectCallback) (Local< Context > context, Local< Module > module, Local< Object > meta)

HostInitializeImportMetaObjectCallback is called the first time import.meta is accessed for a module. Subsequent access will reuse the same value.

The method combines two implementation-defined abstract operations into one: HostGetImportMetaProperties and HostFinalizeImportMeta.

The embedder should use v8::Object::CreateDataProperty to add properties on the meta object.

Definition at line 7279 of file v8.h.

◆ IndexedPropertyDefinerCallback

typedef void(* IndexedPropertyDefinerCallback) (uint32_t index, const PropertyDescriptor &desc, const PropertyCallbackInfo< Value > &info)

See v8::GenericNamedPropertyDefinerCallback.

Definition at line 6330 of file v8.h.

◆ IndexedPropertyDeleterCallback

typedef void(* IndexedPropertyDeleterCallback) (uint32_t index, const PropertyCallbackInfo< Boolean > &info)

See v8::GenericNamedPropertyDeleterCallback.

Definition at line 6314 of file v8.h.

◆ IndexedPropertyDescriptorCallback

typedef void(* IndexedPropertyDescriptorCallback) (uint32_t index, const PropertyCallbackInfo< Value > &info)

See v8::GenericNamedPropertyDescriptorCallback.

Definition at line 6337 of file v8.h.

◆ IndexedPropertyEnumeratorCallback

typedef void(* IndexedPropertyEnumeratorCallback) (const PropertyCallbackInfo< Array > &info)

Returns an array containing the indices of the properties the indexed property getter intercepts.

Note: The values in the array must be uint32_t.

Definition at line 6324 of file v8.h.

◆ IndexedPropertyGetterCallback

typedef void(* IndexedPropertyGetterCallback) (uint32_t index, const PropertyCallbackInfo< Value > &info)

See v8::GenericNamedPropertyGetterCallback.

Definition at line 6292 of file v8.h.

◆ IndexedPropertyQueryCallback

typedef void(* IndexedPropertyQueryCallback) (uint32_t index, const PropertyCallbackInfo< Integer > &info)

See v8::GenericNamedPropertyQueryCallback.

Definition at line 6307 of file v8.h.

◆ IndexedPropertySetterCallback

typedef void(* IndexedPropertySetterCallback) (uint32_t index, Local< Value > value, const PropertyCallbackInfo< Value > &info)

See v8::GenericNamedPropertySetterCallback.

Definition at line 6299 of file v8.h.

◆ InterruptCallback

typedef void(* InterruptCallback) (Isolate *isolate, void *data)

Definition at line 7581 of file v8.h.

◆ JitCodeEventHandler

typedef void(* JitCodeEventHandler) (const JitCodeEvent *event)

Callback function passed to SetJitCodeEventHandler.

Parameters

event code add, move or removal event.

Definition at line 7845 of file v8.h.

◆ LogEventCallback

typedef void(* LogEventCallback) (const char *name, int event)

Definition at line 7187 of file v8.h.

◆ MessageCallback

typedef void(* MessageCallback) (Local< Message > message, Local< Value > data)

Definition at line 7183 of file v8.h.

◆ MicrotaskCallback

typedef void(* MicrotaskCallback) (void *data)

Definition at line 7345 of file v8.h.

◆ MicrotasksCompletedCallback

typedef void(* MicrotasksCompletedCallback) (Isolate *)

Definition at line 7343 of file v8.h.

◆ MicrotasksCompletedCallbackWithData

typedef void(* MicrotasksCompletedCallbackWithData) (Isolate *, void *)

Definition at line 7344 of file v8.h.

◆ ModifyCodeGenerationFromStringsCallback

typedef ModifyCodeGenerationFromStringsResult( * ModifyCodeGenerationFromStringsCallback) (Local< Context > context, Local< Value > source)

Callback to check if codegen is allowed from a source object, and convert the source to string if necessary.See ModifyCodeGenerationFromStrings.

Definition at line 7510 of file v8.h.

◆ NativeObject

using NativeObject = void*

Definition at line 23 of file v8-profiler.h.

◆ NearHeapLimitCallback

typedef size_t(* NearHeapLimitCallback) (void *data, size_t current_heap_limit, size_t initial_heap_limit)

This callback is invoked when the heap size is close to the heap limit and V8 is likely to abort with out-of-memory error. The callback can extend the heap limit by returning a value that is greater than the current_heap_limit. The initial heap limit is the limit that was set after heap setup.

Definition at line 7590 of file v8.h.

◆ OOMErrorCallback

typedef void(* OOMErrorCallback) (const char *location, bool is_heap_oom)

Definition at line 7178 of file v8.h.

◆ PersistentContainerValue

typedef uintptr_t PersistentContainerValue

Definition at line 22 of file v8-util.h.

◆ PrepareStackTraceCallback

typedef MaybeLocal<Value>(* PrepareStackTraceCallback) (Local< Context > context, Local< Value > error, Local< Array > sites)

PrepareStackTraceCallback is called when the stack property of an error is first accessed. The return value will be used as the stack value. If this callback is registed, the |Error.prepareStackTrace| API will be disabled. |sites| is an array of call sites, specified in https://v8.dev/docs/stack-trace-api

Definition at line 7290 of file v8.h.

◆ PromiseHook

typedef void(* PromiseHook) (PromiseHookType type, Local< Promise > promise, Local< Value > parent)

Definition at line 7312 of file v8.h.

◆ PromiseRejectCallback

typedef void(* PromiseRejectCallback) (PromiseRejectMessage message)

Definition at line 7339 of file v8.h.

◆ ReturnAddressLocationResolver

typedef uintptr_t(* ReturnAddressLocationResolver) (uintptr_t return_addr_location)

ReturnAddressLocationResolver is used as a callback function when v8 is resolving the location of a return address on the stack. Profilers that change the return address on the stack can use this to resolve the stack location to wherever the profiler stashed the original return address.

Parameters

return_addr_location A location on stack where a machine return address resides.

Returns: Either return_addr_location, or else a pointer to the profiler's copy of the original return address.

Note: The resolver function must not cause garbage collection.

Definition at line 9599 of file v8.h.

◆ SerializeEmbedderFieldsCallback

typedef SerializeInternalFieldsCallback SerializeEmbedderFieldsCallback

Definition at line 8089 of file v8.h.

◆ SnapshotObjectId

using SnapshotObjectId = uint32_t

Definition at line 24 of file v8-profiler.h.

◆ UniquePersistent

using UniquePersistent = Global<T>

Definition at line 819 of file v8.h.

◆ WasmLoadSourceMapCallback

typedef Local<String>(* WasmLoadSourceMapCallback) (Isolate *isolate, const char *name)

Definition at line 7531 of file v8.h.

◆ WasmSimdEnabledCallback

typedef bool(* WasmSimdEnabledCallback) (Local< Context > context)

Definition at line 7535 of file v8.h.

◆ WasmStreamingCallback

typedef void(* WasmStreamingCallback) (const FunctionCallbackInfo< Value > &)

Definition at line 7525 of file v8.h.

◆ WasmThreadsEnabledCallback

typedef bool(* WasmThreadsEnabledCallback) (Local< Context > context)

Definition at line 7528 of file v8.h.

Enumeration Type Documentation

◆ AccessControl

enum AccessControl

Access control specifications.

Some accessors should be accessible across contexts. These accessors have an explicit access control parameter which specifies the kind of cross-context access that should be allowed.

TODO(dcarney): Remove PROHIBITS_OVERWRITING as it is now unused.

Enumerator
DEFAULT
ALL_CAN_READ
ALL_CAN_WRITE
PROHIBITS_OVERWRITING

Definition at line 3644 of file v8.h.

◆ AccessType

enum AccessType

Access type specification.

Enumerator
ACCESS_GET
ACCESS_SET
ACCESS_HAS
ACCESS_DELETE
ACCESS_KEYS

Definition at line 6343 of file v8.h.

◆ ArrayBufferCreationMode

enum ArrayBufferCreationMode

strong

Enumerator
kInternalized
kExternalized

Definition at line 4984 of file v8.h.

◆ CodeEventType

enum CodeEventType

Note that this enum may be extended in the future. Please include a default case if this enum is used in a switch statement.

Enumerator
kUnknownType

Definition at line 983 of file v8-profiler.h.

◆ ConstructorBehavior

enum ConstructorBehavior

strong

Enumerator
kThrow
kAllow

Definition at line 4478 of file v8.h.

◆ CpuProfilingLoggingMode

enum CpuProfilingLoggingMode

Enumerator
kLazyLogging
kEagerLogging

Definition at line 242 of file v8-profiler.h.

◆ CpuProfilingMode

enum CpuProfilingMode

Enumerator
kLeafNodeLineNumbers
kCallerLineNumbers

Definition at line 223 of file v8-profiler.h.

◆ CpuProfilingNamingMode

enum CpuProfilingNamingMode

Enumerator
kStandardNaming
kDebugNaming

Definition at line 234 of file v8-profiler.h.

◆ CrashKeyId

enum CrashKeyId

strong

Enumerator
kIsolateAddress
kReadonlySpaceFirstPageAddress
kMapSpaceFirstPageAddress
kCodeSpaceFirstPageAddress
kDumpType

Definition at line 7231 of file v8.h.

◆ GCCallbackFlags

enum GCCallbackFlags

GCCallbackFlags is used to notify additional information about the GC callback.

kGCCallbackFlagConstructRetainedObjectInfos: The GC callback is for constructing retained object infos.
kGCCallbackFlagForced: The GC callback is for a forced GC for testing.
kGCCallbackFlagSynchronousPhantomCallbackProcessing: The GC callback is called synchronously without getting posted to an idle task.
kGCCallbackFlagCollectAllAvailableGarbage: The GC callback is called in a phase where V8 is trying to collect all available garbage (e.g., handling a low memory notification).
kGCCallbackScheduleIdleGarbageCollection: The GC callback is called to trigger an idle garbage collection.

Enumerator
kNoGCCallbackFlags
kGCCallbackFlagConstructRetainedObjectInfos
kGCCallbackFlagForced
kGCCallbackFlagSynchronousPhantomCallbackProcessing
kGCCallbackFlagCollectAllAvailableGarbage
kGCCallbackFlagCollectAllExternalMemory
kGCCallbackScheduleIdleGarbageCollection

Definition at line 7569 of file v8.h.

◆ GCType

enum GCType

Applications can register callback functions which will be called before and after certain garbage collection operations. Allocations are not allowed in the callback functions, you therefore cannot manipulate objects (set or delete properties for example) since it is possible such operations will result in the allocation of objects.

Enumerator
kGCTypeScavenge
kGCTypeMarkSweepCompact
kGCTypeIncrementalMarking
kGCTypeProcessWeakCallbacks
kGCTypeAll

Definition at line 7546 of file v8.h.

◆ IndexFilter

enum IndexFilter

strong

kIncludesIndices allows for integer indices to be collected, while kSkipIndices will exclude integer indices from being collected.

Enumerator
kIncludeIndices
kSkipIndices

Definition at line 3692 of file v8.h.

◆ IntegrityLevel

enum IntegrityLevel

strong

Integrity level for objects.

Enumerator
kFrozen
kSealed

Definition at line 3703 of file v8.h.

◆ Intrinsic

enum Intrinsic

Definition at line 6016 of file v8.h.

◆ JitCodeEventOptions

enum JitCodeEventOptions

Option flags passed to the SetJitCodeEventHandler function.

Enumerator
kJitCodeEventDefault
kJitCodeEventEnumExisting

Definition at line 7833 of file v8.h.

◆ KeyCollectionMode

enum KeyCollectionMode

strong

Keys/Properties filter enums:

KeyCollectionMode limits the range of collected properties. kOwnOnly limits the collected properties to the given Object only. kIncludesPrototypes will include all keys of the objects's prototype chain as well.

Enumerator
kOwnOnly
kIncludePrototypes

Definition at line 3686 of file v8.h.

◆ KeyConversionMode

enum KeyConversionMode

strong

kConvertToString will convert integer indices to strings. kKeepNumbers will return numbers for integer indices.

Enumerator
kConvertToString
kKeepNumbers
kNoNumbers

Definition at line 3698 of file v8.h.

◆ MeasureMemoryExecution

enum MeasureMemoryExecution

strong

Controls how promptly a memory measurement request is executed. By default the measurement is folded with the next scheduled GC which may happen after a while and is forced after some timeout. The kEager mode starts incremental GC right away and is useful for testing. The kLazy mode does not force GC.

Enumerator
kDefault
kEager
kLazy

Definition at line 8121 of file v8.h.

◆ MeasureMemoryMode

enum MeasureMemoryMode

strong

Controls how the default MeasureMemoryDelegate reports the result of the memory measurement to JS. With kSummary only the total size is reported. With kDetailed the result includes the size of each native context.

Enumerator
kSummary
kDetailed

Definition at line 8112 of file v8.h.

◆ MemoryPressureLevel

enum MemoryPressureLevel

strong

Memory pressure level for the MemoryPressureNotification. kNone hints V8 that there is no memory pressure. kModerate hints V8 to speed up incremental garbage collection at the cost of of higher latency due to garbage collection pauses. kCritical hints V8 to free memory as soon as possible. Garbage collection pauses at this level will be large.

Enumerator
kNone
kModerate
kCritical

Definition at line 7883 of file v8.h.

◆ MicrotasksPolicy

enum MicrotasksPolicy

strong

Policy for running microtasks:

explicit: microtasks are invoked with the Isolate::PerformMicrotaskCheckpoint() method;
scoped: microtasks invocation is controlled by MicrotasksScope objects;
auto: microtasks are invoked when the script call depth decrements to zero.

Enumerator
kExplicit
kScoped
kAuto

Definition at line 7355 of file v8.h.

◆ NewStringType

enum NewStringType

strong

A flag describing different modes of string creation.

Aside from performance implications there are no differences between the two creation modes.

Enumerator
kNormal	Create a new string, always allocating new storage memory.
kInternalized	Acts as a hint that the string should be created in the old generation heap space and be deduplicated if an identical string already exists.

Definition at line 2985 of file v8.h.

◆ PersistentContainerCallbackType

enum PersistentContainerCallbackType

Enumerator
kNotWeak
kWeakWithParameter
kWeakWithInternalFields

Definition at line 24 of file v8-util.h.

◆ PromiseHookType

enum PromiseHookType

strong

PromiseHook with type kInit is called when a new promise is created. When a new promise is created as part of the chain in the case of Promise.then or in the intermediate promises created by Promise.{race, all}/AsyncFunctionAwait, we pass the parent promise otherwise we pass undefined.

PromiseHook with type kResolve is called at the beginning of resolve or reject function defined by CreateResolvingFunctions.

PromiseHook with type kBefore is called at the beginning of the PromiseReactionJob.

PromiseHook with type kAfter is called right at the end of the PromiseReactionJob.

Enumerator
kInit
kResolve
kBefore
kAfter

Definition at line 7310 of file v8.h.

◆ PromiseRejectEvent

enum PromiseRejectEvent

Enumerator
kPromiseRejectWithNoHandler
kPromiseHandlerAddedAfterReject
kPromiseRejectAfterResolved
kPromiseResolveAfterResolved

Definition at line 7316 of file v8.h.

◆ PropertyAttribute

enum PropertyAttribute

PropertyAttribute.

Enumerator
None	None.
ReadOnly	ReadOnly, i.e., not writable.
DontEnum	DontEnum, i.e., not enumerable.
DontDelete	DontDelete, i.e., not configurable.

Definition at line 3601 of file v8.h.

◆ PropertyFilter

enum PropertyFilter

Property filter bits. They can be or'ed to build a composite filter.

Enumerator
ALL_PROPERTIES
ONLY_WRITABLE
ONLY_ENUMERABLE
ONLY_CONFIGURABLE
SKIP_STRINGS
SKIP_SYMBOLS

Definition at line 3654 of file v8.h.

◆ PropertyHandlerFlags

enum PropertyHandlerFlags

strong

Configuration flags for v8::NamedPropertyHandlerConfiguration or v8::IndexedPropertyHandlerConfiguration.

Enumerator
kNone	None.
kAllCanRead	See ALL_CAN_READ above.
kNonMasking	Will not call into interceptor for properties on the receiver or prototype chain, i.e., only call into interceptor for properties that do not exist. Currently only valid for named interceptors.
kOnlyInterceptStrings	Will not call into interceptor for symbol lookup. Only meaningful for named interceptors.
kHasNoSideEffect	The getter, query, enumerator callbacks do not produce side effects.

Definition at line 6584 of file v8.h.

◆ RAILMode

enum RAILMode : unsigned

Option flags passed to the SetRAILMode function. See documentation https://developers.google.com/web/tools/chrome-devtools/ profile/evaluate-performance/rail

Enumerator
PERFORMANCE_RESPONSE
PERFORMANCE_ANIMATION
PERFORMANCE_IDLE
PERFORMANCE_LOAD

Definition at line 7813 of file v8.h.

◆ SideEffectType

enum SideEffectType

strong

Options for marking whether callbacks may trigger JS-observable side effects. Side-effect-free callbacks are allowlisted during debug evaluation with throwOnSideEffect. It applies when calling a Function, FunctionTemplate, or an Accessor callback. For Interceptors, please see PropertyHandlerFlags's kHasNoSideEffect. Callbacks that only cause side effects to the receiver are allowlisted if invoked on receiver objects that are created within the same debug-evaluate call, as these objects are temporary and the side effect does not escape.

Enumerator
kHasSideEffect
kHasNoSideEffect
kHasSideEffectToReceiver

Definition at line 3673 of file v8.h.

◆ StateTag

enum StateTag

Enumerator
JS
GC
PARSER
BYTECODE_COMPILER
COMPILER
OTHER
EXTERNAL
ATOMICS_WAIT
IDLE

Definition at line 2223 of file v8.h.

◆ TaskPriority

enum TaskPriority : uint8_t

strong

Enumerator
kBestEffort	Best effort tasks are not critical for performance of the application. The platform implementation should preempt such tasks if higher priority tasks arrive.
kUserVisible	User visible tasks are long running background tasks that will improve performance and memory usage of the application upon completion. Example: background compilation and garbage collection.
kUserBlocking	User blocking tasks are highest priority tasks that block the execution thread (e.g. major garbage collection). They must be finished as soon as possible.

Definition at line 21 of file v8-platform.h.

◆ WeakCallbackType

enum WeakCallbackType

strong

Enumerator
kParameter
kInternalFields
kFinalizer

Definition at line 468 of file v8.h.

Function Documentation

◆ CurrentValueSerializerFormatVersion()

constexpr uint32_t v8::CurrentValueSerializerFormatVersion ( )

constexpr

Definition at line 20 of file v8-value-serializer-version.h.

◆ False()

Local< Boolean > False ( Isolate * isolate )

Definition at line 11976 of file v8.h.

◆ Just()

Maybe<T> v8::Just ( const T & t )

inline

Definition at line 10046 of file v8.h.

References V8::Maybe.

◆ JustVoid()

Maybe<void> v8::JustVoid ( )

inline

Definition at line 10078 of file v8.h.

◆ Nothing()

Maybe<T> v8::Nothing ( )

inline

Definition at line 10041 of file v8.h.

◆ Null()

Local< Primitive > Null ( Isolate * isolate )

Definition at line 11958 of file v8.h.

◆ operator!=() [1/3]

bool v8::operator!=	(	const JSMember< T1 > &	lhs,
		const JSMember< T2 > &	rhs
	)

inline

Definition at line 165 of file v8-cppgc.h.

◆ operator!=() [2/3]

bool v8::operator!=	(	const JSMember< T1 > &	lhs,
		const T2 &	rhs
	)

inline

Definition at line 188 of file v8-cppgc.h.

◆ operator!=() [3/3]

bool v8::operator!=	(	const T1 &	lhs,
		const JSMember< T2 > &	rhs
	)

inline

Definition at line 193 of file v8-cppgc.h.

◆ operator==() [1/3]

bool v8::operator==	(	const JSMember< T1 > &	lhs,
		const JSMember< T2 > &	rhs
	)

inline

Definition at line 154 of file v8-cppgc.h.

◆ operator==() [2/3]

bool v8::operator==	(	const JSMember< T1 > &	lhs,
		const Local< T2 > &	rhs
	)

inline

Definition at line 172 of file v8-cppgc.h.

◆ operator==() [3/3]

bool v8::operator==	(	const Local< T1 > &	lhs,
		const JSMember< T2 >	rhs
	)

inline

Definition at line 183 of file v8-cppgc.h.

◆ RegisterExtension()

void V8_EXPORT v8::RegisterExtension ( std::unique_ptr< Extension > )

◆ True()

Local< Boolean > True ( Isolate * isolate )

Definition at line 11967 of file v8.h.

◆ TryHandleWebAssemblyTrapPosix()

V8_EXPORT bool v8::TryHandleWebAssemblyTrapPosix	(	int	sig_code,
		siginfo_t *	info,
		void *	context
	)

This function determines whether a memory access violation has been an out-of-bounds memory access in WebAssembly. If so, it will modify the context parameter and add a return address where the execution can continue after the signal handling, and return true. Otherwise, false will be returned.

The parameters to this function correspond to those passed to a Posix signal handler. Use this function only on Linux and Mac.

Parameters

sig_code	The signal code, e.g. SIGSEGV.
info	A pointer to the siginfo_t struct provided to the signal handler.
context	A pointer to a ucontext_t struct provided to the signal handler.

◆ TryHandleWebAssemblyTrapWindows()

V8_EXPORT bool v8::TryHandleWebAssemblyTrapWindows ( EXCEPTION_POINTERS * exception )

This function determines whether a memory access violation has been an out-of-bounds memory access in WebAssembly. If so, it will modify the exception parameter and add a return address where the execution can continue after the exception handling, and return true. Otherwise the return value will be false.

The parameter to this function corresponds to the one passed to a Windows vectored exception handler. Use this function only on Windows.

Parameters

exception An EXCEPTION_POINTERS* as provided to the exception handler.

◆ Undefined()

Local< Primitive > Undefined ( Isolate * isolate )

Definition at line 11949 of file v8.h.

Namespaces

Data Structures

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ AccessCheckCallback

◆ AccessorGetterCallback

◆ AccessorNameGetterCallback

◆ AccessorNameSetterCallback

◆ AccessorSetterCallback

◆ AddCrashKeyCallback

◆ AddHistogramSampleCallback

◆ AllowCodeGenerationFromStringsCallback

◆ AllowWasmCodeGenerationCallback

◆ ApiImplementationCallback

◆ BackingStoreDeleterCallback

◆ BeforeCallEnteredCallback

◆ CallCompletedCallback

◆ CounterLookupCallback

◆ CreateHistogramCallback

◆ DcheckErrorCallback

◆ DeserializeEmbedderFieldsCallback

◆ EntropySource

◆ ExtensionCallback

◆ FailedAccessCheckCallback

◆ FatalErrorCallback

◆ FunctionCallback

◆ GCCallback

◆ GenericNamedPropertyDefinerCallback

◆ GenericNamedPropertyDeleterCallback

◆ GenericNamedPropertyDescriptorCallback

◆ GenericNamedPropertyEnumeratorCallback

◆ GenericNamedPropertyGetterCallback

◆ GenericNamedPropertyQueryCallback

◆ GenericNamedPropertySetterCallback

◆ Handle

◆ HostImportModuleDynamicallyCallback

◆ HostInitializeImportMetaObjectCallback

◆ IndexedPropertyDefinerCallback

◆ IndexedPropertyDeleterCallback

◆ IndexedPropertyDescriptorCallback

◆ IndexedPropertyEnumeratorCallback

◆ IndexedPropertyGetterCallback

◆ IndexedPropertyQueryCallback

◆ IndexedPropertySetterCallback

◆ InterruptCallback

◆ JitCodeEventHandler

◆ LogEventCallback

◆ MessageCallback

◆ MicrotaskCallback

◆ MicrotasksCompletedCallback

◆ MicrotasksCompletedCallbackWithData

◆ ModifyCodeGenerationFromStringsCallback

◆ NativeObject

◆ NearHeapLimitCallback

◆ OOMErrorCallback

◆ PersistentContainerValue

◆ PrepareStackTraceCallback

◆ PromiseHook

◆ PromiseRejectCallback

◆ ReturnAddressLocationResolver

◆ SerializeEmbedderFieldsCallback

◆ SnapshotObjectId

◆ UniquePersistent

◆ WasmLoadSourceMapCallback

◆ WasmSimdEnabledCallback

◆ WasmStreamingCallback

◆ WasmThreadsEnabledCallback

Enumeration Type Documentation

◆ AccessControl

◆ AccessType

◆ ArrayBufferCreationMode

◆ CodeEventType

◆ ConstructorBehavior

◆ CpuProfilingLoggingMode

◆ CpuProfilingMode

◆ CpuProfilingNamingMode

◆ CrashKeyId