fix: add backgroundApp (#988)

* fix: add backgroundApp

* modify default arg

* remove extra new line

* remove debuug deps

Author: KazuCocoa

lib/commands/app-management.js

@@ -345,6 +345,19 @@ export async function background(seconds) {
   return await this.adb.startApp(args);
 }
 
+/**
+ * Puts the app to background and waits the given number of seconds then restores the app
+ * if necessary. The call is blocking.
+ *
+ * @this {AndroidDriver}
+ * @param {number} [seconds=-1] The amount of seconds to wait between putting the app to background and restoring it.
+ * Any negative value means to not restore the app after putting it to background.
+ * @returns {Promise<void>}
+ */
+export async function mobileBackgroundApp (seconds = -1) {
+  await this.background(seconds);
+}
+
 /**
  * @this {AndroidDriver}
  * @param {import('../driver').AndroidDriverOpts?} [opts=null]

lib/driver.ts

@@ -71,6 +71,7 @@ import {
   installAUT,
   resetAUT,
   background,
+  mobileBackgroundApp,
   getCurrentActivity,
   getCurrentPackage,
   mobileClearApp,
@@ -413,6 +414,7 @@ class AndroidDriver
   activateApp = activateApp;
   queryAppState = queryAppState;
   isAppInstalled = isAppInstalled;
+  mobileBackgroundApp = mobileBackgroundApp;
 
   mobileGetUiMode = mobileGetUiMode;
   mobileSetUiMode = mobileSetUiMode;

lib/execute-method-map.ts

@@ -174,7 +174,12 @@ export const executeMethodMap = {
       required: ['appId'],
     },
   },
-
+  'mobile: backgroundApp': {
+    command: 'mobileBackgroundApp',
+    params: {
+      optional: ['seconds'],
+    }
+  },
   'mobile: startService': {
     command: 'mobileStartService',
     params: {