#include <v8-isolate.h>

Public Member Functions
	IsolateGroup (IsolateGroup &&other)

IsolateGroup &	operator= (IsolateGroup &&other)

	IsolateGroup (const IsolateGroup &)

IsolateGroup &	operator= (const IsolateGroup &)

	~IsolateGroup ()

bool	operator== (const IsolateGroup &other) const

bool	operator!= (const IsolateGroup &other) const

Static Public Member Functions
static IsolateGroup	GetDefault ()

static bool	CanCreateNewGroups ()

static IsolateGroup	Create ()

Friends
class	Isolate

class	ArrayBuffer::Allocator

Detailed Description

The set of V8 isolates in a process is partitioned into groups. Each group has its own sandbox (if V8 was configured with support for the sandbox) and pointer-compression cage (if configured with pointer compression).

By default, all isolates are placed in the same group. This is the most efficient configuration in terms of speed and memory use. However, with pointer compression enabled, total heap usage of isolates in a group cannot exceed 4 GB, not counting array buffers and other off-heap storage. Using multiple isolate groups can allow embedders to allocate more than 4GB of objects with pointer compression enabled, if the embedder's use case can span multiple isolates.

Creating an isolate group reserves a range of virtual memory addresses. A group's memory mapping will be released when the last isolate in the group is disposed, and there are no more live IsolateGroup objects that refer to it.

Note that Isolate groups are reference counted, and the IsolateGroup type is a reference to one.

Note that it's not going to be possible to pass shared JS objects across IsolateGroup boundary.

Definition at line 218 of file v8-isolate.h.

Constructor & Destructor Documentation

◆ IsolateGroup() [1/2]

IsolateGroup ( IsolateGroup && other )

References IsolateGroup().

Referenced by ArrayBuffer::Allocator, Create(), GetDefault(), IsolateGroup(), IsolateGroup(), operator!=(), operator=(), operator=(), and operator==().

◆ IsolateGroup() [2/2]

IsolateGroup ( const IsolateGroup & )

References IsolateGroup().

◆ ~IsolateGroup()

~IsolateGroup ( )

Member Function Documentation

◆ CanCreateNewGroups()

static bool CanCreateNewGroups ( )

static

Return true if new isolate groups can be created at run-time, or false if all isolates must be in the same group.

◆ Create()

static IsolateGroup Create ( )

static

Create a new isolate group. If this V8's build configuration only supports a single group, abort.

References IsolateGroup().

◆ GetDefault()

static IsolateGroup GetDefault ( )

static

Get the default isolate group. If this V8's build configuration only supports a single group, this is a reference to that single group. Otherwise this is a group like any other, distinguished only in that it is the first group.

References IsolateGroup().