Add custom action support

chrome/common/extensions/api/automation.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.
 
 // The <code>chrome.automation</code> API allows developers to access the
 // automation (accessibility) tree for the browser. The tree resembles the DOM
 // tree, but only exposes the <em>semantic</em> structure of a page. It can be
 // used to programmatically interact with a page by examining names, roles, and
 // states, listening for events, and performing actions on nodes.
 [nocompile] namespace automation {
@@ skipping 349 matching lines @@
   enum TreeChangeObserverFilter {
     noTreeChanges,
     liveRegionTreeChanges,
     textMarkerChanges,
     allTreeChanges
   };
 
   // A listener for changes on the <code>AutomationNode</code> tree.
   callback TreeChangeObserver = void(TreeChange treeChange);
 
+  dictionary CustomAction {
+    long id;
+    DOMString description;
+  };
+
   // A single node in an Automation tree.
   [nocompile, noinline_doc] dictionary AutomationNode {
     // The root node of the tree containing this AutomationNode.
     AutomationNode? root;
 
     // Whether this AutomationNode is a root node.
     boolean isRootNode;
 
     // The role of this node.
     RoleType? role;
@@ skipping 60 matching lines @@
     // name, via the $(ref:automation.AutomationNode.name) attribute.
     AutomationNode[]? labelledBy;
 
     // The node referred to by <code>aria-activedescendant</code>, where
     // applicable
     AutomationNode? activeDescendant;
 
     // The target of an in-page link.
     AutomationNode? inPageLinkTarget;
 
+    // An array of custom actions.
+    CustomAction[]? customActions;
+
     //
     // Link attributes.
     //
 
     // The URL that this link will navigate to.
     DOMString? url;
 
     //
     // Document attributes.
     //
@@ skipping 241 matching lines @@
     // original size.
     static void getImageData(long maxWidth, long maxHeight);
 
     // Does a hit test of the given global screen coordinates, and fires
     // eventToFire on the resulting object.
     static void hitTest(long x, long y, EventType eventToFire);
 
     // Scrolls this node to make it visible.
     static void makeVisible();
 
+    // Performs custom action.
+    static void performCustomAction(long customActionId);

[dmazzoni, 2017/06/06 03:06:00]

Would it be cleaner if this took a CustomAction as its argument, then
we extract the action id inside the internal bindings?

[yawano, 2017/06/08 09:25:29]

Done. Yes, also it should be more extensible.

+
     // Sets selection within a text field.
     static void setSelection(long startIndex, long endIndex);
 
     // Clears focus and sets this node as the starting point for the next
     // time the user presses Tab or Shift+Tab.
     static void setSequentialFocusNavigationStartingPoint();
 
     // Show the context menu for this element, as if the user right-clicked.
     static void showContextMenu();
 
@@ skipping 84 matching lines @@
     // Everything in the tree between the two node/offset pairs gets included
     // in the selection. The anchor is where the user started the selection,
     // while the focus is the point at which the selection gets extended
     // e.g. when dragging with a mouse or using the keyboard. For nodes with
     // the role staticText, the offset gives the character offset within
     // the value where the selection starts or ends, respectively.
     [nocompile] static void setDocumentSelection(
         SetDocumentSelectionParams params);
   };
 };