Chrome DevTools Protocol (original) (raw)

Methods

HeapProfiler.addInspectedHeapObject#

Enables console to refer to the node with given id via x(seeCommandLineAPIformoredetailsx (see Command Line API for more details x(seeCommandLineAPIformoredetailsx functions).

parameters

heapObjectId

HeapSnapshotObjectId

Heap snapshot object id to be accessible by means of $x command line API.

HeapProfiler.collectGarbage#

HeapProfiler.disable#

HeapProfiler.enable#

HeapProfiler.getHeapObjectId#

parameters

objectId

Runtime.RemoteObjectId

Identifier of the object to get heap object id for.

Return Object

heapSnapshotObjectId

HeapSnapshotObjectId

Id of the heap snapshot object corresponding to the passed remote object id.

HeapProfiler.getObjectByHeapObjectId#

parameters

objectId

HeapSnapshotObjectId

objectGroup

string

Symbolic group name that can be used to release multiple objects.

Return Object

result

Runtime.RemoteObject

Evaluation result.

HeapProfiler.getSamplingProfile#

Return Object

profile

SamplingHeapProfile

Return the sampling profile being collected.

HeapProfiler.startSampling#

parameters

samplingInterval

number

Average sample interval in bytes. Poisson distribution is used for the intervals. The default value is 32768 bytes.

includeObjectsCollectedByMajorGC

boolean

By default, the sampling heap profiler reports only objects which are still alive when the profile is returned via getSamplingProfile or stopSampling, which is useful for determining what functions contribute the most to steady-state memory usage. This flag instructs the sampling heap profiler to also include information about objects discarded by major GC, which will show which functions cause large temporary memory usage or long GC pauses.

includeObjectsCollectedByMinorGC

boolean

By default, the sampling heap profiler reports only objects which are still alive when the profile is returned via getSamplingProfile or stopSampling, which is useful for determining what functions contribute the most to steady-state memory usage. This flag instructs the sampling heap profiler to also include information about objects discarded by minor GC, which is useful when tuning a latency-sensitive application for minimal GC activity.

HeapProfiler.startTrackingHeapObjects#

parameters

trackAllocations

boolean

HeapProfiler.stopSampling#

Return Object

profile

SamplingHeapProfile

Recorded sampling heap profile.

HeapProfiler.stopTrackingHeapObjects#

parameters

reportProgress

boolean

If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken when the tracking is stopped.

treatGlobalObjectsAsRoots

boolean

Deprecated in favor of exposeInternals.

Deprecated

captureNumericValue

boolean

If true, numerical values are included in the snapshot

exposeInternals

boolean

If true, exposes internals of the snapshot.

Experimental

HeapProfiler.takeHeapSnapshot#

parameters

reportProgress

boolean

If true 'reportHeapSnapshotProgress' events will be generated while snapshot is being taken.

treatGlobalObjectsAsRoots

boolean

If true, a raw snapshot without artificial roots will be generated. Deprecated in favor of exposeInternals.

Deprecated

captureNumericValue

boolean

If true, numerical values are included in the snapshot

exposeInternals

boolean

If true, exposes internals of the snapshot.

Experimental

Events

HeapProfiler.addHeapSnapshotChunk#

parameters

chunk

string

HeapProfiler.heapStatsUpdate#

If heap objects tracking has been started then backend may send update for one or more fragments

parameters

statsUpdate

array[ integer ]

An array of triplets. Each triplet describes a fragment. The first integer is the fragment index, the second integer is a total count of objects for the fragment, the third integer is a total size of the objects for the fragment.

HeapProfiler.lastSeenObjectId#

If heap objects tracking has been started then backend regularly sends a current value for last seen object id and corresponding timestamp. If the were changes in the heap since last event then one or more heapStatsUpdate events will be sent before a new lastSeenObjectId event.

parameters

lastSeenObjectId

integer

timestamp

number

HeapProfiler.reportHeapSnapshotProgress#

parameters

done

integer

total

integer

finished

boolean

HeapProfiler.resetProfiles#

Types

HeapProfiler.HeapSnapshotObjectId#

Heap snapshot object id.

Type: string

HeapProfiler.SamplingHeapProfileNode#

Sampling Heap Profile node. Holds callsite information, allocation statistics and child nodes.

Type: object

properties

callFrame

Runtime.CallFrame

Function location.

selfSize

number

Allocations size in bytes for the node excluding children.

id

integer

Node id. Ids are unique across all profiles collected between startSampling and stopSampling.

children

array[ SamplingHeapProfileNode ]

Child nodes.

HeapProfiler.SamplingHeapProfileSample#

A single sample from a sampling profile.

Type: object

properties

size

number

Allocation size in bytes attributed to the sample.

nodeId

integer

Id of the corresponding profile tree node.

ordinal

number

Time-ordered sample ordinal number. It is unique across all profiles retrieved between startSampling and stopSampling.