getRetainingPath method
The getRetainingPath
RPC is used to lookup a path from an object
specified by targetId
to a GC root (i.e., the object which is preventing
this object from being garbage collected).
If isolateId
refers to an isolate which has exited, then the Collected
Sentinel is returned.
If targetId
refers to a heap object which has been collected by the VM's
garbage collector, then the Collected
Sentinel is returned.
If targetId
refers to a non-heap object which has been deleted, then the
Collected
Sentinel is returned.
If the object handle has not expired and the object has not been collected, then an RetainingPath will be returned.
The limit
parameter specifies the maximum path length to be reported as
part of the retaining path. If a path is longer than limit
, it will be
truncated at the root end of the path.
See RetainingPath.
This method will throw a SentinelException in the case a Sentinel is returned.
Implementation
Future<RetainingPath> getRetainingPath(
String isolateId, String targetId, int limit) =>
_call('getRetainingPath',
{'isolateId': isolateId, 'targetId': targetId, 'limit': limit});