Implement actions for Automation API.

chrome/common/extensions/api/automation_internal.idl

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // This is the implementation layer of the chrome.automation API, and is
 // essentially a translation of the internal accessibility tree update system
 // into an extension API.
 namespace automationInternal {
   // A compact representation of the accessibility information for a
   // single web object, in a form that can be serialized and sent from
   // one process to another.
   // See ui/accessibility/ax_node_data.h
   dictionary AXNodeData {
     long id;
     DOMString role;
     object state;
     // TODO(aboxhall): include location data;
-    object? bool_attributes;
-    object? float_attributes;
-    object? html_attributes;
-    object? int_attributes;
-    object? intlist_attributes;
-    object? string_attributes;
-    long[] child_ids;
+    object? boolAttributes;
+    object? floatAttributes;
+    object? htmlAttributes;
+    object? intAttributes;
+    object? intlistAttributes;
+    object? stringAttributes;
+    long[] childIDs;
   };
 
   // Data for an accessibility event and/or an atomic change to an accessibility
   // tree. See ui/accessibility/ax_tree_update.h for an extended explanation of
   // the tree update format.
   dictionary AXEventParams {
+    // The process id of the renderer host.
+    long processID;
+
     // The routing id of the web contents that this update is for.
-    long routing_id;
+    long routingID;
 
     // The type of event that this update represents.
-    DOMString event_type;
+    DOMString eventType;
 
     // A vector of nodes to update according to the rules described in
     // ui/ax_tree_update.h.
     AXNodeData[] nodes;
   };
 
-  // Returns the routing_id of the tab whose accessibility was enabled using
-  // enable().
-  callback EnableCallback = void(long routing_id);
+  // All possible actions that can be performed on automation nodes.
+  enum ActionType {
+    focus,
+    do_default,
+    make_visible,
+    set_selection
+  };
+
+  // Arguments required for all actions supplied to performAction.
+  dictionary PerformActionRequiredParams {
+    long processID;
+    long routingID;
+    long automationNodeID;
+    ActionType actionType;
+  };
+
+  // Arguments for the set_selection action supplied to performAction.
+  dictionary SetSelectionParams {
+    long startIndex;
+    long endIndex;
+  };
+
+  // Returns the process id and routing id of the tab whose accessibility was
+  // enabled using enable().
+  callback EnableCallback = void(long processID, long routingID);
 
   interface Functions {
     // Enable automation of the active tab and retrieves its routing id for use
     // in future updates.
     static void enableCurrentTab(EnableCallback callback);
+
+    static void performAction(PerformActionRequiredParams args,
+                              object opt_args);

[not at google - send to devlin, 2014/04/03 18:57:13]

you could use object? here to actually indicate it's optional.

[David Tseng, 2014/04/03 23:05:19]

The schema compiler doesn't like this:
chrome/common/extensions/api/automation_internal.idl could not be parsed:
/usr/local/google/home/dtseng/projects/chrome/src/chrome/common/extensions/api/automation_internal.idl(77)
: Error : Unexpected "?" after symbol object.

I'm guessing it's only valid within dictionaries?

[not at google - send to devlin, 2014/04/04 16:30:57]

Oh interesting. JSON schema supports optional parameters but I guess IDL
mustn't.

   };
 
   interface Events {
     // Fired when an accessibility event occurs
     static void onAccessibilityEvent(AXEventParams update);
   };
 };