Straw man setExceptionPauseMode

runtime/vm/service/service.md

 # Dart VM Service Protocol 3.0
 
 > Please post feedback to the [observatory-discuss group][discuss-list]
 
 This document describes of _version 3.0_ of the Dart VM Service Protocol. This
 protocol is used to communicate with a running Dart Virtual Machine.
 
 To use the Service Protocol, start the VM with the *--observe* flag.
 The VM will start a webserver which services protocol requests via WebSocket.
 It is possible to make HTTP (non-WebSocket) requests,
@@ skipping 20 matching lines @@
         - [evaluateInFrame](#evaluateinframe)
         - [getFlagList](#getflaglist)
         - [getIsolate](#getisolate)
         - [getObject](#getobject)
         - [getStack](#getstack)
         - [getVersion](#getversion)
         - [getVM](#getvm)
         - [pause](#pause)
         - [removeBreakpoint](#removebreakpoint)
         - [resume](#resume)
+  - [setExceptionPauseMode](#setexceptionpausemode)

[danrubel, 2015/10/09 19:16:31]

Indent?

         - [setLibraryDebuggable](#setlibrarydebuggable)
         - [setName](#setname)
         - [setVMName](#setvmname)
         - [streamCancel](#streamcancel)
         - [streamListen](#streamlisten)
 - [Public Types](#public-types)
         - [BoundField](#boundfield)
         - [BoundVariable](#boundvariable)
         - [Breakpoint](#breakpoint)
         - [Class](#class)
@@ skipping 566 matching lines @@
 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
 
 See [Success](#success), [StepOption](#StepOption).
 
+### setExceptionPauseMode
+
+```
+Success setExceptionPauseMode(string isolateId,
+                              ExceptionPauseMode mode)
+```
+
+The _setExceptionPauseMode_ RPC is used to control if an isolate pauses when
+an exception is thrown.
+
+mode | meaning
+---- | -------
+All  | Pause isolate on all thrown exceptions
+None | Do not pause isolate on thrown exceptions

[turnidge, 2015/10/12 16:43:51]

Can we order these:

None
Unhandled
All

That way None (the initial value of this for each isolate) comes first, and they
are ordered increasingly.

[Cutch, 2015/10/12 17:51:42]

Done.

+Unhandled | Pause isolate on unhandled exceptions
+
 ### setLibraryDebuggable
 
 ```
 Success setLibraryDebuggable(string isolateId,
                              string libraryId,
                              bool isDebuggable)
 ```
 
 The _setLibraryDebuggable_ RPC is used to enable or disable whether
 breakpoints and stepping work for a given library.
@@ skipping 1388 matching lines @@
 
 ### Stack
 
 ```
 class Stack extends Response {
   Frame[] frames;
   Message[] messages;
 }
 ```
 
+### ExceptionPauseMode
+
+```
+enum ExceptionPauseMode {
+  All,
+  None,

[turnidge, 2015/10/12 16:43:51]

Can we put None first?

[Cutch, 2015/10/12 17:51:42]

Done.

+  Unhandled,
+}
+```
+
+An _ExceptionPauseMode_ indicates how the isolate pauses when an exception
+is thrown.
+
 ### StepOption
 
 ```
 enum StepOption {
   Into,
   Over,
   Out
 }
 ```
 
@@ skipping 120 matching lines @@
 ## Revision History
 
 version | comments
 ------- | --------
 1.0 | initial revision
 2.0 | Describe protocol version 2.0.
 3.0 | Describe protocol version 3.0.  Added UnresolvedSourceLocation.  Added Sentinel return to getIsolate.  Add AddedBreakpointWithScriptUri.  Removed Isolate.entry. The type of VM.pid was changed from string to int.  Added VMUpdate events.
 
 
 [discuss-list]: https://groups.google.com/a/dartlang.org/forum/#!forum/observatory-discuss