Skip to main content

Interface: IHeapStringNode

Defined in: core/src/lib/Types.ts:2221

An IHeapStringNode instance represents a JS string in a heap snapshot. A heap snapshot is generally a graph where graph nodes are JS heap objects and graph edges are JS references among JS heap objects.

it is not recommended to modify any IHeapStringNode instance

  • Examples: V8 or hermes heap snapshot can be parsed by the getFullHeapFromFile API.
import type {IHeapSnapshot, IHeapNode, IHeapStringNode} from '@memlab/core';
import {dumpNodeHeapSnapshot} from '@memlab/core';
import {getFullHeapFromFile} from '@memlab/heap-analysis';

(async function () {
  const heapFile = dumpNodeHeapSnapshot();
  const heap: IHeapSnapshot = await getFullHeapFromFile(heapFile);

  // iterate over each node (heap object)
  heap.nodes.forEach((node: IHeapNode, i: number) => {
    if (node.isString) {
      const stringNode: IHeapStringNode = node.toStringNode();
      // get the string value
      stringNode.stringValue;
    }
  });
})();

Extends​

Properties​

dominatorNode​

dominatorNode: Nullable\<IHeapNode>

Defined in: core/src/lib/Types.ts:1905

Gets the dominator node of this node. If the dominator node gets released there will be no path from GC to this node, and therefore this node can also be released. For more information on what a dominator node is, please check out this doc.

Inherited from​

IHeapNode.dominatorNode

edge_count​

edge_count: number

Defined in: core/src/lib/Types.ts:1859

The total number of outgoing JS references (including engine-internal, native, and JS references).

Inherited from​

IHeapNode.edge_count

findAnyReference()​

findAnyReference: (predicate) => Nullable\<IHeapEdge>

Defined in: core/src/lib/Types.ts:1997

Executes a provided predicate callback once for each JavaScript reference in the hosting node (or outgoing edges from the node) until the predicate returns true.

Parameters​

predicate​

Predicator\<IHeapEdge>

the callback for each outgoing JavaScript reference

Returns​

Nullable\<IHeapEdge>

the first outgoing edge for which the predicate returns true, otherwise returns null if no such edge is found.

  • Examples:
const reference = node.findAnyReference((edge: IHeapEdge) => {
  // find the outgoing reference with name "ref"
  return edge.name_or_index === 'ref';
});

Inherited from​

IHeapNode.findAnyReference

findAnyReferrer()​

findAnyReferrer: (predicate) => Nullable\<IHeapEdge>

Defined in: core/src/lib/Types.ts:2014

Executes a provided predicate callback once for each JavaScript reference pointing to the hosting node (or incoming edges to the node) until the predicate returns true.

Parameters​

predicate​

Predicator\<IHeapEdge>

the callback for each incoming JavaScript reference

Returns​

Nullable\<IHeapEdge>

the first incoming edge for which the predicate returns true, otherwise returns null if no such edge is found.

  • Examples:
const referrer = node.findAnyReferrer((edge: IHeapEdge) => {
  // find the incoming reference with name "ref"
  return edge.name_or_index === 'ref';
});

Inherited from​

IHeapNode.findAnyReferrer

findReferrerNodes()​

findReferrerNodes: (predicate) => IHeapNode[]

Defined in: core/src/lib/Types.ts:2067

Executes a provided predicate callback once for each JavaScript heap object (heap graph node) pointing to the hosting node (or nodes having edges to the hosting node).

Parameters​

predicate​

Predicator\<IHeapNode>

the callback for each referrer nodes

Returns​

IHeapNode[]

an array containing all the referrer nodes for which the predicate returns true, otherwise returns an empty array if no such node is found.

  • Examples:
const referrerNodes = node.findReferrerNodes((node: IHeapNode) => {
  // find all the referring nodes with name "Parent"
  return node.name === 'Parent';
});

Inherited from​

IHeapNode.findReferrerNodes

findReferrers()​

findReferrers: (predicate) => IHeapEdge[]

