#include <v8-profiler.h>

Inheritance diagram for RetainedObjectInfo:

Public Member Functions
virtual void	Dispose ()=0

virtual bool	IsEquivalent (RetainedObjectInfo *other)=0

virtual intptr_t	GetHash ()=0

virtual const char *	GetLabel ()=0

virtual const char *	GetGroupLabel ()

virtual intptr_t	GetElementCount ()

virtual intptr_t	GetSizeInBytes ()

Protected Member Functions
	RetainedObjectInfo ()

virtual	~RetainedObjectInfo ()

Detailed Description

Interface for providing information about embedder's objects held by global handles. This information is reported in two ways:

When calling AddObjectGroup, an embedder may pass RetainedObjectInfo instance describing the group. To collect this information while taking a heap snapshot, V8 calls GC prologue and epilogue callbacks.
When a heap snapshot is collected, V8 additionally requests RetainedObjectInfos for persistent handles that were not previously reported via AddObjectGroup.

Thus, if an embedder wants to provide information about native objects for heap snapshots, he can do it in a GC prologue handler, and / or by assigning wrapper class ids in the following way:

Bind a callback to class id by calling SetWrapperClassInfoProvider.
Call SetWrapperClassId on certain persistent handles.

V8 takes ownership of RetainedObjectInfo instances passed to it and keeps them alive only during snapshot collection. Afterwards, they are freed by calling the Dispose class function.

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

Constructor & Destructor Documentation

RetainedObjectInfo ( )

inlineprotected

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

virtual ~RetainedObjectInfo ( )

inlineprotectedvirtual

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

Member Function Documentation

virtual void Dispose ( )

pure virtual

Called by V8 when it no longer needs an instance.

Implemented in NativeGroupRetainedObjectInfo, TestRetainedObjectInfo, and TestRetainedObjectInfo.

Referenced by GlobalHandles::AddObjectGroup(), NativeObjectsExplorer::~NativeObjectsExplorer(), and ObjectGroup::~ObjectGroup().

virtual intptr_t GetElementCount ( )

inlinevirtual

Returns element count in case if a global handle retains a subgraph by holding one of its nodes.

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

Referenced by BasicHeapEntriesAllocator::AllocateEntry(), and HeapObjectsMap::GenerateId().

virtual const char* GetGroupLabel ( )

inlinevirtual

Returns human-readable group label. It must be a null-terminated UTF-8 encoded string. V8 copies its contents during a call to GetGroupLabel. Heap snapshot generator will collect all the group names, create top level entries with these names and attach the objects to the corresponding top level group objects. There is a default implementation which is required because embedders don't have their own implementation yet.

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

virtual intptr_t GetHash ( )

pure virtual

Returns hash value for the instance. Equivalent instances must have the same hash value.

Implemented in NativeGroupRetainedObjectInfo, TestRetainedObjectInfo, and TestRetainedObjectInfo.

Referenced by HeapObjectsMap::GenerateId(), and NativeGroupRetainedObjectInfo::IsEquivalent().

virtual const char* GetLabel ( )

pure virtual

Returns human-readable label. It must be a null-terminated UTF-8 encoded string. V8 copies its contents during a call to GetLabel.

Implemented in NativeGroupRetainedObjectInfo, TestRetainedObjectInfo, and TestRetainedObjectInfo.

Referenced by BasicHeapEntriesAllocator::AllocateEntry(), HeapObjectsMap::GenerateId(), and NativeGroupRetainedObjectInfo::IsEquivalent().

virtual intptr_t GetSizeInBytes ( )