appium-remote-debugger 15.7.3 → 15.8.1

package/build/lib/utils.js

@@ -3,18 +3,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getModuleRoot = exports.RESPONSE_LOG_LENGTH = exports.WEB_CONTENT_BUNDLE_ID = void 0;
+exports.TimeoutError = exports.RESPONSE_LOG_LENGTH = exports.WEB_CONTENT_BUNDLE_ID = void 0;
+exports.truncateString = truncateString;
+exports.defaults = defaults;
+exports.isPlainObject = isPlainObject;
+exports.isEmpty = isEmpty;
+exports.uniq = uniq;
+exports.deepEqual = deepEqual;
+exports.delay = delay;
+exports.withTimeout = withTimeout;
 exports.appInfoFromDict = appInfoFromDict;
 exports.pageArrayFromDict = pageArrayFromDict;
 exports.appIdsForBundle = appIdsForBundle;
 exports.checkParams = checkParams;
 exports.simpleStringify = simpleStringify;
 exports.convertJavascriptEvaluationResult = convertJavascriptEvaluationResult;
+exports.getModuleRoot = getModuleRoot;
 exports.getModuleProperties = getModuleProperties;
 exports.canUseWebInspectorShim = canUseWebInspectorShim;
-const lodash_1 = __importDefault(require("lodash"));
 const base_driver_1 = require("@appium/base-driver");
 const support_1 = require("@appium/support");
+const node_util_1 = require("node:util");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const MODULE_NAME = 'appium-remote-debugger';
@@ -27,6 +36,132 @@ const ACCEPTED_PAGE_TYPES = [
     'WIRTypePage', // iOS 11.4 webview
 ];
 exports.RESPONSE_LOG_LENGTH = 100;