Defined in: core/src/lib/Types.ts:2049

Executes a provided predicate callback once for each JavaScript reference pointing to the hosting node (or incoming edges to the node).

Parameters​

predicate​

Predicator\<IHeapEdge>

the callback for each incoming JavaScript reference

Returns​

IHeapEdge[]

an array containing all the incoming edges for which the predicate returns true, otherwise returns an empty array if no such edge is found.

  • Examples:
const referrers = node.findReferrers((edge: IHeapEdge) => {
  // find all the incoming references with name "ref"
  return edge.name_or_index === 'ref';
});

Inherited from​

IHeapNode.findReferrers

getAnyReferrer()​

getAnyReferrer: (edgeName, edgeType?) => Nullable\<IHeapEdge>

Defined in: core/src/lib/Types.ts:2122

Given a JS reference's name and type, this API finds an incoming JS reference pointing to the hosting node.

Parameters​

edgeName​

the name of the incoming JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the incoming JavaScript reference

Returns​

Nullable\<IHeapEdge>

the incoming edge that meets the specification

  • Examples:
// find one of the JS reference named "ref" pointing to node
const reference = node.getAnyReferrer('ref', 'property');

Inherited from​

IHeapNode.getAnyReferrer

getAnyReferrerNode()​

getAnyReferrerNode: (edgeName, edgeType?) => Nullable\<IHeapNode>

Defined in: core/src/lib/Types.ts:2145

Given a JS reference's name and type, this API finds one of the incoming JS references pointing to the hosting node, and returns the JS heap object containing the incoming reference.

Parameters​

edgeName​

the name of the incoming JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the incoming JavaScript reference

Returns​

Nullable\<IHeapNode>

the node containing the incoming JS reference that meets the specification

  • Examples:
// find one of the JS heap object with a JS reference
// named "ref" pointing to node
const n1 = node.getAnyReferrerNode('ref', 'property');
// this is equivalent to
const n2 = node.getAnyReferrer('ref', 'property')?.fromNode;

Inherited from​

IHeapNode.getAnyReferrerNode

getReference()​

getReference: (edgeName, edgeType?) => Nullable\<IHeapEdge>

Defined in: core/src/lib/Types.ts:2082

Given a JS reference's name and type, this API finds an outgoing JS reference from the hosting node.

Parameters​

edgeName​

the name of the outgoing JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the outgoing JavaScript reference

Returns​

Nullable\<IHeapEdge>

the outgoing edge that meets the specification

  • Examples:
// find the internal reference to node's hidden class
const reference = node.getReference('map', 'hidden');

Inherited from​

IHeapNode.getReference

getReferenceNode()​

getReferenceNode: (edgeName, edgeType?) => Nullable\<IHeapNode>

Defined in: core/src/lib/Types.ts:2104

Given a JS reference's name and type, this API finds the outgoing JS reference from the hosting node, and returns the JS heap object pointed to by the outgoing JS reference.

Parameters​

edgeName​

the name of the outgoing JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the outgoing JavaScript reference

Returns​

Nullable\<IHeapNode>

the node pointed to by the outgoing reference that meets the specification

  • Examples:
// find the node's hidden class
const hiddenClassNode = node.getReferenceNode('map', 'hidden');
// this is equivalent to
const hiddenClassNode2 = node.getReference('map', 'hidden')?.toNode;

Inherited from​

IHeapNode.getReferenceNode

getReferrerNodes()​

getReferrerNodes: (edgeName, edgeType?) => IHeapNode[]

Defined in: core/src/lib/Types.ts:2185

Given a JS reference's name and type, this API finds all of the incoming JS references pointing to the hosting node, and returns an array containing the hosting node for each of the incoming JS references.

Parameters​

edgeName​

the name of the incoming JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the incoming JavaScript reference

Returns​

IHeapNode[]

an array containing the hosting nodes, with each node corresponds to each incoming JS reference that meets the specification

  • Examples:
