Merge pull request kklisura#62 from sinaa/master

Update to latest devtools protocol

Author: kklisura

README.md

@@ -10,7 +10,7 @@ For more information on DevTools, see https://chromedevtools.github.io/devtools-
 
 [v2.1.0](https://github.com/kklisura/chrome-devtools-java-client/tree/v2.1.0) tested on Google Chrome Version 76.0.3809.100. Protocol files from [dev-tools-protocol#e1fb93bd76](https://github.com/ChromeDevTools/devtools-protocol/tree/e1fb93bd76f99cdf401b949757c874c579e15434/json)
 
-[v3.0.0](https://github.com/kklisura/chrome-devtools-java-client/tree/vx.x.x) tested on Google Chrome Version 86.0.4240.111. Protocol files from [dev-tools-protocol#fcb68d10bc](https://github.com/ChromeDevTools/devtools-protocol/tree/fcb68d10bc5258ebf96121caf57200069f6e6731/json)
+[v3.0.0](https://github.com/kklisura/chrome-devtools-java-client/tree/v3.0.0) tested on Google Chrome Version 86.0.4240.111. Protocol files from [dev-tools-protocol#fcb68d10bc](https://github.com/ChromeDevTools/devtools-protocol/tree/fcb68d10bc5258ebf96121caf57200069f6e6731/json)
 
 [1] https://chromedevtools.github.io/devtools-protocol/.
 

browser_protocol.json

@@ -53,6 +53,7 @@
 import com.github.kklisura.cdt.protocol.commands.Overlay;
 import com.github.kklisura.cdt.protocol.commands.Page;
 import com.github.kklisura.cdt.protocol.commands.Performance;
+import com.github.kklisura.cdt.protocol.commands.PerformanceTimeline;
 import com.github.kklisura.cdt.protocol.commands.Profiler;
 import com.github.kklisura.cdt.protocol.commands.Runtime;
 import com.github.kklisura.cdt.protocol.commands.Schema;
@@ -170,6 +171,9 @@ public interface ChromeDevTools {
   /** Returns the Performance command. */
   Performance getPerformance();
 
+  /** Returns the PerformanceTimeline command. */
+  PerformanceTimeline getPerformanceTimeline();
+
   /** Returns the Security command. */
   Security getSecurity();
 

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/ChromeDevTools.java

@@ -68,12 +68,34 @@ List<AXNode> getPartialAXTree(
       @Optional @ParamName("objectId") String objectId,
       @Optional @ParamName("fetchRelatives") Boolean fetchRelatives);
 
-  /** Fetches the entire accessibility tree */
+  /** Fetches the entire accessibility tree for the root Document */
   @Experimental
   @Returns("nodes")
   @ReturnTypeParameter(AXNode.class)
   List<AXNode> getFullAXTree();
 
+  /**
+   * Fetches the entire accessibility tree for the root Document
+   *
+   * @param max_depth The maximum depth at which descendants of the root node should be retrieved.
+   *     If omitted, the full tree is returned.
+   */
+  @Experimental
+  @Returns("nodes")
+  @ReturnTypeParameter(AXNode.class)
+  List<AXNode> getFullAXTree(@Optional @ParamName("max_depth") Integer max_depth);
+
+  /**
+   * Fetches a particular accessibility node by AXNodeId. Requires `enable()` to have been called
+   * previously.
+   *
+   * @param id
+   */
+  @Experimental
+  @Returns("nodes")
+  @ReturnTypeParameter(AXNode.class)
+  List<AXNode> getChildAXNodes(@ParamName("id") String id);
+
   /**
    * Query a DOM node's accessibility subtree for accessible name and role. This command computes
    * the name and role for all nodes in the subtree, including those that are ignored for

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/Accessibility.java

@@ -69,6 +69,20 @@ EncodedResponse getEncodedResponse(
    */
   void enable();
 
+  /**
+   * Runs the contrast check for the target page. Found issues are reported using Audits.issueAdded
+   * event.
+   */
+  void checkContrast();
+
+  /**
+   * Runs the contrast check for the target page. Found issues are reported using Audits.issueAdded
+   * event.
+   *
+   * @param reportAAA Whether to report WCAG AAA level issues. Default is false.
+   */
+  void checkContrast(@Optional @ParamName("reportAAA") Boolean reportAAA);
+
   @EventName("issueAdded")
   EventListener onIssueAdded(EventHandler<IssueAdded> eventListener);
 }

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/Audits.java

@@ -20,11 +20,16 @@
  * #L%
  */
 
+import com.github.kklisura.cdt.protocol.events.browser.DownloadProgress;
+import com.github.kklisura.cdt.protocol.events.browser.DownloadWillBegin;
+import com.github.kklisura.cdt.protocol.support.annotations.EventName;
 import com.github.kklisura.cdt.protocol.support.annotations.Experimental;
 import com.github.kklisura.cdt.protocol.support.annotations.Optional;
 import com.github.kklisura.cdt.protocol.support.annotations.ParamName;
 import com.github.kklisura.cdt.protocol.support.annotations.ReturnTypeParameter;
 import com.github.kklisura.cdt.protocol.support.annotations.Returns;
+import com.github.kklisura.cdt.protocol.support.types.EventHandler;
+import com.github.kklisura.cdt.protocol.support.types.EventListener;
 import com.github.kklisura.cdt.protocol.types.browser.Bounds;
 import com.github.kklisura.cdt.protocol.types.browser.BrowserCommandId;
 import com.github.kklisura.cdt.protocol.types.browser.Histogram;
@@ -118,14 +123,36 @@ void grantPermissions(
    *     according to their dowmload guids.
    * @param browserContextId BrowserContext to set download behavior. When omitted, default browser
    *     context is used.
-   * @param downloadPath The default path to save downloaded files to. This is requred if behavior
+   * @param downloadPath The default path to save downloaded files to. This is required if behavior
    *     is set to 'allow' or 'allowAndName'.
+   * @param eventsEnabled Whether to emit download events (defaults to false).
    */
   @Experimental
   void setDownloadBehavior(
       @ParamName("behavior") SetDownloadBehaviorBehavior behavior,
       @Optional @ParamName("browserContextId") String browserContextId,
-      @Optional @ParamName("downloadPath") String downloadPath);
+      @Optional @ParamName("downloadPath") String downloadPath,
+      @Optional @ParamName("eventsEnabled") Boolean eventsEnabled);
+
+  /**
+   * Cancel a download if in progress
+   *
+   * @param guid Global unique identifier of the download.
+   */
+  @Experimental
+  void cancelDownload(@ParamName("guid") String guid);
+
+  /**
+   * Cancel a download if in progress
+   *
+   * @param guid Global unique identifier of the download.
+   * @param browserContextId BrowserContext to perform the action in. When omitted, default browser
+   *     context is used.
+   */
+  @Experimental
+  void cancelDownload(
+      @ParamName("guid") String guid,
+      @Optional @ParamName("browserContextId") String browserContextId);
 
   /** Close browser gracefully. */
   void close();
@@ -229,7 +256,7 @@ Histogram getHistogram(
    * Set dock tile details, platform-specific.
    *
    * @param badgeLabel
-   * @param image Png encoded image.
+   * @param image Png encoded image. (Encoded as a base64 string when passed over JSON)
    */
   @Experimental
   void setDockTile(
@@ -243,4 +270,14 @@ void setDockTile(
    */
   @Experimental
   void executeBrowserCommand(@ParamName("commandId") BrowserCommandId commandId);
+
+  /** Fired when page is about to start a download. */
+  @EventName("downloadWillBegin")
+  @Experimental
+  EventListener onDownloadWillBegin(EventHandler<DownloadWillBegin> eventListener);
+
+  /** Fired when download makes progress. Last call has |done| == true. */
+  @EventName("downloadProgress")
+  @Experimental
+  EventListener onDownloadProgress(EventHandler<DownloadProgress> eventListener);
 }

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/Browser.java

@@ -692,7 +692,7 @@ void setFileInputFiles(
   @EventName("childNodeRemoved")
   EventListener onChildNodeRemoved(EventHandler<ChildNodeRemoved> eventListener);
 
-  /** Called when distrubution is changed. */
+  /** Called when distribution is changed. */
   @EventName("distributedNodesUpdated")
   @Experimental
   EventListener onDistributedNodesUpdated(EventHandler<DistributedNodesUpdated> eventListener);

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/DOM.java

@@ -25,6 +25,7 @@
 import com.github.kklisura.cdt.protocol.support.annotations.ParamName;
 import com.github.kklisura.cdt.protocol.support.annotations.ReturnTypeParameter;
 import com.github.kklisura.cdt.protocol.support.annotations.Returns;
+import com.github.kklisura.cdt.protocol.types.domdebugger.CSPViolationType;
 import com.github.kklisura.cdt.protocol.types.domdebugger.DOMBreakpointType;
 import com.github.kklisura.cdt.protocol.types.domdebugger.EventListener;
 import java.util.List;
@@ -101,6 +102,14 @@ void removeEventListenerBreakpoint(
    */
   void removeXHRBreakpoint(@ParamName("url") String url);
 
+  /**
+   * Sets breakpoint on particular CSP violations.
+   *
+   * @param violationTypes CSP Violations to stop upon.
+   */
+  @Experimental
+  void setBreakOnCSPViolation(@ParamName("violationTypes") List<CSPViolationType> violationTypes);
+
   /**
    * Sets breakpoint on particular operation with DOM.
    *

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/DOMDebugger.java

@@ -89,9 +89,20 @@ Snapshot getSnapshot(
    * @param includePaintOrder Whether to include layout object paint orders into the snapshot.
    * @param includeDOMRects Whether to include DOM rectangles (offsetRects, clientRects,
    *     scrollRects) into the snapshot
+   * @param includeBlendedBackgroundColors Whether to include blended background colors in the
+   *     snapshot (default: false). Blended background color is achieved by blending background
+   *     colors of all elements that overlap with the current element.
+   * @param includeTextColorOpacities Whether to include text color opacity in the snapshot
+   *     (default: false). An element might have the opacity property set that affects the text
+   *     color of the element. The final text color opacity is computed based on the opacity of all
+   *     overlapping elements.
    */
   CaptureSnapshot captureSnapshot(
       @ParamName("computedStyles") List<String> computedStyles,
       @Optional @ParamName("includePaintOrder") Boolean includePaintOrder,
-      @Optional @ParamName("includeDOMRects") Boolean includeDOMRects);
+      @Optional @ParamName("includeDOMRects") Boolean includeDOMRects,
+      @Experimental @Optional @ParamName("includeBlendedBackgroundColors")
+          Boolean includeBlendedBackgroundColors,
+      @Experimental @Optional @ParamName("includeTextColorOpacities")
+          Boolean includeTextColorOpacities);
 }

cdt-java-client/src/main/java/com/github/kklisura/cdt/protocol/commands/DOMSnapshot.java

@@ -36,7 +36,6 @@
 import com.github.kklisura.cdt.protocol.types.debugger.BreakLocation;
 import com.github.kklisura.cdt.protocol.types.debugger.ContinueToLocationTargetCallFrames;
 import com.github.kklisura.cdt.protocol.types.debugger.EvaluateOnCallFrame;
-import com.github.kklisura.cdt.protocol.types.debugger.ExecuteWasmEvaluator;
 import com.github.kklisura.cdt.protocol.types.debugger.Location;
 import com.github.kklisura.cdt.protocol.types.debugger.LocationRange;
 import com.github.kklisura.cdt.protocol.types.debugger.RestartFrame;
@@ -135,29 +134,6 @@ EvaluateOnCallFrame evaluateOnCallFrame(
       @Optional @ParamName("throwOnSideEffect") Boolean throwOnSideEffect,
       @Experimental @Optional @ParamName("timeout") Double timeout);
 
-  /**
-   * Execute a Wasm Evaluator module on a given call frame.
-   *
-   * @param callFrameId WebAssembly call frame identifier to evaluate on.
-   * @param evaluator Code of the evaluator module.
-   */
-  @Experimental
-  ExecuteWasmEvaluator executeWasmEvaluator(
-      @ParamName("callFrameId") String callFrameId, @ParamName("evaluator") String evaluator);
-
-  /**
-   * Execute a Wasm Evaluator module on a given call frame.
-   *
-   * @param callFrameId WebAssembly call frame identifier to evaluate on.
-   * @param evaluator Code of the evaluator module.
-   * @param timeout Terminate execution after timing out (number of milliseconds).
-   */
-  @Experimental
-  ExecuteWasmEvaluator executeWasmEvaluator(
-      @ParamName("callFrameId") String callFrameId,
-      @ParamName("evaluator") String evaluator,
-      @Experimental @Optional @ParamName("timeout") Double timeout);
-
   /**
    * Returns possible locations for breakpoint. scriptId in start and end range locations should be
    * the same.