SnapshotCreator Class Reference

#include <v8-snapshot.h>

Public Types
enum class	FunctionCodeHandling { kClear , kKeep }

Public Member Functions
	SnapshotCreator (Isolate *isolate, const intptr_t *external_references=nullptr, const StartupData *existing_blob=nullptr, bool owns_isolate=true)
	SnapshotCreator (const intptr_t *external_references=nullptr, const StartupData *existing_blob=nullptr)
	SnapshotCreator (const v8::Isolate::CreateParams &params)
	SnapshotCreator (v8::Isolate *isolate, const v8::Isolate::CreateParams &params)
	~SnapshotCreator ()
Isolate *	GetIsolate ()
void	SetDefaultContext (Local< Context > context, SerializeInternalFieldsCallback internal_fields_serializer=SerializeInternalFieldsCallback(), SerializeContextDataCallback context_data_serializer=SerializeContextDataCallback(), SerializeAPIWrapperCallback api_wrapper_serializer=SerializeAPIWrapperCallback())
size_t	AddContext (Local< Context > context, SerializeInternalFieldsCallback internal_fields_serializer=SerializeInternalFieldsCallback(), SerializeContextDataCallback context_data_serializer=SerializeContextDataCallback(), SerializeAPIWrapperCallback api_wrapper_serializer=SerializeAPIWrapperCallback())
template<class T>
V8_INLINE size_t	AddData (Local< Context > context, Local< T > object)
template<class T>
V8_INLINE size_t	AddData (Local< T > object)
StartupData	CreateBlob (FunctionCodeHandling function_code_handling)
	SnapshotCreator (const SnapshotCreator &)=delete
void	operator= (const SnapshotCreator &)=delete
template<class T>
size_t	AddData (Local< Context > context, Local< T > object)
template<class T>
size_t	AddData (Local< T > object)

Friends
class	internal::SnapshotCreatorImpl

Detailed Description

Helper class to create a snapshot data blob.

The Isolate used by a SnapshotCreator is owned by it, and will be entered and exited by the constructor and destructor, respectively; The destructor will also destroy the Isolate. Experimental language features, including those available by default, are not available while creating a snapshot.

Definition at line 135 of file v8-snapshot.h.

Member Enumeration Documentation

FunctionCodeHandling

enum class FunctionCodeHandling

strong

Enumerator
kClear
kKeep

Definition at line 137 of file v8-snapshot.h.

Constructor & Destructor Documentation

SnapshotCreator() [1/5]

SnapshotCreator ( Isolate * isolate, const intptr_t * external_references = nullptr, const StartupData * existing_blob = nullptr, bool owns_isolate = true )

explicit

Initialize and enter an isolate, and set it up for serialization. The isolate is either created from scratch or from an existing snapshot. The caller keeps ownership of the argument snapshot.

Parameters

existing_blob	existing snapshot from which to create this one.
external_references	a null-terminated array of external references that must be equivalent to CreateParams::external_references.
owns_isolate	whether this SnapshotCreator should call v8::Isolate::Dispose() during its destructor.

References SnapshotCreator(), and v8::V8_DEPRECATE_SOON().

Referenced by AddData(), operator=(), SnapshotCreator(), SnapshotCreator(), SnapshotCreator(), SnapshotCreator(), SnapshotCreator(), and ~SnapshotCreator().

SnapshotCreator() [2/5]

SnapshotCreator ( const intptr_t * external_references = nullptr, const StartupData * existing_blob = nullptr )

explicit

Create and enter an isolate, and set it up for serialization. The isolate is either created from scratch or from an existing snapshot. The caller keeps ownership of the argument snapshot.

Parameters

existing_blob	existing snapshot from which to create this one.
external_references	a null-terminated array of external references that must be equivalent to CreateParams::external_references.

References SnapshotCreator().

SnapshotCreator() [3/5]

SnapshotCreator ( const v8::Isolate::CreateParams & params )

explicit

Creates an Isolate for serialization and enters it. The creator fully owns the Isolate and will invoke v8::Isolate::Dispose() during destruction.

Parameters

params

The parameters to initialize the Isolate for. Details: params.external_references are expected to be a null-terminated array of external references. params.existing_blob is an optional snapshot blob from which can be used to initialize the new blob.

References SnapshotCreator().

SnapshotCreator() [4/5]

SnapshotCreator	(	v8::Isolate *	isolate,
		const v8::Isolate::CreateParams &	params )

Initializes an Isolate for serialization and enters it. The creator does not own the Isolate but merely initialize it properly.

Parameters

isolate

