appium-android-driver 14.0.2 → 14.0.4

package/lib/commands/legacy.ts

@@ -1,4 +1,5 @@
 import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../driver.js';
 
 const ISSUE_URL = 'https://github.com/appium/appium/issues/15807';

package/lib/commands/lock/exports.ts

@@ -1,4 +1,7 @@
 import {sleep} from 'asyncbox';
+
+import type {AndroidDriver, AndroidDriverCaps} from '../../driver.js';
+import type {UnlockType} from '../types.js';
 import {
   validateUnlockCapabilities,
   FINGERPRINT_UNLOCK,
@@ -15,8 +18,6 @@ import {
   toCredentialType,
   verifyUnlock,
 } from './helpers.js';
-import type {AndroidDriver, AndroidDriverCaps} from '../../driver.js';
-import type {UnlockType} from '../types.js';
 
 /**
  * Locks the device and optionally unlocks it after a specified number of seconds.
@@ -90,10 +91,7 @@ export async function mobileUnlock(
  *
  * @param caps - Optional capabilities to use for unlocking. If not provided, uses session capabilities.
  */
-export async function unlockWithOptions(
-  this: AndroidDriver,
-  caps: AndroidDriverCaps | null = null,
-): Promise<void> {
+export async function unlockWithOptions(this: AndroidDriver, caps: AndroidDriverCaps | null = null): Promise<void> {
   if (!(await this.adb.isScreenLocked())) {
     this.log.info('Screen already unlocked, doing nothing');
     return;
@@ -126,10 +124,7 @@ export async function unlockWithOptions(
       credentialType: toCredentialType(unlockType as UnlockType),
     });
   } else {
-    const unlockMethodMap: Record<
-      string,
-      (this: AndroidDriver, caps: AndroidDriverCaps) => Promise<void>
-    > = {
+    const unlockMethodMap: Record<string, (this: AndroidDriver, caps: AndroidDriverCaps) => Promise<void>> = {
       [PIN_UNLOCK]: pinUnlock,
       [PIN_UNLOCK_KEY_EVENT]: pinUnlockWithKeyEvent,
       [PASSWORD_UNLOCK]: passwordUnlock,

package/lib/commands/lock/helpers.ts

@@ -1,7 +1,8 @@
 import {util} from '@appium/support';
-import {sleep, waitForCondition} from 'asyncbox';
-import type {ADB} from 'appium-adb';
 import type {Position, StringRecord} from '@appium/types';
+import type {ADB} from 'appium-adb';
+import {sleep, waitForCondition} from 'asyncbox';
+
 import type {AndroidDriver, AndroidDriverCaps} from '../../driver.js';
 import type {UnlockType, FastUnlockOptions} from '../types.js';
 
@@ -10,13 +11,7 @@ export const PIN_UNLOCK_KEY_EVENT = 'pinWithKeyEvent';
 export const PASSWORD_UNLOCK = 'password';
 export const PATTERN_UNLOCK = 'pattern';
 export const FINGERPRINT_UNLOCK = 'fingerprint';
-const UNLOCK_TYPES = [
-  PIN_UNLOCK,
-  PIN_UNLOCK_KEY_EVENT,
-  PASSWORD_UNLOCK,
-  PATTERN_UNLOCK,
-  FINGERPRINT_UNLOCK,
-] as const;
+const UNLOCK_TYPES = [PIN_UNLOCK, PIN_UNLOCK_KEY_EVENT, PASSWORD_UNLOCK, PATTERN_UNLOCK, FINGERPRINT_UNLOCK] as const;
 export const KEYCODE_NUMPAD_ENTER = 66;
 export const UNLOCK_WAIT_TIME = 100;
 export const INPUT_KEYS_WAIT_TIME = 100;
@@ -62,27 +57,20 @@ export function validateUnlockCapabilities<T extends AndroidDriverCaps>(caps: T)
     }
   } else if (unlockType === PATTERN_UNLOCK) {
     if (!/^[1-9]{2,9}$/.test(String(unlockKey)?.trim())) {
-      throw new Error(
-        `Unlock key value '${unlockKey}' must only include from two to nine digits in range 1..9`,
-      );
+      throw new Error(`Unlock key value '${unlockKey}' must only include from two to nine digits in range 1..9`);
     }
     if (/([1-9]).*?\1/.test(String(unlockKey)?.trim())) {
-      throw new Error(
-        `Unlock key value '${unlockKey}' must define a valid pattern where repeats are not allowed`,
-      );
+      throw new Error(`Unlock key value '${unlockKey}' must define a valid pattern where repeats are not allowed`);
     }
   } else if (unlockType === PASSWORD_UNLOCK) {
     // Dont trim password key, you can use blank spaces in your android password
     // ¯\_(ツ)_/¯
-    if (!/.{4,}/g.test(String(unlockKey))) {
-      throw new Error(
-        `The minimum allowed length of unlock key value '${unlockKey}' is 4 characters`,
-      );
+    if (!isNonEmptyString(unlockKey) || !/.{4,}/g.test(unlockKey)) {
+      throw new Error(`The minimum allowed length of unlock key value '${unlockKey}' is 4 characters`);
     }
   } else {
     throw new Error(
-      `Invalid unlock type '${unlockType}'. ` +
-        `Only the following unlock types are supported: ${UNLOCK_TYPES}`,
+      `Invalid unlock type '${unlockType}'. Only the following unlock types are supported: ${UNLOCK_TYPES}`,
     );
   }
   return caps;
@@ -139,10 +127,7 @@ export function stringKeyToArr(key: string): string[] {
  *
  * @param capabilities - Driver capabilities containing unlockKey
  */
-export async function fingerprintUnlock(
-  this: AndroidDriver,
-  capabilities: AndroidDriverCaps,
-): Promise<void> {
+export async function fingerprintUnlock(this: AndroidDriver, capabilities: AndroidDriverCaps): Promise<void> {
   await this.adb.fingerprint(String(capabilities.unlockKey));
   await sleep(UNLOCK_WAIT_TIME);
 }
@@ -152,10 +137,7 @@ export async function fingerprintUnlock(
  *
  * @param capabilities - Driver capabilities containing unlockKey
  */
-export async function pinUnlock(
-  this: AndroidDriver,
-  capabilities: AndroidDriverCaps,
-): Promise<void> {
+export async function pinUnlock(this: AndroidDriver, capabilities: AndroidDriverCaps): Promise<void> {
   this.log.info(`Trying to unlock device using pin ${capabilities.unlockKey}`);
   await this.adb.dismissKeyguard();
   const keys = stringKeyToArr(String(capabilities.unlockKey));
@@ -183,10 +165,7 @@ export async function pinUnlock(
  *
  * @param capabilities - Driver capabilities containing unlockKey
  */
-export async function pinUnlockWithKeyEvent(
-  this: AndroidDriver,
-  capabilities: AndroidDriverCaps,
-): Promise<void> {
+export async function pinUnlockWithKeyEvent(this: AndroidDriver, capabilities: AndroidDriverCaps): Promise<void> {
   this.log.info(`Trying to unlock device using pin with keycode ${capabilities.unlockKey}`);
   await this.adb.dismissKeyguard();
   const keys = stringKeyToArr(String(capabilities.unlockKey));
@@ -206,10 +185,7 @@ export async function pinUnlockWithKeyEvent(
  *
  * @param capabilities - Driver capabilities containing unlockKey
  */
-export async function passwordUnlock(
-  this: AndroidDriver,
-  capabilities: AndroidDriverCaps,
-): Promise<void> {
+export async function passwordUnlock(this: AndroidDriver, capabilities: AndroidDriverCaps): Promise<void> {
   const {unlockKey} = capabilities;
   this.log.info(`Trying to unlock device using password ${unlockKey}`);
   await this.adb.dismissKeyguard();
@@ -241,8 +217,7 @@ export function getPatternKeyPosition(key: number, initPos: Position, piece: num
   */
   const cols = 3;
   const pins = 9;
-  const xPos = (key: number, x: number, piece: number) =>
-    Math.round(x + (key % cols || cols) * piece - piece / 2);
+  const xPos = (key: number, x: number, piece: number) => Math.round(x + (key % cols || cols) * piece - piece / 2);
   const yPos = (key: number, y: number, piece: number) =>
     Math.round(y + (Math.ceil((key % pins || pins) / cols) * piece - piece / 2));
   return {
@@ -259,11 +234,7 @@ export function getPatternKeyPosition(key: number, initPos: Position, piece: num
  * @param piece - The size of each pattern piece
  * @returns An array of W3C action objects for pattern unlock
  */
-export function getPatternActions(
-  keys: string[] | number[],
-  initPos: Position,
-  piece: number,
-): StringRecord[] {
+export function getPatternActions(keys: string[] | number[], initPos: Position, piece: number): StringRecord[] {
   // https://www.w3.org/TR/webdriver2/#actions
   const pointerActions: StringRecord[] = [];
   const intKeys = keys.map((key) => (typeof key === 'string' ? parseInt(key, 10) : key));
@@ -330,10 +301,7 @@ export function getPatternActions(
  * @param timeoutMs - Optional timeout in milliseconds (default: 2000)
  * @throws {Error} If the device fails to unlock within the timeout
  */
-export async function verifyUnlock(
-  this: AndroidDriver,
-  timeoutMs: number | null = null,
-): Promise<void> {
+export async function verifyUnlock(this: AndroidDriver, timeoutMs: number | null = null): Promise<void> {
   try {
     await waitForCondition(async () => !(await this.adb.isScreenLocked()), {
       waitMs: timeoutMs ?? 2000,
@@ -350,10 +318,7 @@ export async function verifyUnlock(
  *
  * @param capabilities - Driver capabilities containing unlockKey
  */
-export async function patternUnlock(
-  this: AndroidDriver,
-  capabilities: AndroidDriverCaps,
-): Promise<void> {
+export async function patternUnlock(this: AndroidDriver, capabilities: AndroidDriverCaps): Promise<void> {
   const {unlockKey} = capabilities;
   this.log.info(`Trying to unlock device using pattern ${unlockKey}`);
   await this.adb.dismissKeyguard();

package/lib/commands/log.ts

@@ -1,21 +1,18 @@
-import {DEFAULT_WS_PATHNAME_PREFIX, BaseDriver} from 'appium/driver.js';
+import type {EventEmitter} from 'node:events';
 import os from 'node:os';
-import {WebSocket, WebSocketServer} from 'ws';
+
+import {util} from '@appium/support';
 import type {AppiumServer, WSServer} from '@appium/types';
-import type {EventEmitter} from 'node:events';
 import type {ADB} from 'appium-adb';
 import type {Chromedriver} from 'appium-chromedriver';
-import {
-  GET_SERVER_LOGS_FEATURE,
-  toLogRecord,
-  nativeLogEntryToSeleniumEntry,
-  type LogEntry,
-} from '../utils.js';
-import {NATIVE_WIN} from './context/helpers.js';
+import {DEFAULT_WS_PATHNAME_PREFIX, BaseDriver} from 'appium/driver.js';
+import {WebSocket, WebSocketServer} from 'ws';
+
+import type {AndroidDriver} from '../driver.js';
+import {GET_SERVER_LOGS_FEATURE, toLogRecord, nativeLogEntryToSeleniumEntry, type LogEntry} from '../utils.js';
 import {BIDI_EVENT_NAME} from './bidi/constants.js';
 import {makeLogEntryAddedEvent} from './bidi/models.js';
-import type {AndroidDriver} from '../driver.js';
-import {util} from '@appium/support';
+import {NATIVE_WIN} from './context/helpers.js';
 
 export const supportedLogTypes = {
   logcat: {
@@ -57,10 +54,7 @@ export async function mobileStartLogsBroadcast(this: AndroidDriver): Promise<voi
     return;
   }
 
-  this.log.info(
-    `Starting logcat broadcasting on web socket server ` +
-      `${JSON.stringify(server.address())} to ${pathname}`,
-  );
+  this.log.info(`Starting logcat broadcasting on web socket server ${JSON.stringify(server.address())} to ${pathname}`);
   // https://github.com/websockets/ws/blob/master/doc/ws.md
   const wss = new WebSocketServer({
     noServer: true,
@@ -126,8 +120,7 @@ export async function mobileStopLogsBroadcast(this: AndroidDriver): Promise<void
   }
 
   this.log.debug(
-    `Stopping logcat broadcasting on web socket server ` +
-      `${JSON.stringify(server.address())} to ${pathname}`,
+    `Stopping logcat broadcasting on web socket server ${JSON.stringify(server.address())} to ${pathname}`,
   );
   await server.removeWebSocketHandler(pathname);
 }
@@ -141,10 +134,7 @@ export async function getLogTypes(this: AndroidDriver): Promise<string[]> {
   // XXX why doesn't `super` work here?
   const nativeLogTypes = await BaseDriver.prototype.getLogTypes.call(this);
   if (this.isWebContext()) {
-    const webLogTypes = (await (this.chromedriver as Chromedriver).jwproxy.command(
-      '/log/types',
-      'GET',
-    )) as string[];
+    const webLogTypes = (await (this.chromedriver as Chromedriver).jwproxy.command('/log/types', 'GET')) as string[];
     return [...nativeLogTypes, ...webLogTypes];
   }
   return nativeLogTypes;

package/lib/commands/media-projection.ts

@@ -1,10 +1,12 @@
+import path from 'node:path';
+
 import {fs, net, util} from '@appium/support';
 import type {NetOptions, HttpUploadOptions} from '@appium/support';
-import dayjs from 'dayjs';
-import path from 'node:path';
 import type {HTTPMethod, StringRecord} from '@appium/types';
-import type {AndroidDriver} from '../driver.js';
 import type {ADB} from 'appium-adb';
+import dayjs from 'dayjs';
+
+import type {AndroidDriver} from '../driver.js';
 import type {FormFields} from './types.js';
 
 // https://github.com/appium/io.appium.settings#internal-audio--video-recording
@@ -60,9 +62,7 @@ export async function mobileStartMediaProjectionRecording(
   if (didStart) {
     this.log.info(`A new media projection recording '${fname}' has been successfully started`);
   } else {
-    this.log.info(
-      'Another media projection recording is already in progress. There is nothing to start',
-    );
+    this.log.info('Another media projection recording is already in progress. There is nothing to start');
   }
   return didStart;
 }
@@ -72,9 +72,7 @@ export async function mobileStartMediaProjectionRecording(
  *
  * @returns Promise that resolves to `true` if recording is running, `false` otherwise.
  */
-export async function mobileIsMediaProjectionRecordingRunning(
-  this: AndroidDriver,
-): Promise<boolean> {
+export async function mobileIsMediaProjectionRecordingRunning(this: AndroidDriver): Promise<boolean> {
   await verifyMediaProjectionRecordingIsSupported(this.adb);
 
   const recorder = this.settingsApp.makeMediaProjectionRecorder();
@@ -129,9 +127,7 @@ export async function mobileStopMediaProjectionRecording(
 
   if (util.isEmpty(remotePath)) {
     const {size} = await fs.stat(recentRecordingPath);
-    this.log.debug(
-      `The size of the resulting media projection recording is ${util.toReadableSizeString(size)}`,
-    );
+    this.log.debug(`The size of the resulting media projection recording is ${util.toReadableSizeString(size)}`);
   }
   try {
     return await uploadRecordedMedia(recentRecordingPath, remotePath, {
@@ -157,15 +153,7 @@ async function uploadRecordedMedia(
     return (await util.toInMemoryBase64(localFile)).toString();
   }
 
-  const {
-    user,
-    pass,
-    method,
-    headers,
-    fileFieldName,
-    formFields,
-    uploadTimeout: timeout,
-  } = uploadOptions;
+  const {user, pass, method, headers, fileFieldName, formFields, uploadTimeout: timeout} = uploadOptions;
   const options: NetOptions & HttpUploadOptions = {
     method: method || 'PUT',
     headers,

package/lib/commands/memory.ts

@@ -1,4 +1,5 @@
 import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../driver.js';
 import type {TrimMemoryLevel} from './types.js';
 
@@ -12,11 +13,7 @@ import type {TrimMemoryLevel} from './types.js';
  * @returns Promise that resolves when the trim memory event is sent.
  * @throws {errors.InvalidArgumentError} If pkg or level arguments are not provided.
  */
-export async function mobileSendTrimMemory(
-  this: AndroidDriver,
-  pkg: string,
-  level: TrimMemoryLevel,
-): Promise<void> {
+export async function mobileSendTrimMemory(this: AndroidDriver, pkg: string, level: TrimMemoryLevel): Promise<void> {
   if (!pkg) {
     throw new errors.InvalidArgumentError(`The 'pkg' argument must be provided`);
   }

package/lib/commands/misc.ts

@@ -1,5 +1,6 @@
-import {errors} from 'appium/driver.js';
 import type {Size, Rect, StringRecord} from '@appium/types';
+import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../driver.js';
 import type {SmsListResult, ListSmsOpts} from './types.js';
 
@@ -86,10 +87,7 @@ export async function mobileGetNotifications(this: AndroidDriver): Promise<Strin
  * @param opts Optional parameters for listing SMS messages.
  * @returns Promise that resolves to the SMS list result.
  */
-export async function mobileListSms(
-  this: AndroidDriver,
-  opts?: ListSmsOpts,
-): Promise<SmsListResult> {
+export async function mobileListSms(this: AndroidDriver, opts?: ListSmsOpts): Promise<SmsListResult> {
   return await this.settingsApp.getSmsList(opts);
 }
 

package/lib/commands/network.ts

@@ -1,5 +1,6 @@
-import {errors} from 'appium/driver.js';
 import {util} from '@appium/support';
+import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../driver.js';
 import type {ServiceType, GetConnectivityResult} from './types.js';
 
@@ -9,11 +10,7 @@ const DATA_MASK = 0b100;
 const WIFI_KEY_NAME = 'wifi';
 const DATA_KEY_NAME = 'data';
 const AIRPLANE_MODE_KEY_NAME = 'airplaneMode';
-const SUPPORTED_SERVICE_NAMES: ServiceType[] = [
-  WIFI_KEY_NAME,
-  DATA_KEY_NAME,
-  AIRPLANE_MODE_KEY_NAME,
-];
+const SUPPORTED_SERVICE_NAMES: ServiceType[] = [WIFI_KEY_NAME, DATA_KEY_NAME, AIRPLANE_MODE_KEY_NAME];
 
 /**
  * Gets the current network connection state.
@@ -123,14 +120,8 @@ export async function mobileGetConnectivity(
   const unsupportedServices = svcs.filter((svc) => !SUPPORTED_SERVICE_NAMES.includes(svc));
   if (unsupportedServices.length > 0) {
     throw new errors.InvalidArgumentError(
-      `${util.pluralize(
-        'Service name',
-        unsupportedServices.length,
-        false,
-      )} ${unsupportedServices} ` +
-        `${
-          unsupportedServices.length === 1 ? 'is' : 'are'
-        } not known. Only the following services are ` +
+      `${util.pluralize('Service name', unsupportedServices.length, false)} ${unsupportedServices} ` +
+        `${unsupportedServices.length === 1 ? 'is' : 'are'} not known. Only the following services are ` +
         `suported: ${SUPPORTED_SERVICE_NAMES}`,
     );
   }
@@ -138,9 +129,7 @@ export async function mobileGetConnectivity(
   const [wifi, data, airplaneMode] = await Promise.all([
     svcs.includes(WIFI_KEY_NAME) ? this.adb.isWifiOn() : Promise.resolve(undefined),
     svcs.includes(DATA_KEY_NAME) ? this.adb.isDataOn() : Promise.resolve(undefined),
-    svcs.includes(AIRPLANE_MODE_KEY_NAME)
-      ? this.adb.isAirplaneModeOn()
-      : Promise.resolve(undefined),
+    svcs.includes(AIRPLANE_MODE_KEY_NAME) ? this.adb.isAirplaneModeOn() : Promise.resolve(undefined),
   ]);
   const result: GetConnectivityResult = {};
   if (wifi !== undefined) {
@@ -185,16 +174,12 @@ export async function setNetworkConnection(this: AndroidDriver, type: number): P
     }
   } else {
     this.log.info(
-      `Not changing airplane mode, since it is already ${
-        shouldEnableAirplaneMode ? 'enabled' : 'disabled'
-      }`,
+      `Not changing airplane mode, since it is already ${shouldEnableAirplaneMode ? 'enabled' : 'disabled'}`,
     );
   }
 
   if (shouldEnableWifi === isWiFiEnabled && shouldEnableDataConnection === isDataEnabled) {
-    this.log.info(
-      'Not changing data connection/Wi-Fi states, since they are already set to expected values',
-    );
+    this.log.info('Not changing data connection/Wi-Fi states, since they are already set to expected values');
     if (await this.adb.isAirplaneModeOn()) {
       return AIRPLANE_MODE_MASK | currentState;
     }
@@ -204,10 +189,7 @@ export async function setNetworkConnection(this: AndroidDriver, type: number): P
   if (shouldEnableWifi !== isWiFiEnabled) {
     await this.setWifiState(shouldEnableWifi);
   } else {
-    this.log.info(
-      `Not changing Wi-Fi state, since it is already ` +
-        `${shouldEnableWifi ? 'enabled' : 'disabled'}`,
-    );
+    this.log.info(`Not changing Wi-Fi state, since it is already ${shouldEnableWifi ? 'enabled' : 'disabled'}`);
   }
 
   if (shouldEnableAirplaneMode) {

package/lib/commands/nfc.ts

@@ -1,4 +1,5 @@
 import {errors} from 'appium/driver.js';
+
 import type {AndroidDriver} from '../driver.js';
 import type {NfcAction} from './types.js';
 

package/lib/commands/performance.ts

@@ -1,20 +1,12 @@
+import {util} from '@appium/support';
 import {retryInterval} from 'asyncbox';
 import type {ExecError} from 'teen_process';
+
 import type {AndroidDriver} from '../driver.js';
 import type {PerformanceDataType} from './types.js';
-import {util} from '@appium/support';
 
 export const NETWORK_KEYS = [
-  [
-    'bucketStart',
-    'activeTime',
-    'rxBytes',
-    'rxPackets',
-    'txBytes',
-    'txPackets',
-    'operations',
-    'bucketDuration',
-  ],
+  ['bucketStart', 'activeTime', 'rxBytes', 'rxPackets', 'txBytes', 'txPackets', 'operations', 'bucketDuration'],
   ['st', 'activeTime', 'rb', 'rp', 'tb', 'tp', 'op', 'bucketDuration'],
 ] as const;
 
@@ -45,8 +37,7 @@ export const SUPPORTED_PERFORMANCE_DATA_TYPES = Object.freeze({
     'the amount of memory used by the process - memory information for applications on real devices and simulators',
   batteryinfo:
     'the remaining battery power - battery power information for applications on real devices and simulators',
-  networkinfo:
-    'the network statistics - network rx/tx information for applications on real devices and simulators',
+  networkinfo: 'the network statistics - network rx/tx information for applications on real devices and simulators',
 } as const);
 
 export const MEMINFO_TITLES = Object.freeze({
@@ -101,11 +92,7 @@ export async function getPerformanceData(
     default:
       throw new Error(
         `No performance data of type '${dataType}' found. ` +
-          `Only the following values are supported: ${JSON.stringify(
-            SUPPORTED_PERFORMANCE_DATA_TYPES,
-            [' '],
-            2,
-          )}`,
+          `Only the following values are supported: ${JSON.stringify(SUPPORTED_PERFORMANCE_DATA_TYPES, [' '], 2)}`,
       );
   }
 }
@@ -156,11 +143,7 @@ export async function mobileGetPerformanceData(
  * and the second row contains the corresponding values.
  * @throws {Error} If memory data cannot be retrieved or parsed.
  */
-export async function getMemoryInfo(
-  this: AndroidDriver,
-  packageName: string,
-  retries: number = 2,
-): Promise<any[][]> {
+export async function getMemoryInfo(this: AndroidDriver, packageName: string, retries: number = 2): Promise<any[][]> {
   return (await retryInterval(retries, RETRY_PAUSE_MS, async () => {
     const cmd = [
       'dumpsys',
@@ -211,10 +194,7 @@ export async function getMemoryInfo(
  * for each time bucket.
  * @throws {Error} If network traffic data cannot be retrieved or parsed.
  */
-export async function getNetworkTrafficInfo(
-  this: AndroidDriver,
-  retries: number = 2,
-): Promise<any[][]> {
+export async function getNetworkTrafficInfo(this: AndroidDriver, retries: number = 2): Promise<any[][]> {
   return (await retryInterval(retries, RETRY_PAUSE_MS, async () => {
     const returnValue: any[][] = [];
     let bucketDuration: string | undefined;
@@ -429,9 +409,7 @@ export async function getCPUInfo(
     const match = usagesPattern.exec(output);
     if (!match) {
       this.log.debug(output);
-      throw new Error(
-        `Unable to parse cpu usage data for '${packageName}'. Check the server log for more details`,
-      );
+      throw new Error(`Unable to parse cpu usage data for '${packageName}'. Check the server log for more details`);
     }
     const user = match[1];
     const kernel = match[2];
@@ -471,22 +449,11 @@ export async function getBatteryInfo(this: AndroidDriver, retries: number = 2):
  * except 'TOTAL', which skips the second type name
  * !!! valDict gets mutated
  */
-function parseMeminfoForApi19To29(
-  entries: string[],
-  valDict: Record<string, string | number>,
-): void {
+function parseMeminfoForApi19To29(entries: string[], valDict: Record<string, string | number>): void {
   const [type, subType] = entries;
   if (type === MEMINFO_TITLES.NATIVE && subType === MEMINFO_TITLES.HEAP) {
-    [
-      ,
-      ,
-      valDict.nativePss,
-      valDict.nativePrivateDirty,
-      ,
-      ,
-      valDict.nativeHeapSize,
-      valDict.nativeHeapAllocatedSize,
-    ] = entries;
+    [, , valDict.nativePss, valDict.nativePrivateDirty, , , valDict.nativeHeapSize, valDict.nativeHeapAllocatedSize] =
+      entries;
   } else if (type === MEMINFO_TITLES.DALVIK && subType === MEMINFO_TITLES.HEAP) {
     [, , valDict.dalvikPss, valDict.dalvikPrivateDirty] = entries;
   } else if (type === MEMINFO_TITLES.EGL && subType === MEMINFO_TITLES.MTRACK) {
@@ -504,10 +471,7 @@ function parseMeminfoForApi19To29(
  * ['<System Type>', '<Memory Type>', <pss total>, <private dirty>, <private clean>, <swapPss dirty>, <rss total>, <heap size>, <heap alloc>, <heap free>]
  * !!! valDict gets mutated
  */
-function parseMeminfoForApiAbove29(
-  entries: string[],
-  valDict: Record<string, string | number>,
-): void {
+function parseMeminfoForApiAbove29(entries: string[], valDict: Record<string, string | number>): void {
   const [type, subType] = entries;
   if (type === MEMINFO_TITLES.NATIVE && subType === MEMINFO_TITLES.HEAP) {
     [

package/lib/commands/permissions.ts

@@ -1,7 +1,8 @@
+import {util} from '@appium/support';
 import {errors} from 'appium/driver.js';
-import {ADB_SHELL_FEATURE} from '../utils.js';
+
 import type {AndroidDriver} from '../driver.js';
-import {util} from '@appium/support';
+import {ADB_SHELL_FEATURE} from '../utils.js';
 
 const ALL_PERMISSIONS_MAGIC = 'all';
 const PM_ACTION = Object.freeze({
@@ -67,8 +68,7 @@ export async function mobileChangePermissions(
   if (!appPackage) {
     throw new errors.InvalidArgumentError(`A valid appPackage must be provided`);
   }
-  action ??=
-    target?.toLowerCase() === PERMISSION_TARGET.APPOPS ? APPOPS_ACTION.ALLOW : PM_ACTION.GRANT;
+  action ??= target?.toLowerCase() === PERMISSION_TARGET.APPOPS ? APPOPS_ACTION.ALLOW : PM_ACTION.GRANT;
   if (permissions == null) {
     throw new errors.InvalidArgumentError(`'permissions' argument is required`);
   }
@@ -78,11 +78,7 @@ export async function mobileChangePermissions(
 
   switch (target?.toLowerCase()) {
     case PERMISSION_TARGET.PM:
-      return await changePermissionsViaPm.bind(this)(
-        permissions,
-        appPackage,
-        action?.toLowerCase() as PMAction,
-      );
+      return await changePermissionsViaPm.bind(this)(permissions, appPackage, action?.toLowerCase() as PMAction);
     case PERMISSION_TARGET.APPOPS:
       this.assertFeatureEnabled(ADB_SHELL_FEATURE);
       return await changePermissionsViaAppops.bind(this)(
@@ -91,9 +87,7 @@ export async function mobileChangePermissions(
         action?.toLowerCase() as AppOpsAction,
       );
     default:
-      throw new errors.InvalidArgumentError(
-        `'target' argument must be one of: ${Object.values(PERMISSION_TARGET)}`,
-      );
+      throw new errors.InvalidArgumentError(`'target' argument must be one of: ${Object.values(PERMISSION_TARGET)}`);
   }
 }
 /**
@@ -138,8 +132,7 @@ async function changePermissionsViaPm(
 ): Promise<void> {
   if (!Object.values(PM_ACTION).includes(action)) {
     throw new errors.InvalidArgumentError(
-      `Unknown action '${action}'. ` +
-        `Only ${JSON.stringify(Object.values(PM_ACTION))} actions are supported`,
+      `Unknown action '${action}'. Only ${JSON.stringify(Object.values(PM_ACTION))} actions are supported`,
     );
   }
 
@@ -149,9 +142,7 @@ async function changePermissionsViaPm(
     const grantedPermissions = await this.adb.getGrantedPermissions(appPackage, dumpsys);
     if (action === PM_ACTION.GRANT) {
       const reqPermissons = await this.adb.getReqPermissions(appPackage, dumpsys);
-      affectedPermissions = reqPermissons.filter(
-        (permission) => !grantedPermissions.includes(permission),
-      );
+      affectedPermissions = reqPermissons.filter((permission) => !grantedPermissions.includes(permission));
     } else {
       affectedPermissions = grantedPermissions;
     }
@@ -164,9 +155,7 @@ async function changePermissionsViaPm(
   if (action === PM_ACTION.GRANT) {
     await this.adb.grantPermissions(appPackage, affectedPermissions);
   } else {
-    await Promise.all(
-      affectedPermissions.map((name) => this.adb.revokePermission(appPackage, name)),
-    );
+    await Promise.all(affectedPermissions.map((name) => this.adb.revokePermission(appPackage, name)));
   }
 }
 async function changePermissionsViaAppops(
@@ -177,8 +166,7 @@ async function changePermissionsViaAppops(
 ): Promise<void> {
   if (!Object.values(APPOPS_ACTION).includes(action)) {
     throw new errors.InvalidArgumentError(
-      `Unknown action '${action}'. ` +
-        `Only ${JSON.stringify(Object.values(APPOPS_ACTION))} actions are supported`,
+      `Unknown action '${action}'. Only ${JSON.stringify(Object.values(APPOPS_ACTION))} actions are supported`,
     );
   }
   if (typeof permissions === 'string' && permissions.toLowerCase() === ALL_PERMISSIONS_MAGIC) {