appium-uiautomator2-driver 6.4.0 → 6.5.0

package/lib/commands/misc.js

@@ -96,12 +96,35 @@ export async function mobileGetDeviceInfo() {
  */
 export async function mobileResetAccessibilityCache() {
   await this.uiautomator2.jwproxy.command(
-    '/reset_ax_cache',
+    '/appium/reset_ax_cache',
     'POST',
     {}
   );
 }
 
+/**
+ * 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

@@ -80,3 +80,55 @@ 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;
+}

package/lib/driver.ts

@@ -113,6 +113,7 @@ import {
   suspendChromedriverProxy,
   mobileGetDeviceInfo,
   mobileResetAccessibilityCache,
+  mobileListWindows,
 } from './commands/misc';
 import {
   setUrl,
@@ -1057,6 +1058,7 @@ class AndroidUiautomator2Driver
   suspendChromedriverProxy = suspendChromedriverProxy as any;
   mobileGetDeviceInfo = mobileGetDeviceInfo;
   mobileResetAccessibilityCache = mobileResetAccessibilityCache;
+  mobileListWindows = mobileListWindows;
 
   getClipboard = getClipboard;
   setClipboard = setClipboard;

package/lib/execute-method-map.ts

@@ -263,4 +263,11 @@ export const executeMethodMap = {
   'mobile: resetAccessibilityCache': {
     command: 'mobileResetAccessibilityCache',
   },
+
+  'mobile: listWindows': {
+    command: 'mobileListWindows',
+    params: {
+      optional: ['filters', 'skipScreenshots'],
+    },
+  },
 } as const satisfies ExecuteMethodMap<any>;

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
   "name": "appium-uiautomator2-driver",
-  "version": "6.4.0",
+  "version": "6.5.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-uiautomator2-driver",
-      "version": "6.4.0",
+      "version": "6.5.0",
       "license": "Apache-2.0",
       "dependencies": {
         "appium-adb": "^14.0.0",
         "appium-android-driver": "^12.3.0",
-        "appium-uiautomator2-server": "^9.2.0",
+        "appium-uiautomator2-server": "^9.6.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.0",
-      "resolved": "https://registry.npmjs.org/appium-uiautomator2-server/-/appium-uiautomator2-server-9.3.0.tgz",
-      "integrity": "sha512-JXyFhHZs4Bwbn+p08KCBJSuhM/U4zJep9FnDkkJdTgBO38CQDDOxXCyDEKQsqlTC2xeo5QjKvg7moGRptZWxXg==",
+      "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==",
       "license": "Apache-2.0",
       "engines": {
         "node": "^20.19.0 || ^22.12.0 || >=24.0.0",

package/package.json

@@ -7,7 +7,7 @@
     "automated testing",
     "android"
   ],
-  "version": "6.4.0",
+  "version": "6.5.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.2.0",
+    "appium-uiautomator2-server": "^9.6.1",
     "asyncbox": "^3.0.0",
     "axios": "^1.12.2",
     "bluebird": "^3.5.1",