appium-uiautomator2-driver 6.4.1 → 6.6.0

package/lib/commands/types.ts

@@ -80,3 +80,105 @@ export interface ActionResult {
   repeats: number;
   stepResults: StringRecord[][];
 }
+
+export interface WindowFilters {
+  /**
+   * Package name pattern with glob support (e.g., 'com.example.*')
+   */
+  packageName?: string;
+  /**
+   * Window identifier
+   */
+  windowId?: number;
+  /**
+   * Display identifier
+   */
+  displayId?: number;
+  /**
+   * Physical display identifier
+   */
+  physicalDisplayId?: number;
+}
+
+export interface WindowInfo {
+  /**
+   * Window identifier (may be null)
+   */
+  windowId: number | null;
+  /**
+   * Display identifier where the window is located (may be null)
+   */
+  displayId: number | null;
+  /**
+   * Physical display identifier (may be null)
+   */
+  physicalDisplayId: number | null;
+  /**
+   * Window bounds rectangle
+   */
+  rect: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+  };
+  /**
+   * Package name of the application that owns this window (may be null)
+   */
+  packageName: string | null;
+  /**
+   * Base64-encoded PNG screenshot of the window (may be null).
+   * Only available on Android API 34+ and when skipScreenshots is false.
+   */
+  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

@@ -114,6 +114,10 @@ import {
   mobileGetDeviceInfo,
   mobileResetAccessibilityCache,
 } from './commands/misc';
+import {
+  mobileListWindows,
+  mobileListDisplays,
+} from './commands/windows';
 import {
   setUrl,
   mobileDeepLink,
@@ -1057,6 +1061,8 @@ class AndroidUiautomator2Driver
   suspendChromedriverProxy = suspendChromedriverProxy as any;
   mobileGetDeviceInfo = mobileGetDeviceInfo;
   mobileResetAccessibilityCache = mobileResetAccessibilityCache;
+  mobileListWindows = mobileListWindows;
+  mobileListDisplays = mobileListDisplays;
 
   getClipboard = getClipboard;
   setClipboard = setClipboard;

package/lib/execute-method-map.ts

@@ -263,4 +263,15 @@ export const executeMethodMap = {
   'mobile: resetAccessibilityCache': {
     command: 'mobileResetAccessibilityCache',
   },
+
+  'mobile: listWindows': {
+    command: 'mobileListWindows',
+    params: {
+      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.4.1",
+  "version": "6.6.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-uiautomator2-driver",
-      "version": "6.4.1",
+      "version": "6.6.0",
       "license": "Apache-2.0",
       "dependencies": {
         "appium-adb": "^14.0.0",
         "appium-android-driver": "^12.3.0",
-        "appium-uiautomator2-server": "^9.3.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.3.1",
-      "resolved": "https://registry.npmjs.org/appium-uiautomator2-server/-/appium-uiautomator2-server-9.3.1.tgz",
-      "integrity": "sha512-JE8Nf/5cEqW7hkYR+4KDAtzy+ym+tTdxe9Q6bIn9igoYT6dPORSGcRWyRxalu0cddL4E0wXY2YqI4FXfJ0ZJTA==",
+      "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.4.1",
+  "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.3.1",
+    "appium-uiautomator2-server": "^9.7.1",
     "asyncbox": "^3.0.0",
     "axios": "^1.12.2",
     "bluebird": "^3.5.1",