Update protocol to latest version

Author: sinaa

browser_protocol.json

@@ -20,9 +20,13 @@
  * #L%
  */
 
+import com.github.kklisura.cdt.protocol.events.audits.IssueAdded;
+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.types.EventHandler;
+import com.github.kklisura.cdt.protocol.support.types.EventListener;
 import com.github.kklisura.cdt.protocol.types.audits.EncodedResponse;
 import com.github.kklisura.cdt.protocol.types.audits.GetEncodedResponseEncoding;
 
@@ -55,4 +59,16 @@ EncodedResponse getEncodedResponse(
       @ParamName("encoding") GetEncodedResponseEncoding encoding,
       @Optional @ParamName("quality") Double quality,
       @Optional @ParamName("sizeOnly") Boolean sizeOnly);
+
+  /** Disables issues domain, prevents further issues from being reported to the client. */
+  void disable();
+
+  /**
+   * Enables issues domain, sends the issues collected so far to the client by means of the
+   * `issueAdded` event.
+   */
+  void enable();
+
+  @EventName("issueAdded")
+  EventListener onIssueAdded(EventHandler<IssueAdded> eventListener);
 }

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

@@ -30,6 +30,7 @@
 import com.github.kklisura.cdt.protocol.types.browser.PermissionDescriptor;
 import com.github.kklisura.cdt.protocol.types.browser.PermissionSetting;
 import com.github.kklisura.cdt.protocol.types.browser.PermissionType;
+import com.github.kklisura.cdt.protocol.types.browser.SetDownloadBehaviorBehavior;
 import com.github.kklisura.cdt.protocol.types.browser.Version;
 import com.github.kklisura.cdt.protocol.types.browser.WindowForTarget;
 import java.util.List;