The isolate that was allocated by Isolate::Allocate()~. \param params The parameters to initialize the Isolate for. Details: -params.external_referencesare expected to be a null-terminated array of external references. -params.existing_blob` is an optional snapshot blob from which can be used to initialize the new blob.

References SnapshotCreator().

~SnapshotCreator()

~SnapshotCreator

(

)

Destroy the snapshot creator, and exit and dispose of the Isolate associated with it.

References SnapshotCreator().

SnapshotCreator() [5/5]

SnapshotCreator ( const SnapshotCreator & )

delete

References SnapshotCreator().

Member Function Documentation

AddContext()

size_t AddContext	(	Local< Context >	context,
		SerializeInternalFieldsCallback	internal_fields_serializer = SerializeInternalFieldsCallback(),
		SerializeContextDataCallback	context_data_serializer = SerializeContextDataCallback(),
		SerializeAPIWrapperCallback	api_wrapper_serializer = SerializeAPIWrapperCallback() )

Add additional context to be included in the snapshot blob. The snapshot will include the global proxy.

Parameters

internal_fields_serializer	Similar to internal_fields_serializer in SetDefaultContext() but only applies to the context being added.
context_data_serializer	Similar to context_data_serializer in SetDefaultContext() but only applies to the context being added.
api_wrapper_serializer	Similar to api_wrapper_serializer in SetDefaultContext() but only applies to the context being added.

References AddContext().

Referenced by AddContext().

AddData() [1/4]

template<class T>

V8_INLINE size_t AddData	(	Local< Context >	context,
		Local< T >	object )

Attach arbitrary V8::Data to the context snapshot, which can be retrieved via Context::GetDataFromSnapshotOnce after deserialization. This data does not survive when a new snapshot is created from an existing snapshot.

Returns

the index for retrieval.

References AddData(), and V8_INLINE.

Referenced by AddData(), AddData(), and operator=().

AddData() [2/4]

template<class T>

size_t AddData	(	Local< Context >	context,
		Local< T >	object )

Definition at line 291 of file v8-snapshot.h.

References AddData(), SnapshotCreator(), and ValueHelper::ValueAsAddress().

AddData() [3/4]

template<class T>

V8_INLINE size_t AddData

(

Local< T >

object

)

Attach arbitrary V8::Data to the isolate snapshot, which can be retrieved via Isolate::GetDataFromSnapshotOnce after deserialization. This data does not survive when a new snapshot is created from an existing snapshot.

Returns

the index for retrieval.

References AddData(), and V8_INLINE.

AddData() [4/4]

template<class T>

size_t AddData

(

Local< T >

object

)

Definition at line 296 of file v8-snapshot.h.

References AddData(), and ValueHelper::ValueAsAddress().

CreateBlob()

StartupData CreateBlob

(

FunctionCodeHandling

function_code_handling

)

Created a snapshot data blob. This must not be called from within a handle scope.

Parameters

function_code_handling

whether to include compiled function code in the snapshot.

Returns

{ nullptr, 0 } on failure, and a startup snapshot on success. The caller acquires ownership of the data array in the return value.

References CreateBlob().

Referenced by CreateBlob().

GetIsolate()

Isolate * GetIsolate

(

)

Returns

the isolate prepared by the snapshot creator.

References GetIsolate().

Referenced by GetIsolate().

operator=()

void operator= ( const SnapshotCreator & )

delete

References AddData(), internal::SnapshotCreatorImpl, and SnapshotCreator().

SetDefaultContext()

void SetDefaultContext	(	Local< Context >	context,
		SerializeInternalFieldsCallback	internal_fields_serializer = SerializeInternalFieldsCallback(),
		SerializeContextDataCallback	context_data_serializer = SerializeContextDataCallback(),
		SerializeAPIWrapperCallback	api_wrapper_serializer = SerializeAPIWrapperCallback() )

Set the default context to be included in the snapshot blob. The snapshot will not contain the global proxy, and we expect one or a global object template to create one, to be provided upon deserialization.

Parameters

internal_fields_serializer	An optional callback used to serialize internal pointer fields set by v8::Object::SetAlignedPointerInInternalField().
context_data_serializer	An optional callback used to serialize context embedder data set by v8::Context::SetAlignedPointerInEmbedderData().
api_wrapper_serializer	An optional callback used to serialize API wrapper references set via v8::Object::Wrap().

References SetDefaultContext().

Referenced by SetDefaultContext().

Friends And Related Symbol Documentation

internal::SnapshotCreatorImpl

friend class internal::SnapshotCreatorImpl

friend

Definition at line 287 of file v8-snapshot.h.

References internal::SnapshotCreatorImpl.

Referenced by internal::SnapshotCreatorImpl, and operator=().

---

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

• include/v8-snapshot.h