Complete live region support in ChromeVox Next.

chrome/common/extensions/api/automation.idl

Index: chrome/common/extensions/api/automation.idl
diff --git a/chrome/common/extensions/api/automation.idl b/chrome/common/extensions/api/automation.idl
index c6f02b9b9c3cce59b177f9cee2841106b663c388..579cfbd0c9a3579c498ba5637d9be80854d8a715 100644
--- a/chrome/common/extensions/api/automation.idl
+++ b/chrome/common/extensions/api/automation.idl
@@ -317,6 +317,12 @@
     TreeChangeType type;
   };
 
+  enum TreeChangeObserverMask {
+    noTreeChanges,
+    liveRegionTreeChanges,
+    allTreeChanges
+  };
+
   // A listener for changes on the <code>AutomationNode</code> tree.
   callback TreeChangeObserver = void(TreeChange treeChange);
 
@@ -578,8 +584,14 @@
     // screen views. Note this API is currently only supported on Chrome OS.
     [nocompile] static void getDesktop(RootCallback callback);
 
+    // Set the type of tree change events you want to receive when
+    // calling addTreeChangeObserver.

[Peter Lundblad, 2015/11/24 11:04:31]

If we keep this design, please add a note that the mask affects all listeners.

+    [nocompile] static void setTreeChangeObserverMask(
+        TreeChangeObserverMask mask);
+
     // Add a tree change observer. Tree change observers are static/global, they
-    // listen to changes across all trees.
+    // listen to changes across all trees. Note that you must also call
+    // setTreeChangeObserverMask for this to do anything.

[Peter Lundblad, 2015/11/24 11:04:31]

Replace 'this to do anything' with 'any listeners to be called' or similar
to be more precise.

     [nocompile] static void addTreeChangeObserver(
         TreeChangeObserver observer);