appium-uiautomator2-driver 6.5.0 → 6.6.0

package/lib/commands/misc.js

@@ -102,29 +102,6 @@ export async function mobileResetAccessibilityCache() {
   );
 }
 
-/**
- * Gets a list of windows on all displays.
- * For Android API 30+ (R), uses getWindowsOnAllDisplays().
- * For older APIs, uses getWindows().
- * @this {AndroidUiautomator2Driver}
- * @param {import('./types').WindowFilters} [filters] Optional filters to apply to the window list.
- *   All filters are applied with AND logic (all must match).
- * @param {boolean} [skipScreenshots] Whether to skip taking screenshots for each window. Defaults to false.
- * @returns {Promise<Array<import('./types').WindowInfo>>} Array of window information objects
- */
-export async function mobileListWindows(filters, skipScreenshots) {
-  return /** @type {Array<import('./types').WindowInfo>} */ (
-    await this.uiautomator2.jwproxy.command(
-      '/appium/list_windows',
-      'POST',
-      {
-        filters,
-        skipScreenshots,
-      }
-    )
-  );
-}
-
 /**
  * @template [T=any]
  * @typedef {import('@appium/types').StringRecord<T>} StringRecord

package/lib/commands/types.ts

@@ -132,3 +132,53 @@ export interface WindowInfo {
    */
   screenshot: string | null;
 }
+
+export interface DisplayMetrics {
+  /**
+   * Display width in pixels
+   */
+  widthPixels: number;
+  /**
+   * Display height in pixels
+   */
+  heightPixels: number;
+  /**
+   * Display density (logical density factor)
+   */
+  density: number;
+  /**
+   * Display density in DPI
+   */
+  densityDpi: number;
+  /**
+   * Scaled density factor for fonts
+   */
+  scaledDensity: number;
+  /**
+   * Exact physical pixels per inch of the screen in the X dimension
+   */
+  xdpi: number;
+  /**
+   * Exact physical pixels per inch of the screen in the Y dimension
+   */
+  ydpi: number;
+}
+
+export interface DisplayInfo {
+  /**
+   * Display identifier (logical display ID)
+   */
+  id: number;
+  /**
+   * Physical display identifier (may be null). Returned as a string to avoid JavaScript number precision issues with large values.
+   */
+  physicalId: string | null;
+  /**
+   * Display metrics containing size and density information
+   */
+  metrics: DisplayMetrics;
+  /**
+   * Whether this is the default display
+   */
+  isDefault: boolean;
+}

package/lib/commands/windows.ts

@@ -0,0 +1,35 @@
+import type {AndroidUiautomator2Driver} from '../driver';
+import type {WindowFilters, WindowInfo, DisplayInfo} from './types';
+
+/**
+ * Gets a list of windows on all displays.
+ * For Android API 30+ (R), uses getWindowsOnAllDisplays().
+ * For older APIs, uses getWindows().
+ */
+export async function mobileListWindows(
+  this: AndroidUiautomator2Driver,
+  filters?: WindowFilters,
+  skipScreenshots?: boolean
+): Promise<WindowInfo[]> {
+  return await this.uiautomator2.jwproxy.command(
+    '/appium/list_windows',
+    'POST',
+    {
+      filters,
+      skipScreenshots,
+    }
+  ) as WindowInfo[];
+}
+
+/**
+ * Gets a list of all displays available on the device.
+ */
+export async function mobileListDisplays(
+  this: AndroidUiautomator2Driver
+): Promise<DisplayInfo[]> {
+  return await this.uiautomator2.jwproxy.command(
+    '/appium/list_displays',
+    'POST',
+    {}
+  ) as DisplayInfo[];
+}

package/lib/driver.ts

@@ -113,8 +113,11 @@ import {
   suspendChromedriverProxy,
   mobileGetDeviceInfo,
   mobileResetAccessibilityCache,
-  mobileListWindows,
 } from './commands/misc';
+import {
+  mobileListWindows,
+  mobileListDisplays,
+} from './commands/windows';
 import {
   setUrl,
   mobileDeepLink,
@@ -1059,6 +1062,7 @@ class AndroidUiautomator2Driver
   mobileGetDeviceInfo = mobileGetDeviceInfo;
   mobileResetAccessibilityCache = mobileResetAccessibilityCache;
   mobileListWindows = mobileListWindows;
+  mobileListDisplays = mobileListDisplays;
 
   getClipboard = getClipboard;
   setClipboard = setClipboard;

package/lib/execute-method-map.ts

@@ -270,4 +270,8 @@ export const executeMethodMap = {
       optional: ['filters', 'skipScreenshots'],
     },
   },
+
+  'mobile: listDisplays': {
+    command: 'mobileListDisplays',
+  },
 } as const satisfies ExecuteMethodMap<any>;

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
   "name": "appium-uiautomator2-driver",
-  "version": "6.5.0",
+  "version": "6.6.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-uiautomator2-driver",
-      "version": "6.5.0",
+      "version": "6.6.0",
       "license": "Apache-2.0",
       "dependencies": {
         "appium-adb": "^14.0.0",
         "appium-android-driver": "^12.3.0",
-        "appium-uiautomator2-server": "^9.6.1",
+        "appium-uiautomator2-server": "^9.7.1",
         "asyncbox": "^3.0.0",
         "axios": "^1.12.2",
         "bluebird": "^3.5.1",
@@ -656,9 +656,9 @@
       }
     },
     "node_modules/appium-uiautomator2-server": {
-      "version": "9.6.2",
-      "resolved": "https://registry.npmjs.org/appium-uiautomator2-server/-/appium-uiautomator2-server-9.6.2.tgz",
-      "integrity": "sha512-rjCP15vwP9ePlIjpW/CxzfZ5FUXqkvVTA1zf3BcJwl7+B+ic/QVopxOyVJMhofjNatwp44Pua9kUwtdkGycltg==",
+      "version": "9.7.1",
+      "resolved": "https://registry.npmjs.org/appium-uiautomator2-server/-/appium-uiautomator2-server-9.7.1.tgz",
+      "integrity": "sha512-SXBoUMMtQAuBT5wsi1xNTx0t7kXwCeW/akZoBOGO3H2GCB32MWEL1fGkkVC1izljK2yHwItNmbR7ceUkOOx3jg==",
       "license": "Apache-2.0",
       "engines": {
         "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
@@ -1776,9 +1776,9 @@
       "license": "MIT"
     },
     "node_modules/finalhandler": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.0.tgz",
-      "integrity": "sha512-/t88Ty3d5JWQbWYgaOGCCYfXRwV1+be02WqYYlL6h0lEiUAMPM8o8qKGO01YIkOHzka2up08wvgYD0mDiI+q3Q==",
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+      "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
       "license": "MIT",
       "dependencies": {
         "debug": "^4.4.0",
@@ -1789,7 +1789,11 @@
         "statuses": "^2.0.1"
       },
       "engines": {
-        "node": ">= 0.8"
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
       }
     },
     "node_modules/find-up": {

package/package.json

@@ -7,7 +7,7 @@
     "automated testing",
     "android"
   ],
-  "version": "6.5.0",
+  "version": "6.6.0",
   "bugs": {
     "url": "https://github.com/appium/appium-uiautomator2-driver/issues"
   },
@@ -58,7 +58,7 @@
   "dependencies": {
     "appium-adb": "^14.0.0",
     "appium-android-driver": "^12.3.0",
-    "appium-uiautomator2-server": "^9.6.1",
+    "appium-uiautomator2-server": "^9.7.1",
     "asyncbox": "^3.0.0",
     "axios": "^1.12.2",
     "bluebird": "^3.5.1",