v8::RetainedObjectInfo Class Reference

#include <v8-profiler.h>

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:

1. 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.
2. 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, it can do it in a GC prologue handler, and / or by assigning wrapper class ids in the following way:

1. Bind a callback to class id by calling SetWrapperClassInfoProvider.
2. 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.

Constructor & Destructor Documentation

RetainedObjectInfo()

v8::RetainedObjectInfo::RetainedObjectInfo ( )

inlineprotected

~RetainedObjectInfo()

virtual v8::RetainedObjectInfo::~RetainedObjectInfo ( )

inlineprotectedvirtual

Member Function Documentation

Dispose()

virtual void v8::RetainedObjectInfo::Dispose ( )

pure virtual

Called by V8 when it no longer needs an instance.

GetElementCount()

virtual intptr_t v8::RetainedObjectInfo::GetElementCount ( )

inlinevirtual

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

GetGroupLabel()

virtual const char * v8::RetainedObjectInfo::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.

GetHash()

virtual intptr_t v8::RetainedObjectInfo::GetHash ( )

pure virtual

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

GetLabel()

virtual const char * v8::RetainedObjectInfo::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.

GetSizeInBytes()

virtual intptr_t v8::RetainedObjectInfo::GetSizeInBytes ( )

inlinevirtual

Returns embedder's object size in bytes.

IsEquivalent()

virtual bool v8::RetainedObjectInfo::IsEquivalent ( RetainedObjectInfo *  other )

pure virtual

Returns whether two instances are equivalent.

---

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

• include/v8-profiler.h