resume method

  1. @override
Future<Success> resume(
  1. String isolateId, {
  2. String? step,
  3. int? frameIndex,
})
override

The resume RPC is used to resume execution of a paused isolate.

If the step parameter is not provided, the program will resume regular execution.

If the step parameter is provided, it indicates what form of single-stepping to use.

step meaning
Into Single step, entering function calls
Over Single step, skipping over function calls
Out Single step until the current function exits
Rewind Immediately exit the top frame(s) without executing any code.
Isolate will be paused at the call of the last exited function.

The frameIndex parameter is only used when the step parameter is Rewind. It specifies the stack frame to rewind to. Stack frame 0 is the currently executing function, so frameIndex must be at least 1.

If the frameIndex parameter is not provided, it defaults to 1.

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

See Success, StepOption.

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

Implementation

@override
Future<Success> resume(String isolateId,
        {/*StepOption*/ String? step, int? frameIndex}) =>
    _call('resume', {
      'isolateId': isolateId,
      if (step != null) 'step': step,
      if (frameIndex != null) 'frameIndex': frameIndex,
    });