// find all of the JS heap objects with a JS reference
// named "ref" pointing to node
const nodes1 = node.getReferrerNodes('ref', 'property');
// this is equivalent to
const nodes2 = node.getReferrers('ref', 'property')
  .map(edge => edge.fromNode);

Inherited from​

IHeapNode.getReferrerNodes

getReferrers()​

getReferrers: (edgeName, edgeType?) => IHeapEdge[]

Defined in: core/src/lib/Types.ts:2164

Given a JS reference's name and type, this API finds all the incoming JS references pointing to the hosting node.

Parameters​

edgeName​

the name of the incoming JavaScript reference

string | number

edgeType?​

string

optional parameter specifying the type of the incoming JavaScript reference

Returns​

IHeapEdge[]

an array containing all the incoming edges that meet the specification

  • Examples:
// find all of the JS references named "ref" pointing to node
const referrers = node.getReferrers('ref', 'property');

Inherited from​

IHeapNode.getReferrers

hasPathEdge​

hasPathEdge: boolean

Defined in: core/src/lib/Types.ts:1881

Returns true if the heap node has been set an incoming edge which leads to the parent node on the shortest path to GC root.

Inherited from​

IHeapNode.hasPathEdge

id​

id: number

Defined in: core/src/lib/Types.ts:1787

Unique id of the heap object.

Inherited from​

IHeapNode.id

is_detached​

is_detached: boolean

Defined in: core/src/lib/Types.ts:1841

  • If the heap object is a DOM element and the DOM element is detached from the DOM tree, is_detached will be true;
  • If the heap object is a React Fiber node and the Fiber node is unmounted from the React Fiber tree, is_detached will be true; otherwise it will be false.

Inherited from​

IHeapNode.is_detached

isString​

isString: boolean

Defined in: core/src/lib/Types.ts:1917

Checks if this is a string node (normal string node, concatenated string node or sliced string node).

Inherited from​

IHeapNode.isString

location​

location: Nullable\<IHeapLocation>

Defined in: core/src/lib/Types.ts:1910

Source location information of this heap object (if it is recorded by the heap snapshot).

Inherited from​

IHeapNode.location

name​

name: string

Defined in: core/src/lib/Types.ts:1783

This is the name field associated with the heap object. For JS object instances (type object), name is the constructor's name of the object instance. For string, name is the string value.

Inherited from​

IHeapNode.name

nodeIndex​

nodeIndex: number

Defined in: core/src/lib/Types.ts:1890

Index of this heap object inside the node.snapshot.nodes pseudo array.

Inherited from​

IHeapNode.nodeIndex

numOfReferrers​

numOfReferrers: number

Defined in: core/src/lib/Types.ts:1876

Gets the number of all incoming references pointing to this heap object (including engine-internal, native, and JS references).

Inherited from​

IHeapNode.numOfReferrers

pathEdge​

pathEdge: IHeapEdge | null

Defined in: core/src/lib/Types.ts:1886

The incoming edge which leads to the parent node on the shortest path to GC root.

Inherited from​

IHeapNode.pathEdge

references​

references: IHeapEdge[]

Defined in: core/src/lib/Types.ts:1866

Gets a JS array containing all outgoing JS references from this heap object (including engine-internal, native, and JS references).

Inherited from​

IHeapNode.references

referrers​

referrers: IHeapEdge[]

Defined in: core/src/lib/Types.ts:1871

Gets a JS array containing all incoming JS references pointing to this heap object (including engine-internal, native, and JS references).

Inherited from​

IHeapNode.referrers

retainedSize​

retainedSize: number

Defined in: core/src/lib/Types.ts:1897

The retained size of the heap object (i.e., the total size of memory that could be released if this object is released). For difference between retained size and shallow size, check out this doc.

Inherited from​

IHeapNode.retainedSize

self_size​

self_size: number

Defined in: core/src/lib/Types.ts:1854

The shallow size of the heap object (i.e., the size of memory that is held by the object itself). For difference between shallow size and retained size, check out this doc.

