Implement AutomationNode.querySelector().

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 {
   dictionary Rect {
     long left;
@@ skipping 67 matching lines @@
     long automationNodeID;
     ActionType actionType;
   };
 
   // Arguments for the set_selection action supplied to performAction.
   dictionary SetSelectionParams {
     long startIndex;
     long endIndex;
   };
 
+  dictionary QuerySelectorRequiredParams {

[Devlin, 2014/10/29 21:23:43]

comments.

[aboxhall, 2014/10/30 18:34:18]

Done.

+    long processID;
+    long routingID;
+    long automationNodeID;
+    DOMString selector;
+  };
+
   // Returns the process id and routing id of the tab whose accessibility was
   // enabled using enable().
   callback EnableTabCallback = void(long processID, long routingID);
 
   // Callback called when enableDesktop() returns.
   callback EnableDesktopCallback = void();
 
+  callback QuerySelectorCallback = void(long resultAutomationNodeID);
+
   interface Functions {
     // Enable automation of the tab with the given id, or the active tab if no
     // tab id is given, and retrieves its process and routing ids for use in
     // future updates.
     static void enableTab(optional long tabId, EnableTabCallback callback);
 
     // Enables desktop automation.
     static void enableDesktop(EnableDesktopCallback callback);
 
     // Performs an action on an automation node.
     static void performAction(PerformActionRequiredParams args,
                               object opt_args);
+
+    // Performs a query selector query. Calls the callback with a request ID to

[Devlin, 2014/10/29 21:23:43]

It's odd that this is the only place you use the term "request ID" instead of
"automationNodeID" - if they're the same thing, stick to one name (if they're
not, what is a request id?)

[aboxhall, 2014/10/30 18:34:18]

Ah, that comment is out of date - fixed.

+    // be used in matching the response to the request.
+    static void querySelector(QuerySelectorRequiredParams args,
+                              QuerySelectorCallback callback);
   };
 
   interface Events {
     // Fired when an accessibility event occurs
     static void onAccessibilityEvent(AXEventParams update);
 
     static void onAccessibilityTreeDestroyed(long processID, long routingID);
   };
 };