+/**
+ * Error thrown when an async operation exceeds the configured timeout.
+ */
+class TimeoutError extends Error {
+    constructor(message = 'Operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+/**
+ * Truncates a string to the requested length and appends ellipsis when needed.
+ *
+ * @param value - The input string.
+ * @param length - Maximum output length.
+ * @returns The original string when short enough, otherwise a truncated variant.
+ */
+function truncateString(value, length) {
+    if (value.length <= length) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(0, length - 1))}…`;
+}
+/**
+ * Creates a shallow object where undefined keys from `target` are filled
+ * from `defaultsObj`.
+ *
+ * @param target - The object with priority values.
+ * @param defaultsObj - The object providing fallback values.
+ * @returns A new object containing merged defaulted values.
+ */
+function defaults(target, defaultsObj) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(defaultsObj)) {
+        if (result[key] === undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Determines whether a value is a plain object.
+ *
+ * @param value - The value to check.
+ * @returns True when the value is a non-null non-array object.
+ */
+function isPlainObject(value) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+/**
+ * Checks whether a value should be treated as empty.
+ *
+ * @param value - The value to evaluate.
+ * @returns True for nullish values, empty arrays/strings/maps/sets, or empty objects.
+ */
+function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if (Array.isArray(value) || typeof value === 'string') {
+        return value.length === 0;
+    }
+    if (value instanceof Map || value instanceof Set) {
+        return value.size === 0;
+    }
+    if (isPlainObject(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
+/**
+ * Deduplicates array entries while preserving order.
+ *
+ * @param items - Items to deduplicate.
+ * @returns The input items without duplicates.
+ */
+function uniq(items) {
+    return [...new Set(items)];
+}
+/**
+ * Performs deep strict equality comparison.
+ *
+ * @param a - First value.
+ * @param b - Second value.
+ * @returns True when both values are deeply equal.
+ */
+function deepEqual(a, b) {
+    return (0, node_util_1.isDeepStrictEqual)(a, b);
+}
+/**
+ * Returns a promise that resolves after the specified delay.
+ *
+ * @param ms - Delay in milliseconds.
+ * @returns A promise that resolves when the delay expires.
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Wraps a promise with a timeout.
+ *
+ * @param promise - The promise to resolve.
+ * @param timeoutMs - Maximum time to wait in milliseconds.
+ * @param message - Optional timeout message.
+ * @returns A promise that resolves/rejects with the original promise result, or rejects on timeout.
+ */
+async function withTimeout(promise, timeoutMs, message) {
+    let timeoutId;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timeoutId = setTimeout(() => reject(new TimeoutError(message ?? `Operation timed out after ${timeoutMs}ms`)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+    }
+}
 /**
  * Takes a dictionary from the remote debugger and converts it into a more
  * manageable AppInfo object with understandable keys.
@@ -36,15 +171,15 @@ exports.RESPONSE_LOG_LENGTH = 100;
  */
 function appInfoFromDict(dict) {
     const id = dict.WIRApplicationIdentifierKey;
-    const isProxy = lodash_1.default.isString(dict.WIRIsApplicationProxyKey)
+    const isProxy = typeof dict.WIRIsApplicationProxyKey === 'string'
         ? dict.WIRIsApplicationProxyKey.toLowerCase() === 'true'
         : dict.WIRIsApplicationProxyKey;
     // automation enabled can be either from the keys
     //   - WIRRemoteAutomationEnabledKey (boolean)
     //   - WIRAutomationAvailabilityKey (string or boolean)
     let isAutomationEnabled = !!dict.WIRRemoteAutomationEnabledKey;
-    if (lodash_1.default.has(dict, 'WIRAutomationAvailabilityKey')) {
-        if (lodash_1.default.isString(dict.WIRAutomationAvailabilityKey)) {
+    if (Object.hasOwn(dict, 'WIRAutomationAvailabilityKey')) {
+        if (typeof dict.WIRAutomationAvailabilityKey === 'string') {
             isAutomationEnabled =
                 dict.WIRAutomationAvailabilityKey === 'WIRAutomationAvailabilityUnknown'
                     ? 'Unknown'
@@ -73,14 +208,14 @@ function appInfoFromDict(dict) {
  * @returns An array of Page objects representing the available pages.
  */
 function pageArrayFromDict(pageDict) {
-    return (lodash_1.default.values(pageDict)
+    return (Object.values(pageDict)
         // count only WIRTypeWeb pages and ignore all others (WIRTypeJavaScript etc)
-        .filter((dict) => lodash_1.default.isUndefined(dict.WIRTypeKey) || ACCEPTED_PAGE_TYPES.includes(dict.WIRTypeKey))
+        .filter((dict) => dict.WIRTypeKey === undefined || ACCEPTED_PAGE_TYPES.includes(dict.WIRTypeKey))
         .map((dict) => ({
         id: dict.WIRPageIdentifierKey,
         title: dict.WIRTitleKey,
         url: dict.WIRURLKey,
-        isKey: !lodash_1.default.isUndefined(dict.WIRConnectionIdentifierKey),
+        isKey: dict.WIRConnectionIdentifierKey !== undefined,
     })));
 }
 /**
@@ -93,14 +228,14 @@ function pageArrayFromDict(pageDict) {
  * @returns An array of unique application identifier keys matching the bundle ID.
  */
 function appIdsForBundle(bundleId, appDict) {
-    const appIds = lodash_1.default.toPairs(appDict)
+    const appIds = Object.entries(appDict)
         .filter(([, data]) => data.bundleId === bundleId)
         .map(([key]) => key);
     // if nothing is found, try to get the generic app
     if (appIds.length === 0 && bundleId !== exports.WEB_CONTENT_BUNDLE_ID) {
         return appIdsForBundle(exports.WEB_CONTENT_BUNDLE_ID, appDict);
     }
-    return lodash_1.default.uniq(appIds);
+    return uniq(appIds);
 }
 /**
  * Validates that all parameters in the provided object have non-nil values.
@@ -113,8 +248,8 @@ function appIdsForBundle(bundleId, appDict) {
  */
 function checkParams(params) {
     // check if all parameters have a value
-    const errors = lodash_1.default.toPairs(params)
-        .filter(([, value]) => lodash_1.default.isNil(value))
+    const errors = Object.entries(params)
+        .filter(([, value]) => value == null)
         .map(([param]) => param);
     if (errors.length) {
         throw new Error(`Missing ${support_1.util.pluralize('parameter', errors.length)}: ${errors.join(', ')}`);
@@ -122,19 +257,41 @@ function checkParams(params) {
     return params;
 }
 /**
- * Converts a value to a JSON string, removing noisy function properties
- * that can muddy the logs.
+ * Converts a value to a best-effort JSON string for logging, removing noisy
+ * function properties from cloneable objects when possible.
+ *
+ * Falls back to `String(value)` when JSON serialization returns `undefined`
+ * or throws (for example, for functions, symbols, or circular structures).
  *
  * @param value - The value to stringify.
- * @param multiline - If true, formats the JSON with indentation. Defaults to false.
- * @returns A JSON string representation of the value with noisy properties removed.
+ * @param multiline - If true, formats JSON output with indentation. Defaults to false.
+ * @returns A string representation suitable for logging.
  */
 function simpleStringify(value, multiline = false) {
+    const stringify = (val) => {
+        try {
+            return multiline
+                ? (JSON.stringify(val, null, 2) ?? String(val))
+                : (JSON.stringify(val) ?? String(val));
+        }
+        catch {
+            return String(val);
+        }
+    };
     if (!value) {
-        return JSON.stringify(value);
+        return stringify(value);
+    }
+    let cleanValue = value;
+    if (typeof value === 'object' && value !== null) {
+        try {
+            cleanValue = removeNoisyProperties(structuredClone(value));
+        }
+        catch {
+            // Fall back to the original value when cloning fails (e.g., non-cloneable graph entries).
+            cleanValue = value;
+        }
     }
-    const cleanValue = removeNoisyProperties(lodash_1.default.clone(value));
-    return multiline ? JSON.stringify(cleanValue, null, 2) : JSON.stringify(cleanValue);
+    return stringify(cleanValue);
 }
 /**
  * Converts the result from a JavaScript evaluation in the remote debugger
@@ -147,10 +304,10 @@ function simpleStringify(value, multiline = false) {
  *               an error status code.
  */
 function convertJavascriptEvaluationResult(res) {
-    if (lodash_1.default.isUndefined(res)) {
-        throw new Error(`Did not get OK result from remote debugger. Result was: ${lodash_1.default.truncate(simpleStringify(res), { length: exports.RESPONSE_LOG_LENGTH })}`);
+    if (res === undefined) {
+        throw new Error(`Did not get OK result from remote debugger. Result was: ${truncateString(simpleStringify(res), exports.RESPONSE_LOG_LENGTH)}`);
     }
-    else if (lodash_1.default.isString(res)) {
+    else if (typeof res === 'string') {
         try {
             res = JSON.parse(res);
         }
@@ -159,16 +316,16 @@ function convertJavascriptEvaluationResult(res) {
             // if we get here, it is just a value
         }
     }
-    else if (!lodash_1.default.isObject(res)) {
+    else if ((typeof res !== 'object' && typeof res !== 'function') || res === null) {
         throw new Error(`Result has unexpected type: (${typeof res}).`);
     }
-    if (res.status && res.status !== 0) {
+    if (Object.hasOwn(res, 'status') && res.status !== 0) {
         // we got some form of error.
         throw (0, base_driver_1.errorFromMJSONWPStatusCode)(res.status, res.value.message || res.value);
     }
     // with either have an object with a `value` property (even if `null`),
     // or a plain object
-    const value = lodash_1.default.has(res, 'value') ? res.value : res;
+    const value = Object.hasOwn(res, 'value') ? res.value : res;
     return removeNoisyProperties(value);
 }
 /**
@@ -178,20 +335,31 @@ function convertJavascriptEvaluationResult(res) {
  * @returns The full path to the module root directory.
  * @throws Error if the module root folder cannot be determined.
  */
-exports.getModuleRoot = lodash_1.default.memoize(function getModuleRoot() {
+let cachedModuleRoot;
+/**
+ * Calculates and memoizes the path to the current module root.
+ *
+ * @returns The full path to the module root directory.
+ * @throws Error if the module root folder cannot be determined.
+ */
+function getModuleRoot() {
+    if (cachedModuleRoot) {
+        return cachedModuleRoot;
+    }
     const root = support_1.node.getModuleRootSync(MODULE_NAME, __filename);
     if (!root) {
         throw new Error(`Cannot find the root folder of the ${MODULE_NAME} Node.js module`);
     }
+    cachedModuleRoot = root;
     return root;
-});
+}
 /**
  * Reads and parses the package.json file from the module root.
  *
  * @returns The parsed package.json contents as a StringRecord.
  */
 function getModuleProperties() {
-    const fullPath = node_path_1.default.resolve((0, exports.getModuleRoot)(), 'package.json');
+    const fullPath = node_path_1.default.resolve(getModuleRoot(), 'package.json');
     return JSON.parse(node_fs_1.default.readFileSync(fullPath, 'utf8'));
 }
 /**
@@ -210,7 +378,7 @@ function canUseWebInspectorShim(platformVersion) {
  * @returns The cleaned object.
  */
 function removeNoisyProperties(obj) {
-    if (lodash_1.default.isObject(obj)) {
+    if (obj && typeof obj === 'object') {
         for (const property of ['ceil', 'clone', 'floor', 'round', 'scale', 'toString']) {
             delete obj[property];
         }

package/build/lib/utils.js.map

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

package/lib/atoms.ts

@@ -1,24 +1,10 @@
 import {fs} from '@appium/support';
 import path from 'node:path';
-import _ from 'lodash';
 import {log} from './logger';
 import {getModuleRoot} from './utils';
 
 const ATOMS_CACHE: Record<string, Buffer> = {};
 
-/**
- * Converts a value to a JSON string, handling undefined values specially.
- *
- * @param obj - The value to stringify.
- * @returns A JSON string representation of the value, or 'undefined' if the value is undefined.
- */
-function atomsStringify(obj: any): string {
-  if (typeof obj === 'undefined') {
-    return 'undefined';
-  }
-  return JSON.stringify(obj);
-}
-
 /**
  * Loads an atom script from the atoms directory and caches it.
  * If the atom has been loaded before, returns the cached version.
@@ -29,7 +15,7 @@ function atomsStringify(obj: any): string {
  */
 export async function getAtom(atomName: string): Promise<Buffer> {
   // check if we have already loaded and cached this atom
-  if (!_.has(ATOMS_CACHE, atomName)) {
+  if (!Object.hasOwn(ATOMS_CACHE, atomName)) {
     const atomFileName = path.resolve(getModuleRoot(), 'atoms', `${atomName}.js`);
     try {
       ATOMS_CACHE[atomName] = await fs.readFile(atomFileName);
@@ -41,23 +27,6 @@ export async function getAtom(atomName: string): Promise<Buffer> {
   return ATOMS_CACHE[atomName];
 }
 
-/**
- * Wraps a script to execute it within a specific frame context.
- * Uses the get_element_from_cache atom to access the frame element.
- *
- * @param script - The script to wrap.
- * @param frame - The frame identifier to execute the script in.
- * @returns A promise that resolves to the wrapped script string.
- */
-async function wrapScriptForFrame(script: string, frame: string): Promise<string> {
-  log.debug(`Wrapping script for frame '${frame}'`);
-  const elFromCache = await getAtom('get_element_from_cache');
-  return (
-    `(function (window) { var document = window.document; ` +
-    `return (${script}); })((${elFromCache.toString('utf8')})(${atomsStringify(frame)}))`
-  );
-}
-
 /**
  * Generates a complete script string for executing a Selenium atom.
  * Handles frame contexts and optional async callbacks.
@@ -98,3 +67,33 @@ export async function getScriptForAtom(
 
   return script;
 }
+
+/**
+ * Converts a value to a JSON string, handling undefined values specially.
+ *
+ * @param obj - The value to stringify.
+ * @returns A JSON string representation of the value, or 'undefined' if the value is undefined.
+ */
+function atomsStringify(obj: any): string {
+  if (typeof obj === 'undefined') {
+    return 'undefined';
+  }
+  return JSON.stringify(obj);
+}
+
+/**
+ * Wraps a script to execute it within a specific frame context.
+ * Uses the get_element_from_cache atom to access the frame element.
+ *
+ * @param script - The script to wrap.
+ * @param frame - The frame identifier to execute the script in.
+ * @returns A promise that resolves to the wrapped script string.
+ */
+async function wrapScriptForFrame(script: string, frame: string): Promise<string> {
+  log.debug(`Wrapping script for frame '${frame}'`);
+  const elFromCache = await getAtom('get_element_from_cache');
+  return (
+    `(function (window) { var document = window.document; ` +
+    `return (${script}); })((${elFromCache.toString('utf8')})(${atomsStringify(frame)}))`
+  );
+}

package/lib/index.ts

@@ -10,6 +10,13 @@ export function createRemoteDebugger(
   opts: RemoteDebuggerOptions,
   realDevice: false,
 ): RemoteDebugger;
+/**
+ * Creates a remote debugger instance for either simulator or real device flows.
+ *
+ * @param opts - Configuration options for the selected debugger type.
+ * @param realDevice - Whether to create the real-device debugger implementation.
+ * @returns The initialized debugger instance for the selected target type.
+ */
 export function createRemoteDebugger(
   opts: RemoteDebuggerRealDeviceOptions | RemoteDebuggerOptions,
   realDevice: boolean,

package/lib/mixins/connect.ts

@@ -1,8 +1,7 @@
-import {pageArrayFromDict, WEB_CONTENT_BUNDLE_ID, appIdsForBundle} from '../utils';
+import {isEmpty, pageArrayFromDict, uniq, WEB_CONTENT_BUNDLE_ID, appIdsForBundle} from '../utils';
 import {events} from './events';
 import {timing, util} from '@appium/support';
 import {retryInterval, waitForCondition} from 'asyncbox';
-import _ from 'lodash';
 import {
   setAppIdKey,
   getAppDict,
@@ -66,7 +65,7 @@ export async function connect(
   const rpcClient = this.requireRpcClient();
 
   // listen for basic debugger-level events
-  rpcClient.on('_rpc_reportSetup:', _.noop);
+  rpcClient.on('_rpc_reportSetup:', () => {});
   rpcClient.on('_rpc_forwardGetListing:', this.onPageChange.bind(this));
   rpcClient.on('_rpc_reportConnectedApplicationList:', this.onConnectedApplicationList.bind(this));
   rpcClient.on('_rpc_applicationConnected:', this.onAppConnect.bind(this));
@@ -85,12 +84,12 @@ export async function connect(
       const timer = new timing.Timer().start();
       this.log.debug(`Waiting up to ${timeout}ms for applications to be reported`);
       try {
-        await waitForCondition(() => !_.isEmpty(getAppDict(this)), {
+        await waitForCondition(() => !isEmpty(getAppDict(this)), {
           waitMs: timeout,
           intervalMs: APP_CONNECT_INTERVAL_MS,
         });
         this.log.debug(
-          `Retrieved ${util.pluralize('application', _.size(getAppDict(this)), true)} ` +
+          `Retrieved ${util.pluralize('application', Object.keys(getAppDict(this)).length, true)} ` +
             `within ${timer.getDuration().asMilliSeconds.toFixed(0)}ms`,
         );
       } catch {
@@ -139,7 +138,7 @@ export async function selectApp(
   this.log.debug('Selecting application');
 
   const timer = new timing.Timer().start();
-  if (_.isEmpty(getAppDict(this))) {
+  if (isEmpty(getAppDict(this))) {
     this.log.debug('No applications currently connected.');
     return [];
   }
@@ -160,14 +159,14 @@ export async function selectApp(
   this.log.debug(`Finally selecting app ${getAppIdKey(this)}`);
 
   const fullPageArray: Page[] = [];
-  for (const [app, info] of _.toPairs(getAppDict(this))) {
-    if (!_.isArray(info.pageArray) || !info.isActive) {
+  for (const [app, info] of Object.entries(getAppDict(this))) {
+    if (!Array.isArray(info.pageArray) || !info.isActive) {
       continue;
     }
     const id = app.replace('PID:', '');
     for (const page of info.pageArray) {
       if (!(ignoreAboutBlankUrl && page.url === BLANK_PAGE_URL)) {
-        const pageDict = _.clone(page);
+        const pageDict = {...page};
         pageDict.id = `${id}.${pageDict.id}`;
         pageDict.bundleId = info.bundleId;
         fullPageArray.push(pageDict);
@@ -196,7 +195,7 @@ export async function selectPage(
   pageIdKey: PageIdKey,
   skipReadyCheck: boolean = false,
 ): Promise<void> {
-  const fullAppIdKey = _.startsWith(`${appIdKey}`, 'PID:') ? `${appIdKey}` : `PID:${appIdKey}`;
+  const fullAppIdKey = `${appIdKey}`.startsWith('PID:') ? `${appIdKey}` : `PID:${appIdKey}`;
   setAppIdKey(this, fullAppIdKey);
   setPageIdKey(this, pageIdKey);
 
@@ -233,11 +232,11 @@ export function getPossibleDebuggerAppKeys(this: RemoteDebugger, bundleIds: stri
     this.log.info(
       'Returning all apps because the list of matching bundle identifiers includes a wildcard',
     );
-    return _.keys(appDict);
+    return Object.keys(appDict);
   }
 
   // go through the possible bundle identifiers
-  const possibleBundleIds = _.uniq([
+  const possibleBundleIds = uniq([
     WEB_CONTENT_BUNDLE_ID,
     WEB_CONTENT_PROCESS_BUNDLE_ID,
     SAFARI_VIEW_PROCESS_BUNDLE_ID,
@@ -257,7 +256,7 @@ export function getPossibleDebuggerAppKeys(this: RemoteDebugger, bundleIds: stri
 
       proxiedAppIds.push(appId);
       this.log.debug(`Found app id key '${appId}' for bundle '${bundleId}'`);
-      for (const [key, data] of _.toPairs(appDict)) {
+      for (const [key, data] of Object.entries(appDict)) {
         if (data.isProxy && data.hostId === appId && !proxiedAppIds.includes(key)) {
           this.log.debug(
             `Found separate bundleId '${data.bundleId}' ` +
@@ -274,7 +273,7 @@ export function getPossibleDebuggerAppKeys(this: RemoteDebugger, bundleIds: stri
       `capability to match other applications. Add a wildcard ('*') to match all apps.`,
   );
 
-  return _.uniq(proxiedAppIds);
+  return uniq(proxiedAppIds);
 }
 
 /**
@@ -298,11 +297,11 @@ async function searchForApp(
   maxTries: number,
   ignoreAboutBlankUrl: boolean,
 ): Promise<AppPage> {
-  const bundleIds: string[] = _.compact([
+  const bundleIds: string[] = [
     getBundleId(this),
     ...(getAdditionalBundleIds(this) ?? []),
     ...(getIncludeSafari(this) && !getIsSafari(this) ? [SAFARI_BUNDLE_ID] : []),
-  ]);
+  ].filter((bundleId): bundleId is string => !!bundleId);
   let retryCount = 0;
   return (await retryInterval(maxTries, SELECT_APP_RETRY_SLEEP_MS, async () => {
     logApplicationDictionary.bind(this)();
@@ -381,8 +380,8 @@ function searchForPage(
   currentUrl: string | null = null,
   ignoreAboutBlankUrl: boolean = false,
 ): AppPage | null {
-  for (const appDict of _.values(appsDict)) {
-    if (!appDict || !appDict.isActive || !appDict.pageArray || _.isEmpty(appDict.pageArray)) {
+  for (const appDict of Object.values(appsDict)) {
+    if (!appDict || !appDict.isActive || !appDict.pageArray || appDict.pageArray.length === 0) {
       continue;
     }
 
@@ -418,7 +417,7 @@ function isAppIgnored(instance: RemoteDebugger): boolean {
     return false;
   }
   const ignoredSet = new Set(ignoredBundleIds);
-  const appBundleIds = new Set(_.values(getAppDict(instance)).map((app) => app.bundleId));
+  const appBundleIds = new Set(Object.values(getAppDict(instance)).map((app) => app.bundleId));
   if (appBundleIds.size === 0) {
     return false;
   }
@@ -447,20 +446,20 @@ function isAppIgnored(instance: RemoteDebugger): boolean {
  */
 function logApplicationDictionary(this: RemoteDebugger): void {
   this.log.debug('Current applications available:');
-  for (const [app, info] of _.toPairs(getAppDict(this))) {
+  for (const [app, info] of Object.entries(getAppDict(this))) {
     this.log.debug(`    Application: "${app}"`);
-    for (const [key, value] of _.toPairs(info)) {
+    for (const [key, value] of Object.entries(info)) {
       if (key === 'pageArray' && Array.isArray(value) && value.length) {
         this.log.debug(`        ${key}:`);
         for (const page of value) {
           let prefix = '- ';
-          for (const [k, v] of _.toPairs(page)) {
+          for (const [k, v] of Object.entries(page)) {
             this.log.debug(`          ${prefix}${k}: ${JSON.stringify(v)}`);
             prefix = '  ';
           }
         }
       } else {
-        const valueString = _.isFunction(value) ? '[Function]' : JSON.stringify(value);
+        const valueString = typeof value === 'function' ? '[Function]' : JSON.stringify(value);
         this.log.debug(`        ${key}: ${valueString}`);
       }
     }