Add custom action support

third_party/closure_compiler/externs/automation.js

 // Copyright 2017 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 file was generated by:
-//   tools/json_schema_compiler/compiler.py.
+//   ./tools/json_schema_compiler/compiler.py.
 // NOTE: The format of types has changed. 'FooType' is now
 //   'chrome.automation.FooType'.
 // Please run the closure compiler before committing changes.
 // See https://chromium.googlesource.com/chromium/src/+/master/docs/closure_compilation.md
 
 /** @fileoverview Externs generated from namespace: automation */
 
 /**
  * @const
  */
@@ skipping 66 matching lines @@
   APPLICATION: 'application',
   ARTICLE: 'article',
   AUDIO: 'audio',
   BANNER: 'banner',
   BLOCKQUOTE: 'blockquote',
   BUSY_INDICATOR: 'busyIndicator',
   BUTTON: 'button',
   BUTTON_DROP_DOWN: 'buttonDropDown',
   CANVAS: 'canvas',
   CAPTION: 'caption',
+  CARET: 'caret',
   CELL: 'cell',
   CHECK_BOX: 'checkBox',
   CLIENT: 'client',
   COLOR_WELL: 'colorWell',
   COLUMN_HEADER: 'columnHeader',
   COLUMN: 'column',
   COMBO_BOX: 'comboBox',
   COMPLEMENTARY: 'complementary',
   CONTENT_INFO: 'contentInfo',
   DATE: 'date',
   DATE_TIME: 'dateTime',
   DEFINITION: 'definition',
   DESCRIPTION_LIST_DETAIL: 'descriptionListDetail',
   DESCRIPTION_LIST: 'descriptionList',
   DESCRIPTION_LIST_TERM: 'descriptionListTerm',
   DESKTOP: 'desktop',
   DETAILS: 'details',
   DIALOG: 'dialog',
   DIRECTORY: 'directory',
   DISCLOSURE_TRIANGLE: 'disclosureTriangle',
+  // TODO(yawano): Remove div from extern file. This role no longer exists.
   DIV: 'div',
   DOCUMENT: 'document',
   EMBEDDED_OBJECT: 'embeddedObject',
   FEED: 'feed',
   FIGCAPTION: 'figcaption',
   FIGURE: 'figure',
   FOOTER: 'footer',
   FORM: 'form',
+  GENERIC_CONTAINER: 'genericContainer',
   GRID: 'grid',
   GROUP: 'group',
   HEADING: 'heading',
   IFRAME: 'iframe',
   IFRAME_PRESENTATIONAL: 'iframePresentational',
   IGNORED: 'ignored',
   IMAGE_MAP_LINK: 'imageMapLink',
   IMAGE_MAP: 'imageMap',
   IMAGE: 'image',
   INLINE_TEXT_BOX: 'inlineTextBox',
