appium-android-driver 13.3.4 → 14.0.0

package/lib/driver.ts

@@ -8,14 +8,14 @@ import type {
   W3CDriverCaps,
 } from '@appium/types';
 import type {ADB, LogcatListener} from 'appium-adb';
-import type {default as AppiumChromedriver} from 'appium-chromedriver';
-import {BaseDriver} from 'appium/driver';
-import {ANDROID_DRIVER_CONSTRAINTS} from './constraints';
-import type {AndroidDriverConstraints} from './constraints';
-import {newMethodMap} from './method-map';
+import type {Chromedriver as AppiumChromedriver} from 'appium-chromedriver';
+import {BaseDriver} from 'appium/driver.js';
+import {ANDROID_DRIVER_CONSTRAINTS} from './constraints.js';
+import type {AndroidDriverConstraints} from './constraints.js';
+import {newMethodMap} from './method-map.js';
 import {SettingsApp} from 'io.appium.settings';
-import {parseArray, removeAllSessionWebSocketHandlers} from './utils';
-import {CHROME_BROWSER_PACKAGE_ACTIVITY} from './commands/context/helpers';
+import {parseArray, removeAllSessionWebSocketHandlers} from './utils.js';
+import {CHROME_BROWSER_PACKAGE_ACTIVITY} from './commands/context/helpers.js';
 import {
   getContexts,
   setContext,
@@ -37,13 +37,13 @@ import {
   getWindowHandles,
   setWindow,
   notifyBiDiContextChange,
-} from './commands/context/exports';
+} from './commands/context/exports.js';
 import {
   getDeviceInfoFromCaps,
   createADB,
   getLaunchInfo,
   initDevice,
-} from './commands/device/common';
+} from './commands/device/common.js';
 import {
   fingerprint,
   mobileFingerprint,
@@ -62,8 +62,8 @@ import {
   networkSpeed,
   mobileNetworkSpeed,
   sensorSet,
-} from './commands/device/emulator-actions';
-import {mobileExecEmuConsoleCommand} from './commands/device/emulator-console';
+} from './commands/device/emulator-actions.js';
+import {mobileExecEmuConsoleCommand} from './commands/device/emulator-console.js';
 import {
   getThirdPartyPackages,
   uninstallOtherPackages,
@@ -86,10 +86,10 @@ import {
   activateApp,
   queryAppState,
   isAppInstalled,
-} from './commands/app-management';
-import {mobileGetUiMode, mobileSetUiMode} from './commands/appearance';
-import {mobileDeviceidle} from './commands/deviceidle';
-import {mobileBluetooth} from './commands/bluetooth';
+} from './commands/app-management.js';
+import {mobileGetUiMode, mobileSetUiMode} from './commands/appearance.js';
+import {mobileDeviceidle} from './commands/deviceidle.js';
+import {mobileBluetooth} from './commands/bluetooth.js';
 import {
   getAttribute,
   getName,
@@ -106,10 +106,10 @@ import {
   getText,
   getLocation,
   getSize,
-} from './commands/element';
-import {execute} from './commands/execute';
-import {pullFile, pullFolder, pushFile, mobileDeleteFile} from './commands/file-actions';
-import {findElOrEls, doFindElementOrEls} from './commands/find';
+} from './commands/element.js';
+import {execute} from './commands/execute.js';
+import {pullFile, pullFolder, pushFile, mobileDeleteFile} from './commands/file-actions.js';
+import {findElOrEls, doFindElementOrEls} from './commands/find.js';
 import {
   setGeoLocation,
   getGeoLocation,
@@ -119,8 +119,8 @@ import {
   mobileGetGeolocation,
   mobileSetGeolocation,
   mobileResetGeolocation,
-} from './commands/geolocation';
-import {performActions} from './commands/gestures';
+} from './commands/geolocation.js';
+import {performActions} from './commands/gestures.js';
 import {
   isIMEActivated,
   availableIMEEngines,
@@ -128,14 +128,14 @@ import {
   activateIMEEngine,
   deactivateIMEEngine,
   setStylusHandwriting,
-} from './commands/ime';
+} from './commands/ime.js';
 import {
   startActivity,
   mobileStartActivity,
   mobileBroadcast,
   mobileStartService,
   mobileStopService,
-} from './commands/intent';
+} from './commands/intent.js';
 import {
   hideKeyboard,
   isKeyboardShown,
@@ -144,8 +144,8 @@ import {
   pressKeyCode,
   longPressKeyCode,
   mobilePerformEditorAction,
-} from './commands/keyboard';
-import {lock, unlock, mobileUnlock, isLocked} from './commands/lock/exports';
+} from './commands/keyboard.js';
+import {lock, unlock, mobileUnlock, isLocked} from './commands/lock/exports.js';
 import {
   supportedLogTypes,
   mobileStartLogsBroadcast,
@@ -153,15 +153,15 @@ import {
   getLogTypes,
   getLog,
   assignBiDiLogListener,
-} from './commands/log';
+} from './commands/log.js';
 import {
   mobileIsMediaProjectionRecordingRunning,
   mobileStartMediaProjectionRecording,
   mobileStopMediaProjectionRecording,
-} from './commands/media-projection';
-import {mobileSendTrimMemory} from './commands/memory';
-import {mobileNfc} from './commands/nfc';
-import {mobileInjectEmulatorCameraImage} from './commands/image-injection';
+} from './commands/media-projection.js';
+import {mobileSendTrimMemory} from './commands/memory.js';
+import {mobileNfc} from './commands/nfc.js';
+import {mobileInjectEmulatorCameraImage} from './commands/image-injection.js';
 import {
   getWindowRect,
   getWindowSize,
@@ -170,7 +170,7 @@ import {
   mobileListSms,
   openNotifications,
   setUrl,
-} from './commands/misc';
+} from './commands/misc.js';
 import {
   getNetworkConnection,
   isWifiOn,
@@ -182,23 +182,23 @@ import {
   toggleData,
   toggleFlightMode,
   toggleWiFi,
-} from './commands/network';
+} from './commands/network.js';
 import {
   getPerformanceData,
   getPerformanceDataTypes,
   mobileGetPerformanceData,
-} from './commands/performance';
-import {reset, closeApp, launchApp} from './commands/legacy';
-import {mobileChangePermissions, mobileGetPermissions} from './commands/permissions';
-import {startRecordingScreen, stopRecordingScreen} from './commands/recordscreen';
-import {getStrings, ensureDeviceLocale} from './commands/resources';
-import {mobileShell} from './commands/shell';
-import {mobileStartScreenStreaming, mobileStopScreenStreaming} from './commands/streamscreen';
-import {getSystemBars, mobilePerformStatusBarCommand} from './commands/system-bars';
-import {getDeviceTime, mobileGetDeviceTime} from './commands/time';
-import {executeMethodMap} from './execute-method-map';
+} from './commands/performance.js';
+import {reset, closeApp, launchApp} from './commands/legacy.js';
+import {mobileChangePermissions, mobileGetPermissions} from './commands/permissions.js';
+import {startRecordingScreen, stopRecordingScreen} from './commands/recordscreen.js';
+import {getStrings, ensureDeviceLocale} from './commands/resources.js';
+import {mobileShell} from './commands/shell.js';
+import {mobileStartScreenStreaming, mobileStopScreenStreaming} from './commands/streamscreen.js';
+import {getSystemBars, mobilePerformStatusBarCommand} from './commands/system-bars.js';
+import {getDeviceTime, mobileGetDeviceTime} from './commands/time.js';
+import {executeMethodMap} from './execute-method-map.js';
 import {LRUCache} from 'lru-cache';