Inherited from​

IHeapNode.self_size

snapshot​

snapshot: IHeapSnapshot

Defined in: core/src/lib/Types.ts:1833

Gets the IHeapSnapshot containing this heap object.

Inherited from​

IHeapNode.snapshot

stringValue​

stringValue: string

Defined in: core/src/lib/Types.ts:2226

Gets the string value of the JS string heap object associated with this IHeapStringNode instance in heap.

type​

type: string

Defined in: core/src/lib/Types.ts:1777

The type of the heap node object. All possible types: This is engine-specific, for example all types in V8: hidden, array, string, object, code, closure, regexp, number, native, synthetic, concatenated string, sliced string, symbol, bigint

Inherited from​

IHeapNode.type

Methods​

findAnyReferrerNode()​

findAnyReferrerNode(predicate): Nullable\<IHeapNode>

Defined in: core/src/lib/Types.ts:2032

Executes a provided predicate callback once for each JavaScript heap object (heap graph node) pointing to the hosting node (or nodes having edges to the hosting node) until the predicate returns true.

Parameters​

predicate​

Predicator\<IHeapNode>

the callback for each incoming JavaScript heap object

Returns​

Nullable\<IHeapNode>

the first referring node for which the predicate returns true, otherwise returns null if no such node is found.

  • Examples:
const referrer = node.findAnyReferrerNode((node: IHeapNode) => {
  // find the referring node with name "Parent"
  return node.name === 'Parent';
});

Inherited from​

IHeapNode.findAnyReferrerNode

forEachReference()​

forEachReference(callback): void

Defined in: core/src/lib/Types.ts:1962

Executes a provided callback once for each JavaScript reference in the hosting node (or outgoing edges from the node).

Parameters​

callback​

EdgeIterationCallback

the callback for each outgoing JavaScript reference

Returns​

void

this API returns void

  • Examples:
node.forEachReference((edge: IHeapEdge) => {
  // process edge ...

  // if no need to iterate over remaining edges after
  // the current edge in the node.references list
  return {stop: true};
});

Inherited from​

IHeapNode.forEachReference

forEachReferrer()​

forEachReferrer(callback): void

Defined in: core/src/lib/Types.ts:1980

Executes a provided callback once for each JavaScript reference pointing to the hosting node (or incoming edges to the node).

Parameters​

callback​

EdgeIterationCallback

the callback for each incoming JavaScript reference

Returns​

void

this API returns void

  • Examples:
node.forEachReferrer((edge: IHeapEdge) => {
  // process edge ...

  // if no need to iterate over remaining edges after
  // the current edge in the node.referrers list
  return {stop: true};
});

Inherited from​

IHeapNode.forEachReferrer

getJSONifyableObject()​

getJSONifyableObject(): AnyRecord

Defined in: core/src/lib/Types.ts:1931

Converts to a concise readable object that can be used for serialization (like calling JSON.stringify(node, ...args)).

This API does not contain all the information captured by the hosting object.

Returns​

AnyRecord

Inherited from​

IHeapNode.getJSONifyableObject

toJSONString()​

toJSONString(...args): string

Defined in: core/src/lib/Types.ts:1944

Converts to a concise readable string output (like calling JSON.stringify(node, ...args)).

Note: Please be aware that using JSON.stringify(node, ...args) is not recommended as it will generate a JSON representation of the host object that is too large to be easily readable due to its connections to other parts of the data structures within the heap snapshot.

This API does not completely serialize all the information captured by the hosting object.

Parameters​

args​

...any[]

Returns​

string

Inherited from​

IHeapNode.toJSONString

toStringNode()​

toStringNode(): Nullable\<IHeapStringNode>

Defined in: core/src/lib/Types.ts:1923

Converts to an IHeapStringNode object if this node is a string node. The IHeapStringNode object supports querying the string content inside the string node.

Returns​

Nullable\<IHeapStringNode>

Inherited from​

IHeapNode.toStringNode