@@ skipping 76 matching lines @@
   WEB_VIEW: 'webView',
   WINDOW: 'window',
 };
 
 /**
  * @enum {string}
  * @see https://developer.chrome.com/extensions/automation#type-StateType
  */
 chrome.automation.StateType = {
   BUSY: 'busy',
-  CHECKED: 'checked',
   COLLAPSED: 'collapsed',
   DEFAULT: 'default',
   DISABLED: 'disabled',
   EDITABLE: 'editable',
   EXPANDED: 'expanded',
   FOCUSABLE: 'focusable',
   FOCUSED: 'focused',
   HASPOPUP: 'haspopup',
   HORIZONTAL: 'horizontal',
   HOVERED: 'hovered',
@@ skipping 25 matching lines @@
   NODE_REMOVED: 'nodeRemoved',
 };
 
 /**
  * @enum {string}
  * @see https://developer.chrome.com/extensions/automation#type-NameFromType
  */
 chrome.automation.NameFromType = {
   UNINITIALIZED: 'uninitialized',
   ATTRIBUTE: 'attribute',
+  ATTRIBUTE_EXPLICITLY_EMPTY: 'attributeExplicitlyEmpty',
   CONTENTS: 'contents',
   PLACEHOLDER: 'placeholder',
   RELATED_ELEMENT: 'relatedElement',
   VALUE: 'value',
 };
 
 /**
  * @typedef {{
  *   left: number,
  *   top: number,
@@ skipping 87 matching lines @@
  * @see https://developer.chrome.com/extensions/automation#type-TreeChangeObserverFilter
  */
 chrome.automation.TreeChangeObserverFilter = {
   NO_TREE_CHANGES: 'noTreeChanges',
   LIVE_REGION_TREE_CHANGES: 'liveRegionTreeChanges',
   TEXT_MARKER_CHANGES: 'textMarkerChanges',
   ALL_TREE_CHANGES: 'allTreeChanges',
 };
 
 /**
+ * @typedef {{
+ *   id: number,
+ *   description: string
+ * }}
+ * @see https://developer.chrome.com/extensions/automation#type-CustomAction
+ */
+chrome.automation.CustomAction;
+
+/**
  * @constructor
  * @private
  * @see https://developer.chrome.com/extensions/automation#type-AutomationNode
  */
 chrome.automation.AutomationNode = function() {};
 
 /**
  * The root node of the tree containing this AutomationNode.
  * @type {(!chrome.automation.AutomationNode|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-root
@@ skipping 138 matching lines @@
 chrome.automation.AutomationNode.prototype.activeDescendant;
 
 /**
  * The target of an in-page link.
  * @type {(!chrome.automation.AutomationNode|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-inPageLinkTarget
  */
 chrome.automation.AutomationNode.prototype.inPageLinkTarget;
 
 /**
+ * An array of custom actions.
+ * @type {(!Array<!chrome.automation.CustomAction>|undefined)}
+ * @see https://developer.chrome.com/extensions/automation#type-customActions
+ */
+chrome.automation.AutomationNode.prototype.customActions;
+
+/**
  * The URL that this link will navigate to.
  * @type {(string|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-url
  */
 chrome.automation.AutomationNode.prototype.url;
 
 /**
  * The URL of this document.
  * @type {(string|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-docUrl
@@ skipping 374 matching lines @@
 chrome.automation.AutomationNode.prototype.imageDataUrl;
 
 /**
  * The language code for this subtree.
  * @type {(string|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-language
  */
 chrome.automation.AutomationNode.prototype.language;
 
 /**
- * If a checkbox or toggle button is in the mixed state.
- * @type {(boolean|undefined)}
- * @see https://developer.chrome.com/extensions/automation#type-buttonMixed
+ * Tri-state describing checkbox or radio button: 'false' | 'true' | 'mixed'
+ * @type {(string|undefined)}
+ * @see https://developer.chrome.com/extensions/automation#type-checked
  */
-chrome.automation.AutomationNode.prototype.buttonMixed;
+chrome.automation.AutomationNode.prototype.checked;
 
 /**
  * The RGBA foreground color of this subtree, as an integer.
  * @type {(number|undefined)}
  * @see https://developer.chrome.com/extensions/automation#type-color
  */
 chrome.automation.AutomationNode.prototype.color;
 
 /**
  * The RGBA background color of this subtree, as an integer.
@@ skipping 98 matching lines @@
  */
 chrome.automation.AutomationNode.prototype.hitTest = function(x, y, eventToFire) {};
 
 /**
  * Scrolls this node to make it visible.
  * @see https://developer.chrome.com/extensions/automation#method-makeVisible
  */
 chrome.automation.AutomationNode.prototype.makeVisible = function() {};
 
 /**
+ * Performs custom action.
+ * @param {number} customActionId
+ * @see https://developer.chrome.com/extensions/automation#method-performCustomAction
+ */
+chrome.automation.AutomationNode.prototype.performCustomAction = function(customActionId) {};
+
+/**
  * Sets selection within a text field.
  * @param {number} startIndex
  * @param {number} endIndex
  * @see https://developer.chrome.com/extensions/automation#method-setSelection
  */
 chrome.automation.AutomationNode.prototype.setSelection = function(startIndex, endIndex) {};
 
 /**
  * Clears focus and sets this node as the starting point for the next time the
  * user presses Tab or Shift+Tab.
@@ skipping 153 matching lines @@
  * 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.
  * @param {!chrome.automation.SetDocumentSelectionParams} params
  * @see https://developer.chrome.com/extensions/automation#method-setDocumentSelection
  */
 chrome.automation.setDocumentSelection = function(params) {};