-import type {ScreenRecordingProperties} from './commands/types';
+import type {ScreenRecordingProperties, ScreenStreamingProps} from './commands/types.js';
 
 export type AndroidDriverCaps = DriverCaps<AndroidDriverConstraints>;
 export type W3CAndroidDriverCaps = W3CDriverCaps<AndroidDriverConstraints>;
@@ -228,7 +228,7 @@ class AndroidDriver
   defaultIME?: string;
   _wasWindowAnimationDisabled?: boolean;
   _cachedActivityArgs: StringRecord;
-  _screenStreamingProps?: StringRecord;
+  _screenStreamingProps?: ScreenStreamingProps;
   _screenRecordingProperties?: ScreenRecordingProperties;
   _logcatWebsocketListener?: LogcatListener;
   _bidiServerLogListener?: (...args: any[]) => void;

package/lib/index.ts

@@ -1,14 +1,14 @@
-import {AndroidDriver} from './driver';
-import {getChromePkg} from './commands/context/helpers';
-import {parseArray, requireArgs} from './utils';
+import {AndroidDriver} from './driver.js';
+import {getChromePkg} from './commands/context/helpers.js';
+import {parseArray, requireArgs} from './utils.js';
 export const utils = {
   getChromePkg,
   parseArray,
   requireArgs,
 } as const;
