void kill({int priority: BEFORE_NEXT_EVENT })

Requests the isolate to shut down.

The isolate is requested to terminate itself. The priority argument specifies when this must happen.

The priority must be one of IMMEDIATE or BEFORE_NEXT_EVENT. The shutdown is performed at different times depending on the priority:

  • IMMEDIATE: The the isolate shuts down as soon as possible. Control messages are handled in order, so all previously sent control events from this isolate will all have been processed. The shutdown should happen no later than if sent with BEFORE_NEXT_EVENT. It may happen earlier if the system has a way to shut down cleanly at an earlier time, even during the execution of another event.

  • BEFORE_NEXT_EVENT: The shutdown is scheduled for the next time control returns to the event loop of the receiving isolate, after the current event, and any already scheduled control events, are completed.

Source 

external void kill({int priority: BEFORE_NEXT_EVENT});