appium-remote-debugger 11.5.9 → 12.0.1

package/lib/remote-debugger.ts

@@ -0,0 +1,268 @@
+import { EventEmitter } from 'events';
+import defaultLog from './logger';
+import { RpcClientSimulator } from './rpc';
+import { getModuleProperties } from './utils';
+import * as connectMixins from './mixins/connect';
+import * as executeMixins from './mixins/execute';
+import * as messageHandlerMixins from './mixins/message-handlers';
+import * as navigationMixins from './mixins/navigate';
+import * as cookieMixins from './mixins/cookies';
+import * as screenshotMixins from './mixins/screenshot';
+import * as eventMixins from './mixins/events';
+import * as miscellaneousMixins from './mixins/misc';
+import _ from 'lodash';
+import type {
+  RemoteDebuggerOptions,
+  AppDict,
+  EventListener
+} from './types';
+import type { AppiumLogger, StringRecord } from '@appium/types';
+import type { RpcClient } from './rpc/rpc-client';
+import type B from 'bluebird';
+
+
+export const REMOTE_DEBUGGER_PORT = 27753;
+const PAGE_READY_TIMEOUT_MS = 5000;
+const { version: MODULE_VERSION } = getModuleProperties();
+
+
+export class RemoteDebugger extends EventEmitter {
+  protected _skippedApps: string[];
+  protected _clientEventListeners: StringRecord<EventListener[]>;
+  protected _appDict: AppDict;
+  protected _appIdKey: string | null | undefined;
+  protected _pageIdKey: string | number | null | undefined;
+  protected _connectedDrivers: StringRecord[] | undefined;
+  protected _currentState: string | undefined;
+  protected _pageLoadDelay: B<void> | undefined;
+  protected _rpcClient: RpcClient | null;
+  protected _pageLoading: boolean;
+  protected _navigatingToPage: boolean;
+  protected _allowNavigationWithoutReload: boolean;
+  protected _pageLoadMs: number | undefined;
+  protected readonly _pageLoadStrategy: string | undefined;
+  protected readonly _log: AppiumLogger;
+  protected readonly _bundleId: string | undefined;
+  protected readonly _additionalBundleIds: string[] | undefined;
+  protected readonly _platformVersion: string | undefined;
+  protected readonly _isSafari: boolean;
+  protected readonly _includeSafari: boolean;
+  protected readonly _useNewSafari: boolean;
+  protected readonly _garbageCollectOnExecute: boolean;
+  protected readonly _host: string | undefined;
+  protected readonly _port: number | undefined;
+  protected readonly _socketPath: string | undefined;
+  protected readonly _remoteDebugProxy: any | undefined;
+  protected readonly _pageReadyTimeout: number;
+  protected readonly _logAllCommunication: boolean;
+  protected readonly _logAllCommunicationHexDump: boolean;
+  protected readonly _socketChunkSize: number | undefined;
+  protected readonly _webInspectorMaxFrameLength: number | undefined;
+  protected readonly _fullPageInitialization: boolean | undefined;
+
+  // events
+  static readonly EVENT_PAGE_CHANGE: string;
+  static readonly EVENT_DISCONNECT: string;
+  static readonly EVENT_FRAMES_DETACHED: string;
+
+  // methods
+  setConnectionKey = connectMixins.setConnectionKey;
+  disconnect = connectMixins.disconnect;
+  checkPageIsReady = navigationMixins.checkPageIsReady;
+  cancelPageLoad = navigationMixins.cancelPageLoad;
+  waitForDom = navigationMixins.waitForDom;
+  execute = executeMixins.execute;
+  executeAtom = executeMixins.executeAtom;
+  executeAtomAsync = executeMixins.executeAtomAsync;
+  isPageLoadingCompleted = navigationMixins.isPageLoadingCompleted;
+  selectApp = connectMixins.selectApp;
+  connect = connectMixins.connect;
+  selectPage = connectMixins.selectPage;
+  navToUrl = navigationMixins.navToUrl;
+  getCookies = cookieMixins.getCookies;
+  setCookie = cookieMixins.setCookie;
+  deleteCookie = cookieMixins.deleteCookie;
+  captureScreenshot = screenshotMixins.captureScreenshot;
+  addClientEventListener = eventMixins.addClientEventListener;
+  removeClientEventListener = eventMixins.removeClientEventListener;
+  startConsole = eventMixins.startConsole;
+  stopConsole = eventMixins.stopConsole;
+  startNetwork = eventMixins.startNetwork;
+  stopNetwork = eventMixins.stopNetwork;
+  launchSafari = miscellaneousMixins.launchSafari;
+  startTimeline = miscellaneousMixins.startTimeline;
+  stopTimeline = miscellaneousMixins.stopTimeline;
+  overrideUserAgent = miscellaneousMixins.overrideUserAgent;
+  garbageCollect = miscellaneousMixins.garbageCollect;
+
+  // Callbacks
+  onPageChange = messageHandlerMixins.onPageChange;
+  onConnectedApplicationList = messageHandlerMixins.onConnectedApplicationList;
+  onAppConnect = messageHandlerMixins.onAppConnect;
+  onAppDisconnect = messageHandlerMixins.onAppDisconnect;
+  onAppUpdate = messageHandlerMixins.onAppUpdate;
+  onConnectedDriverList = messageHandlerMixins.onConnectedDriverList;
+  onCurrentState = messageHandlerMixins.onCurrentState;
+  frameDetached = navigationMixins.frameDetached;
+
+  constructor (opts: RemoteDebuggerOptions = {}) {
+    super();
+
+    this._log = opts.log ?? defaultLog;
+    this.log.info(`Remote Debugger version ${MODULE_VERSION}`);
+
+    const {
+      bundleId,
+      additionalBundleIds = [],
+      platformVersion,
+      isSafari = true,
+      includeSafari = false,
+      useNewSafari = false,
+      pageLoadMs,
+      host,
+      port = REMOTE_DEBUGGER_PORT,
+      socketPath,
+      pageReadyTimeout = PAGE_READY_TIMEOUT_MS,
+      remoteDebugProxy,
+      garbageCollectOnExecute = false,
+      logFullResponse = false,
+      logAllCommunication = false,
+      logAllCommunicationHexDump = false,
+      webInspectorMaxFrameLength,
+      socketChunkSize,
+      fullPageInitialization,
+      pageLoadStrategy,
+    } = opts;
+
+    this._bundleId = bundleId;
+    this._additionalBundleIds = additionalBundleIds;
+    this._platformVersion = platformVersion;
+    this._isSafari = isSafari;
+    this._includeSafari = includeSafari;
+    this._useNewSafari = useNewSafari;
+    this._pageLoadMs = pageLoadMs;
+    this._allowNavigationWithoutReload = false;
+    this.log.debug(`useNewSafari --> ${this._useNewSafari}`);
+
+    this._garbageCollectOnExecute = garbageCollectOnExecute;
+
+    this._host = host;
+    this._port = port;
+    this._socketPath = socketPath;
+    this._remoteDebugProxy = remoteDebugProxy;
+    this._pageReadyTimeout = pageReadyTimeout;
+
+    this._logAllCommunication = _.isNil(logAllCommunication) ? !!logFullResponse : !!logAllCommunication;
+    this._logAllCommunicationHexDump = logAllCommunicationHexDump;
+    this._socketChunkSize = socketChunkSize;
+
+    if (_.isInteger(webInspectorMaxFrameLength)) {
+      this._webInspectorMaxFrameLength = webInspectorMaxFrameLength;
+    }
+
+    this._fullPageInitialization = fullPageInitialization;
+
+    this._pageLoadStrategy = pageLoadStrategy;
+    this._skippedApps = [];
+
+    this.setup();
+  }
+
+  get log(): AppiumLogger {
+    return this._log;
+  }
+
+  requireRpcClient(checkConnected: boolean = false): RpcClient {
+    if (!this._rpcClient) {
+      throw new Error(`rpcClient is undefined. Has 'initRpcClient' been called before?`);
+    }
+    if (checkConnected && !this._rpcClient.isConnected) {
+      throw new Error('Remote debugger is not connected');
+    }
+    return this._rpcClient;
+  }
+
+  setup (): void {
+    // app handling configuration
+    this._appDict = {};
+    this._appIdKey = null;
+    this._pageIdKey = null;
+    this._pageLoading = false;
+    this._navigatingToPage = false;
+    this._currentState = undefined;
+    this._connectedDrivers = undefined;
+    this._pageLoadDelay = undefined;
+
+    this._rpcClient = null;
+    this._clientEventListeners = {};
+  }
+
+  teardown (): void {
+    this.log.debug('Cleaning up listeners');
+
+    this._appDict = {};
+    this._appIdKey = null;
+    this._pageIdKey = null;
+    this._pageLoading = false;
+
+    this._rpcClient = null;
+
+    for (const evt of [
+      RemoteDebugger.EVENT_DISCONNECT,
+      RemoteDebugger.EVENT_PAGE_CHANGE,
+      RemoteDebugger.EVENT_FRAMES_DETACHED,
+    ]) {
+      this.removeAllListeners(evt);
+    }
+  }
+
+  initRpcClient (): void {
+    this._rpcClient = new RpcClientSimulator({
+      bundleId: this._bundleId,
+      platformVersion: this._platformVersion,
+      isSafari: this._isSafari,
+      host: this._host,
+      port: this._port,
+      socketPath: this._socketPath,
+      messageProxy: this._remoteDebugProxy,
+      logAllCommunication: this._logAllCommunication,
+      logAllCommunicationHexDump: this._logAllCommunicationHexDump,
+      fullPageInitialization: this._fullPageInitialization,
+      webInspectorMaxFrameLength: this._webInspectorMaxFrameLength,
+    });
+  }
+
+  get isConnected (): boolean {
+    return !!this._rpcClient?.isConnected;
+  }
+
+  set allowNavigationWithoutReload (allow: boolean) {
+    this._allowNavigationWithoutReload = allow;
+  }
+
+  get allowNavigationWithoutReload (): boolean {
+    return !!this._allowNavigationWithoutReload;
+  }
+
+  get currentState (): string | undefined {
+    return this._currentState;
+  }
+
+  get connectedDrivers (): StringRecord[] | undefined {
+    return this._connectedDrivers;
+  }
+
+  get pageLoadMs (): number {
+    return this._pageLoadMs ?? navigationMixins.DEFAULT_PAGE_READINESS_TIMEOUT_MS;
+  }
+
+  set pageLoadMs (value: number) {
+    this._pageLoadMs = value;
+  }
+}
+
+for (const [name, event] of _.toPairs(eventMixins.events)) {
+  RemoteDebugger[name] = event;
+}
+
+export default RemoteDebugger;