-export type * from './commands/types';
-export {ANDROID_DRIVER_CONSTRAINTS as commonCapConstraints} from './constraints';
-export * from './driver';
-export * as doctor from './doctor/checks';
+export type * from './commands/types.js';
+export {ANDROID_DRIVER_CONSTRAINTS as commonCapConstraints} from './constraints.js';
+export * from './driver.js';
+export * as doctor from './doctor/checks.js';
 
 export default AndroidDriver;

package/lib/method-map.ts

@@ -1,5 +1,5 @@
 import type {MethodMap} from '@appium/types';
-import type {AndroidDriver} from './driver';
+import type {AndroidDriver} from './driver.js';
 
 export const newMethodMap = {
   '/session/:sessionId/timeouts/implicit_wait': {

package/lib/utils.ts

@@ -1,6 +1,6 @@
-import {errors} from 'appium/driver';
+import {errors} from 'appium/driver.js';
 import type {LogEntry} from 'appium-adb';
-import type {AndroidDriver} from './driver';
+import type {AndroidDriver} from './driver.js';
 import {util} from '@appium/support';
 
 export type {LogEntry};
@@ -38,9 +38,10 @@ export function requireArgs(
 }
 
 /**
+ * Parses a capability into an array
  *
- * @param cap
- * @returns
+ * @param cap - The capability to parse
+ * @returns The parsed capability
  */
 export function parseArray(cap: string | string[]): string[] {
   let parsedCaps;
@@ -58,8 +59,7 @@ export function parseArray(cap: string | string[]): string[] {
 }
 
 /**
- * @this AndroidDriver
- * @returns
+ * Removes all session web socket handlers
  */
 export async function removeAllSessionWebSocketHandlers(this: AndroidDriver): Promise<void> {
   if (!this.sessionId || typeof this.server?.getWebSocketHandlers !== 'function') {
@@ -73,9 +73,10 @@ export async function removeAllSessionWebSocketHandlers(this: AndroidDriver): Pr
 }
 
 /**
+ * Converts a native log entry to a Selenium log entry
  *
- * @param x
- * @returns
+ * @param x - The native log entry
+ * @returns The Selenium log entry
  */
 export function nativeLogEntryToSeleniumEntry(x: LogEntryWithPrefix): LogEntry {
   const msg = util.isEmpty(x.prefix) ? x.message : `[${x.prefix}] ${x.message}`;
@@ -83,6 +84,7 @@ export function nativeLogEntryToSeleniumEntry(x: LogEntryWithPrefix): LogEntry {
 }
 
 /**
+ * Converts a timestamp and message to a Selenium log entry
  *
  * @see {@link https://github.com/SeleniumHQ/selenium/blob/0d425676b3c9df261dd641917f867d4d5ce7774d/java/client/src/org/openqa/selenium/logging/LogEntry.java}
  * @param timestamp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-android-driver",
-  "version": "13.3.4",
+  "version": "14.0.0",
   "description": "Android UiAutomator and Chrome support for Appium",
   "keywords": [
     "appium",
@@ -39,7 +39,7 @@
     "rebuild": "npm run clean; npm run build",
     "format": "prettier -w ./lib ./test",
     "format:check": "prettier --check ./lib ./test",
-    "test": "node --test --test-force-exit --test-concurrency=1 --test-timeout=60000 \"./build/test/unit/**/*.spec.js\""
+    "test": "node --test --test-force-exit --test-timeout=60000 \"./build/test/unit/**/*.spec.js\""
   },
   "prettier": {
     "bracketSpacing": false,
@@ -76,6 +76,7 @@
     "chai": "^6.0.0",
     "chai-as-promised": "^8.0.0",
     "conventional-changelog-conventionalcommits": "^9.3.1",
+    "esmock": "^2.7.6",
     "prettier": "^3.0.1",
     "semantic-release": "^25.0.2",
     "sinon": "^22.0.0",
@@ -88,5 +89,13 @@
     "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
     "npm": ">=10"
   },
-  "types": "./build/lib/index.d.ts"
+  "types": "./build/lib/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./build/lib/index.d.ts",
+      "import": "./build/lib/index.js"
+    },
+    "./package.json": "./package.json"
+  }
 }