appium-remote-debugger 15.2.9 → 15.2.11

package/lib/mixins/misc.js

@@ -1,121 +0,0 @@
-import { checkParams } from '../utils';
-import B, { TimeoutError as BTimeoutError } from 'bluebird';
-import {
-  getAppIdKey,
-  getPageIdKey,
-} from './property-accessors';
-
-const SAFARI_BUNDLE_ID = 'com.apple.mobilesafari';
-const GARBAGE_COLLECT_TIMEOUT_MS = 5000;
-
-/**
- * @this {RemoteDebugger}
- * @returns {Promise<void>}
- */
-export async function launchSafari () {
-  await this.requireRpcClient().send('launchApplication', {
-    bundleId: SAFARI_BUNDLE_ID
-  });
-}
-
-/**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} fn
- * @returns {Promise<any>}
- */
-export async function startTimeline (fn) {
-  this.log.debug('Starting to record the timeline');
-  this.requireRpcClient().on('Timeline.eventRecorded', fn);
-  return await this.requireRpcClient().send('Timeline.start', {
-    appIdKey: getAppIdKey(this),
-    pageIdKey: getPageIdKey(this),
-  });
-}
-
-/**
- * @this {RemoteDebugger}
- * @returns {Promise<any>}
- */
-export async function stopTimeline () {
-  this.log.debug('Stopping to record the timeline');
-  await this.requireRpcClient().send('Timeline.stop', {
-    appIdKey: getAppIdKey(this),
-    pageIdKey: getPageIdKey(this),
-  });
-}
-
-// Potentially this does not work for mobile safari
-/**
- * @this {RemoteDebugger}
- * @param {string} value
- * @returns {Promise<any>}
- */
-export async function overrideUserAgent (value) {
-  this.log.debug('Setting overrideUserAgent');
-  return await this.requireRpcClient().send('Page.overrideUserAgent', {
-    appIdKey: getAppIdKey(this),
-    pageIdKey: getPageIdKey(this),
-    value,
-  });
-}
-
-/**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=1000] The maximum amount of milliseconds to wait for
- * a javascript command response
- * @returns {Promise<boolean>} Whether the current page responds to javascript commands
- */
-export async function isJavascriptExecutionBlocked (timeoutMs = 1000) {
-  try {
-    await B.resolve(
-      this.requireRpcClient().send('Runtime.evaluate', {
-        expression: '1+1;',
-        returnByValue: true,
-        appIdKey: getAppIdKey(this),
-        pageIdKey: getPageIdKey(this),
-      })
-    ).timeout(timeoutMs);
-    return false;
-  } catch {
-    return true;
-  }
-}
-
-/**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=GARBAGE_COLLECT_TIMEOUT_MS]
- * @returns {Promise<void>}
- */
-export async function garbageCollect (timeoutMs = GARBAGE_COLLECT_TIMEOUT_MS) {
-  this.log.debug(`Garbage collecting with ${timeoutMs}ms timeout`);
-
-  try {
-    checkParams({
-      appIdKey: getAppIdKey(this),
-      pageIdKey: getPageIdKey(this),
-    });
-  } catch {
-    this.log.debug(`Unable to collect garbage at this time`);
-    return;
-  }
-
-  try {
-    await B.resolve(this.requireRpcClient().send(
-      'Heap.gc', {
-        appIdKey: getAppIdKey(this),
-        pageIdKey: getPageIdKey(this),
-      })
-    ).timeout(timeoutMs);
-    this.log.debug(`Garbage collection successful`);
-  } catch (e) {
-    if (e instanceof BTimeoutError) {
-      this.log.debug(`Garbage collection timed out after ${timeoutMs}ms`);
-    } else {
-      this.log.debug(`Unable to collect garbage: ${e.message}`);
-    }
-  }
-}
-
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */

package/lib/mixins/screenshot.js

@@ -1,43 +0,0 @@
-import {
-  getAppIdKey,
-  getPageIdKey,
-} from './property-accessors';
-
-/**
- * Capture a rect of the page or by default the viewport
- * @this {RemoteDebugger}
- * @param {ScreenshotCaptureOptions} [opts={}]  if rect is null capture the whole
- * coordinate system else capture the rect in the given coordinateSystem
- * @returns {Promise<string>} a base64 encoded string of the screenshot
- */
-export async function captureScreenshot(opts = {}) {
-  const {rect = null, coordinateSystem = 'Viewport'} = opts;
-  this.log.debug('Capturing screenshot');
-
-  const arect = rect ?? /** @type {import('@appium/types').Rect} */ (await this.executeAtom(
-    'execute_script',
-    ['return {x: 0, y: 0, width: window.innerWidth, height: window.innerHeight}', []]
-  ));
-  const response = await this.requireRpcClient().send('Page.snapshotRect', {
-    ...arect,
-    appIdKey: getAppIdKey(this),
-    pageIdKey: getPageIdKey(this),
-    coordinateSystem,
-  });
-
-  if (response.error) {
-    throw new Error(response.error);
-  }
-
-  return response.dataURL.replace(/^data:image\/png;base64,/, '');
-}
-
-/**
- * @typedef {Object} ScreenshotCaptureOptions
- * @property {import('@appium/types').Rect | null} [rect=null]
- * @property {"Viewport" | "Page"} [coordinateSystem="Viewport"]
- */
-
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */