appium-remote-debugger 15.2.9 → 15.2.11

package/build/lib/mixins/message-handlers.js

@@ -20,11 +20,13 @@ const property_accessors_1 = require("./property-accessors");
  * These will be added to the prototype.
  */
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {string} appIdKey
- * @param {Record<string, any>} pageDict
- * @returns {Promise<void>}
+ * Handles page change notifications from the remote debugger.
+ * Updates the page array for the specified application and emits a page change
+ * event if the pages have actually changed and navigation is not in progress.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param appIdKey - The application identifier key for which pages have changed.
+ * @param pageDict - Dictionary containing the new page information.
  */
 async function onPageChange(err, appIdKey, pageDict) {
     if (lodash_1.default.isEmpty(pageDict)) {
@@ -54,10 +56,12 @@ async function onPageChange(err, appIdKey, pageDict) {
     });
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} dict
- * @returns {Promise<void>}
+ * Handles notifications when a new application connects to the remote debugger.
+ * Updates the application dictionary with the new application information.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the new application information including
+ *               the WIRApplicationIdentifierKey.
  */
 async function onAppConnect(err, dict) {
     const appIdKey = dict.WIRApplicationIdentifierKey;
@@ -65,10 +69,14 @@ async function onAppConnect(err, dict) {
     updateAppsWithDict.bind(this)(dict);
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {import('@appium/types').StringRecord} dict
- * @returns {void}
+ * Handles notifications when an application disconnects from the remote debugger.
+ * Removes the application from the dictionary and attempts to find a replacement
+ * if the disconnected app was the currently selected one. Emits a disconnect event
+ * if no applications remain.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the disconnected application information
+ *               including the WIRApplicationIdentifierKey.
  */
 function onAppDisconnect(err, dict) {
     const appIdKey = dict.WIRApplicationIdentifierKey;
@@ -80,7 +88,7 @@ function onAppDisconnect(err, dict) {
     // if the disconnected app is the one we are connected to, try to find another
     if ((0, property_accessors_1.getAppIdKey)(this) === appIdKey) {
         this.log.debug(`No longer have app id. Attempting to find new one.`);
-        (0, property_accessors_1.setAppIdKey)(this, getDebuggerAppKey.bind(this)(/** @type {string} */ ((0, property_accessors_1.getBundleId)(this))));
+        (0, property_accessors_1.setAppIdKey)(this, getDebuggerAppKey.bind(this)((0, property_accessors_1.getBundleId)(this)));
     }
     if (lodash_1.default.isEmpty((0, property_accessors_1.getAppDict)(this))) {
         // this means we no longer have any apps. what the what?
@@ -89,30 +97,38 @@ function onAppDisconnect(err, dict) {
     }
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} dict
- * @returns {Promise<void>}
+ * Handles notifications when an application's information is updated.
+ * Updates the application dictionary with the new information while preserving
+ * any existing page array data.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param dict - Dictionary containing the updated application information.
  */
 async function onAppUpdate(err, dict) {
     this.log.debug(`Notified that an application has been updated`);
     updateAppsWithDict.bind(this)(dict);
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} drivers
- * @returns {void}
+ * Handles notifications containing the list of connected drivers.
+ * Updates the internal connected drivers list with the received information.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param drivers - Dictionary containing the connected driver list with
+ *                  WIRDriverDictionaryKey.
  */
 function onConnectedDriverList(err, drivers) {
     (0, property_accessors_1.setConnectedDrivers)(this, drivers.WIRDriverDictionaryKey);
     this.log.debug(`Received connected driver list: ${JSON.stringify(this.connectedDrivers)}`);
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} state
- * @returns {void}
+ * Handles notifications about the current automation availability state.
+ * This state changes when 'Remote Automation' setting in Safari's advanced settings
+ * is toggled. The state can be either WIRAutomationAvailabilityAvailable or
+ * WIRAutomationAvailabilityNotAvailable.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param state - Dictionary containing the automation availability state with
+ *                WIRAutomationAvailabilityKey.
  */
 function onCurrentState(err, state) {
     (0, property_accessors_1.setCurrentState)(this, state.WIRAutomationAvailabilityKey);
@@ -121,16 +137,18 @@ function onCurrentState(err, state) {
     this.log.debug(`Received connected automation availability state: ${JSON.stringify(this.currentState)}`);
 }
 /**
- * @this {RemoteDebugger}
- * @param {Error?} err
- * @param {Record<string, any>} apps
- * @returns {Promise<void>}
+ * Handles notifications containing the list of connected applications.
+ * Translates the received information into the application dictionary format,
+ * filtering out any applications that are in the skipped apps list.
+ *
+ * @param err - Error object if an error occurred, null or undefined otherwise.
+ * @param apps - Dictionary containing the connected applications list.
  */
 async function onConnectedApplicationList(err, apps) {
     this.log.debug(`Received connected applications list: ${lodash_1.default.keys(apps).join(', ')}`);
     // translate the received information into an easier-to-manage
     // hash with app id as key, and app info as value
-    let newDict = {};
+    const newDict = {};
     for (const dict of lodash_1.default.values(apps)) {
         const [id, entry] = (0, utils_1.appInfoFromDict)(dict);
         if ((0, property_accessors_1.getSkippedApps)(this).includes(entry.name)) {
@@ -142,32 +160,13 @@ async function onConnectedApplicationList(err, apps) {
     lodash_1.default.defaults((0, property_accessors_1.getAppDict)(this), newDict);
 }
 /**
+ * Given a bundle ID, finds the correct remote debugger app identifier key
+ * that is currently connected. Also handles proxy applications that may act
+ * on behalf of the requested bundle ID.
  *
- * @this {RemoteDebugger}
- * @param {import('@appium/types').StringRecord} dict
- * @returns {void}
- */
-function updateAppsWithDict(dict) {
-    // get the dictionary entry into a nice form, and add it to the
-    // application dictionary
-    const [id, entry] = (0, utils_1.appInfoFromDict)(dict);
-    if ((0, property_accessors_1.getAppDict)(this)[id]?.pageArray) {
-        // preserve the page dictionary for this entry
-        entry.pageArray = (0, property_accessors_1.getAppDict)(this)[id].pageArray;
-    }
-    (0, property_accessors_1.getAppDict)(this)[id] = entry;
-    // try to get the app id from our connected apps
-    if (!(0, property_accessors_1.getAppIdKey)(this)) {
-        (0, property_accessors_1.setAppIdKey)(this, getDebuggerAppKey.bind(this)(/** @type {string} */ ((0, property_accessors_1.getBundleId)(this))));
-    }
-}
-/**
- * Given a bundle id, finds the correct remote debugger app that is
- * connected.
- *
- * @this {RemoteDebugger}
- * @param {string} bundleId
- * @returns {string|undefined}
+ * @param bundleId - The bundle identifier to search for.
+ * @returns The application identifier key if found, undefined otherwise.
+ *          If a proxy application is found, returns the proxy's app ID instead.
  */
 function getDebuggerAppKey(bundleId) {
     let appId;
@@ -197,6 +196,24 @@ function getDebuggerAppKey(bundleId) {
     return appId;
 }
 /**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
+ * Updates the application dictionary with information from the provided dictionary.
+ * Preserves existing page array data if the application already exists in the dictionary.
+ * Attempts to set the app ID key if one is not currently set.
+ *
+ * @param dict - Dictionary containing application information to add or update.
  */
+function updateAppsWithDict(dict) {
+    // get the dictionary entry into a nice form, and add it to the
+    // application dictionary
+    const [id, entry] = (0, utils_1.appInfoFromDict)(dict);
+    if ((0, property_accessors_1.getAppDict)(this)[id]?.pageArray) {
+        // preserve the page dictionary for this entry
+        entry.pageArray = (0, property_accessors_1.getAppDict)(this)[id].pageArray;
+    }
+    (0, property_accessors_1.getAppDict)(this)[id] = entry;
+    // try to get the app id from our connected apps
+    if (!(0, property_accessors_1.getAppIdKey)(this)) {
+        (0, property_accessors_1.setAppIdKey)(this, getDebuggerAppKey.bind(this)((0, property_accessors_1.getBundleId)(this)));
+    }
+}
 //# sourceMappingURL=message-handlers.js.map

package/build/lib/mixins/message-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-handlers.js","sourceRoot":"","sources":["../../../lib/mixins/message-handlers.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"message-handlers.js","sourceRoot":"","sources":["../../../lib/mixins/message-handlers.ts"],"names":[],"mappings":"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"}

package/build/lib/mixins/misc.d.ts

@@ -1,37 +1,47 @@
+import type { RemoteDebugger } from '../remote-debugger';
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<void>}
+ * Launches Safari application on the device by sending a launch command
+ * to the remote debugger.
  */
-export function launchSafari(this: import("../remote-debugger").RemoteDebugger): Promise<void>;
+export declare function launchSafari(this: RemoteDebugger): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} fn
- * @returns {Promise<any>}
+ * Starts recording the timeline by registering an event listener and
+ * sending the Timeline.start command to the remote debugger.
+ *
+ * @param fn - Event listener function that will be called when timeline events are recorded.
+ * @returns A promise that resolves when the timeline recording has started.
  */
-export function startTimeline(this: import("../remote-debugger").RemoteDebugger, fn: import("../types").EventListener): Promise<any>;
+export declare function startTimeline(this: RemoteDebugger, fn: import('../types').EventListener): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<any>}
+ * Stops recording the timeline by sending the Timeline.stop command
+ * to the remote debugger.
  */
-export function stopTimeline(this: import("../remote-debugger").RemoteDebugger): Promise<any>;
+export declare function stopTimeline(this: RemoteDebugger): Promise<any>;
 /**
- * @this {RemoteDebugger}
- * @param {string} value
- * @returns {Promise<any>}
+ * Overrides the user agent string for the current page.
+ * Note: This may not work for mobile Safari.
+ *
+ * @param value - The user agent string to set.
+ * @returns A promise that resolves when the user agent has been overridden.
  */
-export function overrideUserAgent(this: import("../remote-debugger").RemoteDebugger, value: string): Promise<any>;
+export declare function overrideUserAgent(this: RemoteDebugger, value: string): Promise<any>;
 /**
- * @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
+ * Checks whether JavaScript execution is currently blocked on the page
+ * by attempting to execute a simple JavaScript command with a timeout.
+ *
+ * @param timeoutMs - The maximum amount of milliseconds to wait for a JavaScript
+ *                    command response. Defaults to 1000ms.
+ * @returns A promise that resolves to true if JavaScript execution is blocked,
+ *          false if it is not blocked.
  */
-export function isJavascriptExecutionBlocked(this: import("../remote-debugger").RemoteDebugger, timeoutMs?: number): Promise<boolean>;
+export declare function isJavascriptExecutionBlocked(this: RemoteDebugger, timeoutMs?: number): Promise<boolean>;
 /**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=GARBAGE_COLLECT_TIMEOUT_MS]
- * @returns {Promise<void>}
+ * Triggers garbage collection on the page's JavaScript heap.
+ * This method will gracefully handle cases where garbage collection cannot
+ * be performed (e.g., when not connected to a page).
+ *
+ * @param timeoutMs - Maximum time in milliseconds to wait for garbage collection
+ *                    to complete. Defaults to GARBAGE_COLLECT_TIMEOUT_MS (5000ms).
  */
-export function garbageCollect(this: import("../remote-debugger").RemoteDebugger, timeoutMs?: number): Promise<void>;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
+export declare function garbageCollect(this: RemoteDebugger, timeoutMs?: number): Promise<void>;
 //# sourceMappingURL=misc.d.ts.map

package/build/lib/mixins/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../lib/mixins/misc.js"],"names":[],"mappings":"AAUA;;;GAGG;AACH,iFAFa,OAAO,CAAC,IAAI,CAAC,CAMzB;AAED;;;;GAIG;AACH,qFAHW,OAAO,UAAU,EAAE,aAAa,GAC9B,OAAO,CAAC,GAAG,CAAC,CASxB;AAED;;;GAGG;AACH,iFAFa,OAAO,CAAC,GAAG,CAAC,CAQxB;AAGD;;;;GAIG;AACH,4FAHW,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CASxB;AAED;;;;;GAKG;AACH,4GAJW,MAAM,GAEJ,OAAO,CAAC,OAAO,CAAC,CAgB5B;AAED;;;;GAIG;AACH,8FAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA8BzB;6BAGY,OAAO,oBAAoB,EAAE,cAAc"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../lib/mixins/misc.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,cAAc,EACpB,EAAE,EAAE,OAAO,UAAU,EAAE,aAAa,GACnC,OAAO,CAAC,GAAG,CAAC,CAOd;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAMrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAOzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/build/lib/mixins/misc.js

@@ -45,8 +45,8 @@ const property_accessors_1 = require("./property-accessors");
 const SAFARI_BUNDLE_ID = 'com.apple.mobilesafari';
 const GARBAGE_COLLECT_TIMEOUT_MS = 5000;
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<void>}
+ * Launches Safari application on the device by sending a launch command
+ * to the remote debugger.
  */
 async function launchSafari() {
     await this.requireRpcClient().send('launchApplication', {
@@ -54,9 +54,11 @@ async function launchSafari() {
     });
 }
 /**
- * @this {RemoteDebugger}
- * @param {import('../types').EventListener} fn
- * @returns {Promise<any>}
+ * Starts recording the timeline by registering an event listener and
+ * sending the Timeline.start command to the remote debugger.
+ *
+ * @param fn - Event listener function that will be called when timeline events are recorded.
+ * @returns A promise that resolves when the timeline recording has started.
  */
 async function startTimeline(fn) {
     this.log.debug('Starting to record the timeline');
@@ -67,8 +69,8 @@ async function startTimeline(fn) {
     });
 }
 /**
- * @this {RemoteDebugger}
- * @returns {Promise<any>}
+ * Stops recording the timeline by sending the Timeline.stop command
+ * to the remote debugger.
  */
 async function stopTimeline() {
     this.log.debug('Stopping to record the timeline');
@@ -77,11 +79,12 @@ async function stopTimeline() {
         pageIdKey: (0, property_accessors_1.getPageIdKey)(this),
     });
 }
-// Potentially this does not work for mobile safari
 /**
- * @this {RemoteDebugger}
- * @param {string} value
- * @returns {Promise<any>}
+ * Overrides the user agent string for the current page.
+ * Note: This may not work for mobile Safari.
+ *
+ * @param value - The user agent string to set.
+ * @returns A promise that resolves when the user agent has been overridden.
  */
 async function overrideUserAgent(value) {
     this.log.debug('Setting overrideUserAgent');
@@ -92,10 +95,13 @@ async function overrideUserAgent(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
+ * Checks whether JavaScript execution is currently blocked on the page
+ * by attempting to execute a simple JavaScript command with a timeout.
+ *
+ * @param timeoutMs - The maximum amount of milliseconds to wait for a JavaScript
+ *                    command response. Defaults to 1000ms.
+ * @returns A promise that resolves to true if JavaScript execution is blocked,
+ *          false if it is not blocked.
  */
 async function isJavascriptExecutionBlocked(timeoutMs = 1000) {
     try {
@@ -112,9 +118,12 @@ async function isJavascriptExecutionBlocked(timeoutMs = 1000) {
     }
 }
 /**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs=GARBAGE_COLLECT_TIMEOUT_MS]
- * @returns {Promise<void>}
+ * Triggers garbage collection on the page's JavaScript heap.
+ * This method will gracefully handle cases where garbage collection cannot
+ * be performed (e.g., when not connected to a page).
+ *
+ * @param timeoutMs - Maximum time in milliseconds to wait for garbage collection
+ *                    to complete. Defaults to GARBAGE_COLLECT_TIMEOUT_MS (5000ms).
  */
 async function garbageCollect(timeoutMs = GARBAGE_COLLECT_TIMEOUT_MS) {
     this.log.debug(`Garbage collecting with ${timeoutMs}ms timeout`);
@@ -144,7 +153,4 @@ async function garbageCollect(timeoutMs = GARBAGE_COLLECT_TIMEOUT_MS) {
         }
     }
 }
-/**
- * @typedef {import('../remote-debugger').RemoteDebugger} RemoteDebugger
- */
 //# sourceMappingURL=misc.js.map

package/build/lib/mixins/misc.js.map

@@ -1 +1 @@
-{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../lib/mixins/misc.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../lib/mixins/misc.ts"],"names":[],"mappings":"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"}

package/build/lib/mixins/navigate.d.ts

@@ -1,41 +1,53 @@
+import { timing } from '@appium/support';
+import type { RemoteDebugger } from '../remote-debugger';
+export declare const DEFAULT_PAGE_READINESS_TIMEOUT_MS: number;
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Emits a frame detached event when a frame is detached from the page.
+ * This is typically called by the RPC client when receiving a Page.frameDetached event.
  */
-export function frameDetached(this: import("../remote-debugger").RemoteDebugger): void;
+export declare function frameDetached(this: RemoteDebugger): void;
 /**
- * @this {RemoteDebugger}
- * @returns {void}
+ * Cancels the current page load operation by unregistering from page readiness
+ * notifications and canceling any pending page load delay.
  */
-export function cancelPageLoad(this: import("../remote-debugger").RemoteDebugger): void;
+export declare function cancelPageLoad(this: RemoteDebugger): void;
 /**
- * Return if current readState can be handles as page load completes
- * for the given page load strategy.
+ * Determines if the current readyState indicates that page loading is completed
+ * based on the configured page load strategy.
  *
- * @this {RemoteDebugger}
- * @param {string} readyState
- * @returns {boolean}
+ * @param readyState - The document readyState value ('loading', 'interactive', or 'complete').
+ * @returns True if the page load is considered complete for the current strategy:
+ *          - 'eager': returns true when readyState is not 'loading'
+ *          - 'none': always returns true
+ *          - 'normal' (default): returns true only when readyState is 'complete'
  */
-export function isPageLoadingCompleted(this: import("../remote-debugger").RemoteDebugger, readyState: string): boolean;
+export declare function isPageLoadingCompleted(this: RemoteDebugger, readyState: string): boolean;
 /**
- * @this {RemoteDebugger}
- * @param {timing.Timer?} [startPageLoadTimer]
- * @returns {Promise<void>}
+ * Waits for the DOM to be ready by periodically checking the page readiness state.
+ * Uses exponential backoff for retry intervals and respects the configured page load
+ * strategy and timeout settings.
+ *
+ * @param startPageLoadTimer - Optional timer instance to use for tracking elapsed time.
+ *                             If not provided, a new timer will be created and started.
  */
-export function waitForDom(this: import("../remote-debugger").RemoteDebugger, startPageLoadTimer?: timing.Timer | null): Promise<void>;
+export declare function waitForDom(this: RemoteDebugger, startPageLoadTimer?: timing.Timer): Promise<void>;
 /**
- * @this {RemoteDebugger}
- * @param {number} [timeoutMs]
- * @returns {Promise<boolean>}
+ * Checks if the current page is ready by executing a JavaScript command to
+ * retrieve the document readyState and evaluating it against the page load strategy.
+ *
+ * @param timeoutMs - Optional timeout in milliseconds for the readyState check.
+ *                    If not provided, uses the configured page ready timeout.
+ * @returns A promise that resolves to true if the page is ready according to
+ *          the page load strategy, false otherwise or if the check times out.
  */
-export function checkPageIsReady(this: import("../remote-debugger").RemoteDebugger, timeoutMs?: number): Promise<boolean>;
+export declare function checkPageIsReady(this: RemoteDebugger, timeoutMs?: number): Promise<boolean>;
 /**
- * @this {RemoteDebugger}
- * @param {string} url
- * @returns {Promise<void>}
+ * Navigates to a new URL and waits for the page to be ready.
+ * Validates the URL format, waits for the page to be available, sends the navigation
+ * command, and monitors for the Page.loadEventFired event or timeout.
+ *
+ * @param url - The URL to navigate to. Must be a valid URL format.
+ * @throws TypeError if the provided URL is not a valid URL format.
  */
-export function navToUrl(this: import("../remote-debugger").RemoteDebugger, url: string): Promise<void>;
-export const DEFAULT_PAGE_READINESS_TIMEOUT_MS: number;
-export type RemoteDebugger = import("../remote-debugger").RemoteDebugger;
-import { timing } from '@appium/support';
+export declare function navToUrl(this: RemoteDebugger, url: string): Promise<void>;
 //# sourceMappingURL=navigate.d.ts.map

package/build/lib/mixins/navigate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../lib/mixins/navigate.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,kFAFa,IAAI,CAIhB;AAED;;;GAGG;AACH,mFAFa,IAAI,CAMhB;AAED;;;;;;;GAOG;AACH,sGAHW,MAAM,GACJ,OAAO,CAcnB;AAED;;;;GAIG;AACH,mGAHW,MAAM,CAAC,KAAK,OAAC,GACX,OAAO,CAAC,IAAI,CAAC,CA+DzB;AAED;;;;GAIG;AACH,gGAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAuB5B;AAED;;;;GAIG;AACH,iFAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAwFzB;AA/OD,uDAA2D;6BAkP9C,OAAO,oBAAoB,EAAE,cAAc;uBAhQ3B,iBAAiB"}
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../../lib/mixins/navigate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAQ,MAAM,iBAAiB,CAAC;AAa/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAY3D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAIzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAYxF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DvG;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBjG;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF/E"}