@@ -40,54 +41,49 @@ public interface Browser {
   /**
    * Set permission settings for given origin.
    *
-   * @param origin Origin the permission applies to.
    * @param permission Descriptor of permission to override.
    * @param setting Setting of the permission.
    */
   @Experimental
   void setPermission(
-      @ParamName("origin") String origin,
       @ParamName("permission") PermissionDescriptor permission,
       @ParamName("setting") PermissionSetting setting);
 
   /**
    * Set permission settings for given origin.
    *
-   * @param origin Origin the permission applies to.
    * @param permission Descriptor of permission to override.
    * @param setting Setting of the permission.
+   * @param origin Origin the permission applies to, all origins if not specified.
    * @param browserContextId Context to override. When omitted, default browser context is used.
    */
   @Experimental
   void setPermission(
-      @ParamName("origin") String origin,
       @ParamName("permission") PermissionDescriptor permission,
       @ParamName("setting") PermissionSetting setting,
+      @Optional @ParamName("origin") String origin,
       @Optional @ParamName("browserContextId") String browserContextId);
 
   /**
    * Grant specific permissions to the given origin and reject all others.
    *
-   * @param origin
    * @param permissions
    */
   @Experimental
-  void grantPermissions(
-      @ParamName("origin") String origin,
-      @ParamName("permissions") List<PermissionType> permissions);
+  void grantPermissions(@ParamName("permissions") List<PermissionType> permissions);
 
   /**
    * Grant specific permissions to the given origin and reject all others.
    *
-   * @param origin
    * @param permissions
+   * @param origin Origin the permission applies to, all origins if not specified.
    * @param browserContextId BrowserContext to override permissions. When omitted, default browser
    *     context is used.
    */
   @Experimental
   void grantPermissions(
-      @ParamName("origin") String origin,
       @ParamName("permissions") List<PermissionType> permissions,
+      @Optional @ParamName("origin") String origin,
       @Optional @ParamName("browserContextId") String browserContextId);
 
   /** Reset all permission management for all origins. */
@@ -103,6 +99,33 @@ void grantPermissions(
   @Experimental
   void resetPermissions(@Optional @ParamName("browserContextId") String browserContextId);
 
+  /**
+   * Set the behavior when downloading a file.
+   *
+   * @param behavior Whether to allow all or deny all download requests, or use default Chrome
+   *     behavior if available (otherwise deny). |allowAndName| allows download and names files
+   *     according to their dowmload guids.
+   */
+  @Experimental
+  void setDownloadBehavior(@ParamName("behavior") SetDownloadBehaviorBehavior behavior);
+
+  /**
+   * Set the behavior when downloading a file.
+   *
+   * @param behavior Whether to allow all or deny all download requests, or use default Chrome
+   *     behavior if available (otherwise deny). |allowAndName| allows download and names files
+   *     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
+   *     is set to 'allow' or 'allowAndName'.
+   */
+  @Experimental
+  void setDownloadBehavior(
+      @ParamName("behavior") SetDownloadBehaviorBehavior behavior,
+      @Optional @ParamName("browserContextId") String browserContextId,
+      @Optional @ParamName("downloadPath") String downloadPath);
+
   /** Close browser gracefully. */
   void close();
 

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

@@ -44,6 +44,7 @@
 import com.github.kklisura.cdt.protocol.types.css.SelectorList;
 import com.github.kklisura.cdt.protocol.types.css.SourceRange;
 import com.github.kklisura.cdt.protocol.types.css.StyleDeclarationEdit;
+import com.github.kklisura.cdt.protocol.types.css.TakeCoverageDelta;
 import com.github.kklisura.cdt.protocol.types.css.Value;
 import java.util.List;
 
@@ -245,9 +246,7 @@ String setStyleSheetText(
    * Obtain list of rules that became used since last call to this method (or since start of
    * coverage instrumentation)
    */
-  @Returns("coverage")
-  @ReturnTypeParameter(RuleUsage.class)
-  List<RuleUsage> takeCoverageDelta();
+  TakeCoverageDelta takeCoverageDelta();
 
   /**
    * Fires whenever a web font is updated. A non-empty font parameter indicates a successfully

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

@@ -75,13 +75,8 @@ CachedResponse requestCachedResponse(
    * Requests data from cache.
    *
    * @param cacheId ID of cache to get entries from.
-   * @param skipCount Number of records to skip.
-   * @param pageSize Number of records to fetch.
    */
-  RequestEntries requestEntries(
-      @ParamName("cacheId") String cacheId,
-      @ParamName("skipCount") Integer skipCount,
-      @ParamName("pageSize") Integer pageSize);
+  RequestEntries requestEntries(@ParamName("cacheId") String cacheId);
 
   /**
    * Requests data from cache.
@@ -93,7 +88,7 @@ RequestEntries requestEntries(
    */
   RequestEntries requestEntries(
       @ParamName("cacheId") String cacheId,
-      @ParamName("skipCount") Integer skipCount,
-      @ParamName("pageSize") Integer pageSize,
+      @Optional @ParamName("skipCount") Integer skipCount,
+      @Optional @ParamName("pageSize") Integer pageSize,
       @Optional @ParamName("pathFilter") String pathFilter);
 }

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

@@ -47,6 +47,7 @@
 import com.github.kklisura.cdt.protocol.types.dom.Node;
 import com.github.kklisura.cdt.protocol.types.dom.NodeForLocation;
 import com.github.kklisura.cdt.protocol.types.dom.PerformSearch;
+import com.github.kklisura.cdt.protocol.types.dom.Rect;
 import com.github.kklisura.cdt.protocol.types.runtime.RemoteObject;
 import com.github.kklisura.cdt.protocol.types.runtime.StackTrace;
 import java.util.List;
@@ -129,6 +130,30 @@ Node describeNode(
       @Optional @ParamName("depth") Integer depth,
       @Optional @ParamName("pierce") Boolean pierce);
 
+  /**
+   * Scrolls the specified rect of the given node into view if not already visible. Note: exactly
+   * one between nodeId, backendNodeId and objectId should be passed to identify the node.
+   */
+  @Experimental
+  void scrollIntoViewIfNeeded();
+
+  /**
+   * Scrolls the specified rect of the given node into view if not already visible. Note: exactly
+   * one between nodeId, backendNodeId and objectId should be passed to identify the node.
+   *
+   * @param nodeId Identifier of the node.
+   * @param backendNodeId Identifier of the backend node.
+   * @param objectId JavaScript object id of the node wrapper.
+   * @param rect The rect to be scrolled into view, relative to the node's border box, in CSS
+   *     pixels. When omitted, center of the node will be used, similar to Element.scrollIntoView.
+   */
+  @Experimental
+  void scrollIntoViewIfNeeded(
+      @Optional @ParamName("nodeId") Integer nodeId,
+      @Optional @ParamName("backendNodeId") Integer backendNodeId,
+      @Optional @ParamName("objectId") String objectId,
+      @Optional @ParamName("rect") Rect rect);
+
   /** Disables DOM agent for the given page. */
   void disable();
 
@@ -251,7 +276,6 @@ List<Node> getFlattenedDocument(
    * @param x X coordinate.
    * @param y Y coordinate.
    */
-  @Experimental
   NodeForLocation getNodeForLocation(@ParamName("x") Integer x, @ParamName("y") Integer y);
 
   /**
@@ -262,12 +286,14 @@ List<Node> getFlattenedDocument(
    * @param y Y coordinate.
    * @param includeUserAgentShadowDOM False to skip to the nearest non-UA shadow root ancestor
    *     (default: false).
+   * @param ignorePointerEventsNone Whether to ignore pointer-events: none on elements and hit test
+   *     them.
    */
-  @Experimental
   NodeForLocation getNodeForLocation(
       @ParamName("x") Integer x,
       @ParamName("y") Integer y,
-      @Optional @ParamName("includeUserAgentShadowDOM") Boolean includeUserAgentShadowDOM);
+      @Optional @ParamName("includeUserAgentShadowDOM") Boolean includeUserAgentShadowDOM,
+      @Optional @ParamName("ignorePointerEventsNone") Boolean ignorePointerEventsNone);
 
   /** Returns node's HTML markup. */
   @Returns("outerHTML")

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

@@ -36,9 +36,11 @@
 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.RestartFrame;
 import com.github.kklisura.cdt.protocol.types.debugger.ScriptPosition;
+import com.github.kklisura.cdt.protocol.types.debugger.ScriptSource;
 import com.github.kklisura.cdt.protocol.types.debugger.SearchMatch;
 import com.github.kklisura.cdt.protocol.types.debugger.SetBreakpoint;
 import com.github.kklisura.cdt.protocol.types.debugger.SetBreakpointByUrl;
@@ -132,6 +134,29 @@ 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.
@@ -164,8 +189,16 @@ List<BreakLocation> getPossibleBreakpoints(
    *
    * @param scriptId Id of the script to get source for.
    */
-  @Returns("scriptSource")
-  String getScriptSource(@ParamName("scriptId") String scriptId);
+  ScriptSource getScriptSource(@ParamName("scriptId") String scriptId);
+
+  /**
+   * This command is deprecated. Use getScriptSource instead.
+   *
+   * @param scriptId Id of the Wasm script to get source for.
+   */
+  @Deprecated
+  @Returns("bytecode")
+  String getWasmBytecode(@ParamName("scriptId") String scriptId);
 
   /**
    * Returns stack trace with given `stackTraceId`.
@@ -183,6 +216,7 @@ List<BreakLocation> getPossibleBreakpoints(
    * @param parentStackTraceId Debugger will pause when async call with given stack trace is
    *     started.
    */
+  @Deprecated
   @Experimental
   void pauseOnAsyncCall(@ParamName("parentStackTraceId") StackTraceId parentStackTraceId);
 
@@ -203,6 +237,17 @@ List<BreakLocation> getPossibleBreakpoints(
   /** Resumes JavaScript execution. */
   void resume();
 
+  /**
+   * Resumes JavaScript execution.
+   *
+   * @param terminateOnResume Set to true to terminate execution upon resuming execution. In
+   *     contrast to Runtime.terminateExecution, this will allows to execute further JavaScript
+   *     (i.e. via evaluation) until execution of the paused code is actually resumed, at which
+   *     point termination is triggered. If execution is currently not paused, this parameter has no
+   *     effect.
+   */
+  void resume(@Optional @ParamName("terminateOnResume") Boolean terminateOnResume);
+
   /**
    * Searches for given string in script content.
    *
@@ -418,8 +463,8 @@ void setVariableValue(
   /**
    * Steps into the function call.
    *
-   * @param breakOnAsyncCall Debugger will issue additional Debugger.paused notification if any
-   *     async task is scheduled before next pause.
+   * @param breakOnAsyncCall Debugger will pause on the execution of the first async task which was
+   *     scheduled before next pause.
    */
   void stepInto(@Experimental @Optional @ParamName("breakOnAsyncCall") Boolean breakOnAsyncCall);