getStack method

Future<Stack> getStack(
  1. String isolateId, {
  2. int? limit,
  3. String? idZoneId,
})

The getStack RPC is used to retrieve the current execution stack and message queue for an isolate. The isolate does not need to be paused.

If limit is provided, up to limit frames from the top of the stack will be returned. If the stack depth is smaller than limit the entire stack is returned. Note: this limit also applies to the asyncCausalFrames stack representation in the Stack response.

If idZoneId is provided, temporary IDs for InstancesRef and Instances in the RPC response will be allocated in the specified ID zone. If idZoneId is omitted, ID allocations will be performed in the default ID zone for the isolate. See IDs and Names for more information about ID zones.

If isolateId refers to an isolate which has exited, then the Collected Sentinel is returned.

See Stack.

This method will throw a SentinelException in the case a Sentinel is returned.

Implementation

Future<Stack> getStack(String isolateId, {int? limit, String? idZoneId}) =>
    _call('getStack', {
      'isolateId': isolateId,
      if (limit != null) 'limit': limit,
      if (idZoneId != null) 'idZoneId': idZoneId,
    });