package/lib/types.ts

@@ -1,4 +1,4 @@
-import type { StringRecord } from '@appium/types';
+import type { StringRecord, AppiumLogger } from '@appium/types';
 import type B from 'bluebird';
 
 export interface DeferredPromise {
@@ -37,3 +37,46 @@ export interface Page {
 }
 
 export type AppDict = StringRecord<AppInfo>;
+
+export type EventListener = (event: StringRecord) => any;
+
+export interface RemoteDebuggerOptions {
+  /** id of the app being connected to */
+  bundleId?: string;
+  /** array of possible bundle ids that the inspector could return */
+  additionalBundleIds?: string[];
+  /** version of iOS */
+  platformVersion?: string;
+  isSafari?: boolean;
+  includeSafari?: boolean;
+  /** for web inspector, whether this is a new Safari instance */
+  useNewSafari?: boolean;
+  /** the time, in ms, that should be waited for page loading */
+  pageLoadMs?: number;
+  /** the remote debugger's host address */
+  host?: string;
+  /** the remote debugger port through which to communicate */
+  port?: number;
+  socketPath?: string;
+  pageReadyTimeout?: number;
+  remoteDebugProxy?: string;
+  garbageCollectOnExecute?: boolean;
+  logFullResponse?: boolean;
+  /** log plists sent and received from Web Inspector */
+  logAllCommunication?: boolean;
+  /** log communication from Web Inspector as hex dump */
+  logAllCommunicationHexDump?: boolean;
+  /** The maximum size in bytes of a single data frame in the device communication protocol */
+  webInspectorMaxFrameLength?: number;
+  /** size, in bytes, of chunks of data sent to Web Inspector (real device only) */
+  socketChunkSize?: number;
+  fullPageInitialization?: boolean;
+  pageLoadStrategy?: string;
+  log?: AppiumLogger;
+}
+
+interface RemoteDebuggerRealDeviceSpecificOptions {
+  udid: string;
+}
+
+export type RemoteDebuggerRealDeviceOptions = RemoteDebuggerRealDeviceSpecificOptions & RemoteDebuggerOptions;

package/package.json

@@ -4,7 +4,7 @@
   "keywords": [
     "appium"
   ],
-  "version": "11.5.9",
+  "version": "12.0.1",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {

package/lib/remote-debugger-real-device.js

@@ -1,39 +0,0 @@
-import RemoteDebugger from './remote-debugger';
-import { RpcClientRealDevice } from './rpc';
-
-/**
- * @typedef {Object} RemoteDebuggerRealDeviceOptions
- * @property {string} udid Real device UDID
- */
-
-export default class RemoteDebuggerRealDevice extends RemoteDebugger {
-  /** @type {string} */
-  udid;
-
-  /**
-   * @param {RemoteDebuggerRealDeviceOptions & import('./remote-debugger').RemoteDebuggerOptions} opts
-   */
-  constructor (opts) {
-    super(opts);
-
-    this.udid = opts.udid;
-
-    this._skippedApps = ['lockdownd'];
-  }
-
-  /**
-   * @override
-   */
-  initRpcClient () {
-    this.rpcClient = new RpcClientRealDevice({
-      bundleId: this.bundleId,
-      platformVersion: this.platformVersion,
-      isSafari: this.isSafari,
-      logAllCommunication: this.logAllCommunication,
-      logAllCommunicationHexDump: this.logAllCommunicationHexDump,
-      socketChunkSize: this.socketChunkSize,
-      webInspectorMaxFrameLength: this.webInspectorMaxFrameLength,
-      udid: this.udid,
-    });
-  }
-}

package/lib/remote-debugger.js

@@ -1,299 +0,0 @@
-import { EventEmitter } from 'events';
-import defaultLog from './logger';
-import { RpcClientSimulator } from './rpc';
-import { getModuleProperties } from './utils';
-import * as connectMixins from './mixins/connect';
-import * as executeMixins from './mixins/execute';
-import * as messageHandlerMixins from './mixins/message-handlers';
-import * as navigationMixins from './mixins/navigate';
-import * as cookieMixins from './mixins/cookies';
-import * as screenshotMixins from './mixins/screenshot';
-import * as eventMixins from './mixins/events';
-import * as miscellaneousMixins from './mixins/misc';
-import _ from 'lodash';
-
-
-export const REMOTE_DEBUGGER_PORT = 27753;
-/* How many milliseconds to wait for webkit to return a response before timing out */
-export const RPC_RESPONSE_TIMEOUT_MS = 5000;
-const PAGE_READY_TIMEOUT_MS = 5000;
-const { version: MODULE_VERSION } = getModuleProperties();
-
-
-export class RemoteDebugger extends EventEmitter {
-  // properties
-  /** @type {string[]|undefined} */
-  _skippedApps;
-  /** @type {import('@appium/types').StringRecord<Function[]>} */
-  _clientEventListeners;
-  /** @type {import('./types').AppDict} */
-  appDict;
-  /** @type {string|null|undefined} */
-  appIdKey;
-  /** @type {string|number|null|undefined} */
-  pageIdKey;
-  /** @type {Record<string, any>[]|undefined} */
-  connectedDrivers;
-  /** @type {Record<string, any>[]|undefined} */
-  currentState;
-  /** @type {boolean|undefined} */
-  connected;
-  /** @type {import('bluebird')<void>} */
-  pageLoadDelay;
-  /** @type {import('bluebird')<void>} */
-  navigationDelay;
-  /** @type {import('./rpc/rpc-client').RpcClient?} */
-  rpcClient;
-  /** @type {string|undefined} */
-  pageLoadStrategy;
-  /** @type {import('@appium/types').AppiumLogger} */
-  _log;
-
-  // events
-  /** @type {string} */
-  static EVENT_PAGE_CHANGE;
-  /** @type {string} */
-  static EVENT_DISCONNECT;
-  /** @type {string} */
-  static EVENT_FRAMES_DETACHED;
-
-  // methods
-  setConnectionKey = connectMixins.setConnectionKey;
-  disconnect = connectMixins.disconnect;
-  searchForApp = connectMixins.searchForApp;
-  searchForPage = connectMixins.searchForPage;
-  checkPageIsReady = navigationMixins.checkPageIsReady;
-  cancelPageLoad = navigationMixins.cancelPageLoad;
-  waitForDom = navigationMixins.waitForDom;
-  execute = executeMixins.execute;
-  executeAtom = executeMixins.executeAtom;
-  executeAtomAsync = executeMixins.executeAtomAsync;
-  isPageLoadingCompleted = navigationMixins.isPageLoadingCompleted;
-  selectApp = connectMixins.selectApp;
-  connect = connectMixins.connect;
-  selectPage = connectMixins.selectPage;
-  navToUrl = navigationMixins.navToUrl;
-  getCookies = cookieMixins.getCookies;
-  setCookie = cookieMixins.setCookie;
-  deleteCookie = cookieMixins.deleteCookie;
-  captureScreenshot = screenshotMixins.captureScreenshot;
-  addClientEventListener = eventMixins.addClientEventListener;
-  removeClientEventListener = eventMixins.removeClientEventListener;
-  launchSafari = miscellaneousMixins.launchSafari;
-  startTimeline = miscellaneousMixins.startTimeline;
-  stopTimeline = miscellaneousMixins.stopTimeline;
-  startConsole = miscellaneousMixins.startConsole;
-  stopConsole = miscellaneousMixins.stopConsole;
-  startNetwork = miscellaneousMixins.startNetwork;
-  stopNetwork = miscellaneousMixins.stopNetwork;
-  overrideUserAgent = miscellaneousMixins.overrideUserAgent;
-  garbageCollect = miscellaneousMixins.garbageCollect;
-
-  // Callbacks
-  onPageChange = messageHandlerMixins.onPageChange;
-  onConnectedApplicationList = messageHandlerMixins.onConnectedApplicationList;
-  onAppConnect = messageHandlerMixins.onAppConnect;
-  onAppDisconnect = messageHandlerMixins.onAppDisconnect;
-  onAppUpdate = messageHandlerMixins.onAppUpdate;
-  onConnectedDriverList = messageHandlerMixins.onConnectedDriverList;
-  onCurrentState = messageHandlerMixins.onCurrentState;
-  frameDetached = navigationMixins.frameDetached;
-
-  /**
-   * @param {RemoteDebuggerOptions} opts
-   */
-  constructor (opts = {}) {
-    super();
-
-    // @ts-ignore This is OK
-    this._log = opts.log ?? defaultLog;
-    this.log.info(`Remote Debugger version ${MODULE_VERSION}`);
-
-    const {
-      bundleId,
-      additionalBundleIds = [],
-      platformVersion,
-      isSafari = true,
-      includeSafari = false,
-      useNewSafari = false,
-      pageLoadMs,
-      host,
-      port = REMOTE_DEBUGGER_PORT,
-      socketPath,
-      pageReadyTimeout = PAGE_READY_TIMEOUT_MS,
-      remoteDebugProxy,
-      garbageCollectOnExecute = false,
-      logFullResponse = false,
-      logAllCommunication = false,
-      logAllCommunicationHexDump = false,
-      webInspectorMaxFrameLength,
-      socketChunkSize,
-      fullPageInitialization,
-      pageLoadStrategy,
-    } = opts;
-
-    this.bundleId = bundleId;
-    this.additionalBundleIds = additionalBundleIds;
-    this.platformVersion = platformVersion;
-    this.isSafari = isSafari;
-    this.includeSafari = includeSafari;
-    this.useNewSafari = useNewSafari;
-    this.pageLoadMs = pageLoadMs;
-    this.log.debug(`useNewSafari --> ${this.useNewSafari}`);
-
-    this.garbageCollectOnExecute = garbageCollectOnExecute;
-
-    this.host = host;
-    this.port = port;
-    this.socketPath = socketPath;
-    this.remoteDebugProxy = remoteDebugProxy;
-    this.pageReadyTimeout = pageReadyTimeout;
-
-    this.logAllCommunication = _.isNil(logAllCommunication) ? !!logFullResponse : !!logAllCommunication;
-    this.logAllCommunicationHexDump = logAllCommunicationHexDump;
-    this.socketChunkSize = socketChunkSize;
-
-    if (_.isInteger(webInspectorMaxFrameLength)) {
-      this.webInspectorMaxFrameLength = webInspectorMaxFrameLength;
-    }
-
-    this.fullPageInitialization = fullPageInitialization;
-
-    this.pageLoadStrategy = pageLoadStrategy;
-  }
-
-  /**
-   * @returns {import('@appium/types').AppiumLogger}
-   */
-  get log() {
-    return this._log;
-  }
-
-  /**
-   * @param {boolean} [checkConnected=false]
-   * @returns {import('./rpc/rpc-client').RpcClient}
-   */
-  requireRpcClient(checkConnected = false) {
-    if (!this.rpcClient) {
-      throw new Error(`rpcClient is undefined. Has 'initRpcClient' been called before?`);
-    }
-    if (checkConnected && !this.rpcClient.isConnected) {
-      throw new Error('Remote debugger is not connected');
-    }
-    return this.rpcClient;
-  }
-
-  /**
-   * @returns {void}
-   */
-  setup () {
-    // app handling configuration
-    this.appDict = {};
-    this.appIdKey = null;
-    this.pageIdKey = null;
-    this.pageLoading = false;
-    this._navigatingToPage = false;
-    this.allowNavigationWithoutReload = false;
-
-    this.rpcClient = null;
-    this._clientEventListeners = {};
-  }
-
-  /**
-   * @returns {void}
-   */
-  teardown () {
-    this.log.debug('Cleaning up listeners');
-
-    this.appDict = {};
-    this.appIdKey = null;
-    this.pageIdKey = null;
-    this.pageLoading = false;
-
-    this.rpcClient = null;
-
-    this.removeAllListeners(RemoteDebugger.EVENT_PAGE_CHANGE);
-    this.removeAllListeners(RemoteDebugger.EVENT_DISCONNECT);
-  }
-
-  /**
-   * @returns {void}
-   */
-  initRpcClient () {
-    this.rpcClient = new RpcClientSimulator({
-      bundleId: this.bundleId,
-      platformVersion: this.platformVersion,
-      isSafari: this.isSafari,
-      host: this.host,
-      port: this.port,
-      socketPath: this.socketPath,
-      messageProxy: this.remoteDebugProxy,
-      logAllCommunication: this.logAllCommunication,
-      logAllCommunicationHexDump: this.logAllCommunicationHexDump,
-      fullPageInitialization: this.fullPageInitialization,
-      webInspectorMaxFrameLength: this.webInspectorMaxFrameLength,
-    });
-  }
-
-  /**
-   * @returns {boolean}
-   */
-  get isConnected () {
-    return !!this.rpcClient?.isConnected;
-  }
-
-  /**
-   * @param {boolean} allow
-   */
-  set allowNavigationWithoutReload (allow) {
-    this._allowNavigationWithoutReload = allow;
-  }
-
-  /**
-   * @returns {boolean}
-   */
-  get allowNavigationWithoutReload () {
-    return !!this._allowNavigationWithoutReload;
-  }
-
-  /**
-   * @returns {string[]}
-   */
-  get skippedApps () {
-    return this._skippedApps ?? [];
-  }
-}
-
-for (const [name, event] of _.toPairs(eventMixins.events)) {
-  RemoteDebugger[name] = event;
-}
-
-export default RemoteDebugger;
-
-/**
- * @typedef {Object} RemoteDebuggerOptions
- * @property {string} [bundleId] id of the app being connected to
- * @property {string[]} [additionalBundleIds=[]] array of possible bundle
- *                      ids that the inspector could return
- * @property {string} [platformVersion] version of iOS
- * @property {boolean} [isSafari=true]
- * @property {boolean} [includeSafari=false]
- * @property {boolean} [useNewSafari=false] for web inspector, whether this is a new Safari instance
- * @property {number} [pageLoadMs] the time, in ms, that should be waited for page loading
- * @property {string} [host] the remote debugger's host address
- * @property {number} [port=REMOTE_DEBUGGER_PORT] the remote debugger port through which to communicate
- * @property {string} [socketPath]
- * @property {number} [pageReadyTimeout=PAGE_READY_TIMEOUT]
- * @property {string} [remoteDebugProxy]
- * @property {boolean} [garbageCollectOnExecute=false]
- * @property {boolean} [logFullResponse=false]
- * @property {boolean} [logAllCommunication=false] log plists sent and received from Web Inspector
- * @property {boolean} [logAllCommunicationHexDump=false] log communication from Web Inspector as hex dump
- * @property {number} [webInspectorMaxFrameLength] The maximum size in bytes of a single data
- *                    frame in the device communication protocol
- * @property {number} [socketChunkSize] size, in bytes, of chunks of data sent to
- *                    Web Inspector (real device only)
- * @property {boolean} [fullPageInitialization]
- * @property {string} [pageLoadStrategy]
- * @property {import('@appium/types').AppiumLogger} [log]
- */