appium-espresso-driver 2.36.2 → 2.37.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [2.37.0](https://github.com/appium/appium-espresso-driver/compare/v2.36.2...v2.37.0) (2024-03-18)
+
+
+### Features
+
+* add mobile:startLogsBroadcast and mobile:stopLogsBroadcast ([#988](https://github.com/appium/appium-espresso-driver/issues/988)) ([94db792](https://github.com/appium/appium-espresso-driver/commit/94db79260b6b764a7592ba486cc4055755af3600))
+
 ## [2.36.2](https://github.com/appium/appium-espresso-driver/compare/v2.36.1...v2.36.2) (2024-03-07)
 
 

package/README.md

@@ -1632,6 +1632,14 @@ Name | Type | Required | Description | Example
 mode | string | yes | One of the supported UI mode names: `night` or `car`. | night
 
 
+### mobile: startLogsBroadcast
+
+Starts Android logcat broadcast websocket on the same host and port where Appium server is running at `/ws/session/:sessionId:/appium/logcat` endpoint. The method will return immediately if the web socket is already listening. Each connected webcoket listener will receive logcat log lines as soon as they are visible to Appium. Read [Using Mobile Execution Commands to Continuously Stream Device Logs with Appium](https://appiumpro.com/editions/55-using-mobile-execution-commands-to-continuously-stream-device-logs-with-appium) for more details.
+
+### mobile: stopLogsBroadcast
+
+Stops the previously started logcat broadcasting websocket server. This method will return immediately if no server is running. Read [Using Mobile Execution Commands to Continuously Stream Device Logs with Appium](https://appiumpro.com/editions/55-using-mobile-execution-commands-to-continuously-stream-device-logs-with-appium) for more details.
+
 ## Backdoor Extension Usage
 
 Espresso driver allows to directly invoke a method from your application under test using `mobile: backdoor` extension. If `target` is set to `application` then methods will be invoked on the application class. If target is set to `activity` then methods will be invoked on the current application activity. If target is set to `element` then methods will be invoked on the selected view element. Only 'public' methods can be invoked ('open' modifier is necessary in Kotlin). The following primitive types are supported for method arguments: "int", "boolean", "byte", "short", "long", "float", "char". Object wrappers over primitive types with fully qualified names "java.lang.*" are also supported: "java.lang.CharSequence", "java.lang.String", "java.lang.Integer", "java.lang.Float", "java.lang.Double", "java.lang.Boolean", "java.lang.Long", "java.lang.Short", "java.lang.Character", etc.

package/build/lib/commands/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,uFAJW,MAAM,2CAEJ,QAAQ,GAAG,CAAC,CA2HxB"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,uFAJW,MAAM,2CAEJ,QAAQ,GAAG,CAAC,CA8HxB"}

package/build/lib/commands/execute.js

@@ -94,6 +94,8 @@ async function executeMobile(mobileCommand, opts = {}) {
         screenshots: 'mobileScreenshots',
         setUiMode: 'mobileSetUiMode',
         getUiMode: 'mobileGetUiMode',
+        startLogsBroadcast: 'mobileStartLogsBroadcast',
+        stopLogsBroadcast: 'mobileStopLogsBroadcast',
     };
     if (!lodash_1.default.has(mobileCommandsMapping, mobileCommand)) {
         throw new driver_1.errors.UnknownCommandError(`Unknown mobile command "${mobileCommand}". ` +

package/build/lib/commands/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":";;;;;;AAAA,oDAAuB;AACvB,0CAAuC;AAEvC;;;;;GAKG;AACI,KAAK,UAAU,aAAa,CAAE,aAAa,EAAE,IAAI,GAAG,EAAE;IAC3D,MAAM,qBAAqB,GAAG;QAC5B,KAAK,EAAE,aAAa;QAEpB,qBAAqB,EAAE,6BAA6B;QAEpD,mBAAmB,EAAE,2BAA2B;QAEhD,iBAAiB,EAAE,yBAAyB;QAC5C,cAAc,EAAE,sBAAsB;QAEtC,oBAAoB,EAAE,4BAA4B;QAClD,mBAAmB,EAAE,2BAA2B;QAEhD,KAAK,EAAE,aAAa;QACpB,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,mBAAmB;QAEhC,UAAU,EAAE,qBAAqB;QAEjC,cAAc,EAAE,sBAAsB;QAEtC,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,mBAAmB;QAEhC,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QAExB,aAAa,EAAE,qBAAqB;QAEpC,QAAQ,EAAE,gBAAgB;QAE1B,YAAY,EAAE,oBAAoB;QAElC,WAAW,EAAE,mBAAmB;QAChC,qBAAqB,EAAE,6BAA6B;QAEpD,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,mBAAmB;QAEhC,eAAe,EAAE,uBAAuB;QAExC,gBAAgB,EAAE,wBAAwB;QAE1C,OAAO,EAAE,eAAe;QAExB,QAAQ,EAAE,gBAAgB;QAC1B,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,kBAAkB;QAC9B,UAAU,EAAE,kBAAkB;QAE9B,cAAc,EAAE,sBAAsB;QACtC,aAAa,EAAE,qBAAqB;QACpC,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;QAC5B,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,kBAAkB;QAC9B,QAAQ,EAAE,gBAAgB;QAC1B,aAAa,EAAE,qBAAqB;QACpC,kBAAkB,EAAE,oBAAoB;QACxC,iBAAiB,EAAE,mBAAmB;QAEtC,aAAa,EAAE,qBAAqB;QACpC,YAAY,EAAE,oBAAoB;QAClC,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;QAE5B,uBAAuB,EAAE,+BAA+B;QACxD,yBAAyB,EAAE,iCAAiC;QAC5D,mBAAmB,EAAE,2BAA2B;QAChD,eAAe,EAAE,uBAAuB;QAExC,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,cAAc;QACtB,QAAQ,EAAE,UAAU;QAEpB,eAAe,EAAE,uBAAuB;QAExC,6BAA6B,EAAE,qCAAqC;QACpE,iCAAiC,EAAE,yCAAyC;QAC5E,4BAA4B,EAAE,oCAAoC;QAElE,eAAe,EAAE,uBAAuB;QACxC,eAAe,EAAE,uBAAuB;QACxC,SAAS,EAAE,wBAAwB;QACnC,YAAY,EAAE,2BAA2B;QAEzC,QAAQ,EAAE,gBAAgB;QAC1B,YAAY,EAAE,cAAc;QAC5B,eAAe,EAAE,iBAAiB;QAElC,iBAAiB,EAAE,mBAAmB;QACtC,aAAa,EAAE,eAAe;QAC9B,WAAW,EAAE,mBAAmB;QAEhC,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,eAAe;QACxB,aAAa,EAAE,qBAAqB;QACpC,YAAY,EAAE,oBAAoB;QAClC,SAAS,EAAE,WAAW;QAEtB,kBAAkB,EAAE,0BAA0B;QAC9C,uBAAuB,EAAE,yBAAyB;QAElD,SAAS,EAAE,+BAA+B;QAE1C,WAAW,EAAE,mBAAmB;QAEhC,SAAS,EAAE,iBAAiB;QAC5B,SAAS,EAAE,iBAAiB;KAC7B,CAAC;IAEF,IAAI,CAAC,gBAAC,CAAC,GAAG,CAAC,qBAAqB,EAAE,aAAa,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,eAAM,CAAC,mBAAmB,CAAC,2BAA2B,aAAa,KAAK;YAChF,QAAQ,gBAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,0BAA0B,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAzHD,sCAyHC"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":"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"}

package/build/lib/driver.d.ts

@@ -216,7 +216,14 @@ export declare class EspressoDriver extends AndroidDriver implements ExternalDri
                 readonly command: "networkSpeed";
                 readonly payloadParams: {
                     readonly required: readonly ["netspeed"];
-                };
+                }; /**
+                 * Unzip the given app path and return the first package that has SUPPORTED_EXTENSIONS
+                 * in the archived file.
+                 *
+                 * @param {string} appPath The path to app file.
+                 * @returns {Promise<string>} Retuns the path to an unzipped app file path.
+                 * @throws Raise an exception if the zip did not have any SUPPORTED_EXTENSIONS packages.
+                 */
             };
         };
         readonly '/session/:sessionId/appium/device/keyevent': {

package/build/lib/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../lib/driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../lib/driver.ts"],"names":[],"mappings":"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"}

package/lib/commands/execute.js

@@ -121,6 +121,9 @@ export async function executeMobile (mobileCommand, opts = {}) {
 
     setUiMode: 'mobileSetUiMode',
     getUiMode: 'mobileGetUiMode',
+
+    startLogsBroadcast: 'mobileStartLogsBroadcast',
+    stopLogsBroadcast: 'mobileStopLogsBroadcast',
   };
 
   if (!_.has(mobileCommandsMapping, mobileCommand)) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "appium-espresso-driver",
-  "version": "2.36.2",
+  "version": "2.37.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-espresso-driver",
-      "version": "2.36.2",
+      "version": "2.37.0",
       "license": "Apache-2.0",
       "dependencies": {
         "appium-adb": "^12.0.0",
@@ -107,6 +107,11 @@
         "spdy": "4.0.2"
       }
     },
+    "node_modules/@appium/base-driver/node_modules/@types/lodash": {
+      "version": "4.14.202",
+      "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.14.202.tgz",
+      "integrity": "sha512-OvlIYQK9tNneDlS0VN54LLd5uiPCBOp7gS5Z0f1mjoJYBrtStzgmJBxONW3U6OZqdtNzZPmn9BS/7WI7BFFcFQ=="
+    },
     "node_modules/@appium/schema": {
       "version": "0.5.0",
       "resolved": "https://registry.npmjs.org/@appium/schema/-/schema-0.5.0.tgz",
@@ -679,11 +684,6 @@
       "resolved": "https://registry.npmjs.org/@types/lockfile/-/lockfile-1.0.4.tgz",
       "integrity": "sha512-Q8oFIHJHr+htLrTXN2FuZfg+WXVHQRwU/hC2GpUu+Q8e3FUM9EDkS2pE3R2AO1ZGu56f479ybdMCNF1DAu8cAQ=="
     },
-    "node_modules/@types/lodash": {
-      "version": "4.14.202",
-      "resolved": "https://registry.npmjs.org/@types/lodash/-/lodash-4.14.202.tgz",
-      "integrity": "sha512-OvlIYQK9tNneDlS0VN54LLd5uiPCBOp7gS5Z0f1mjoJYBrtStzgmJBxONW3U6OZqdtNzZPmn9BS/7WI7BFFcFQ=="
-    },
     "node_modules/@types/method-override": {
       "version": "0.0.35",
       "resolved": "https://registry.npmjs.org/@types/method-override/-/method-override-0.0.35.tgz",
@@ -711,9 +711,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "20.11.25",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.11.25.tgz",
-      "integrity": "sha512-TBHyJxk2b7HceLVGFcpAUjsa5zIdsPWlR6XHfyGzd0SFu+/NFgQgMAl96MSDZgQDvJAvV6BKsFOrt6zIL09JDw==",
+      "version": "20.11.29",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.11.29.tgz",
+      "integrity": "sha512-P99thMkD/1YkCvAtOd6/zGedKNA0p2fj4ZpjCzcNiSCBWgm3cNRTBfa/qjFnsKkkojxu4vVLtWpesnZ9+ap+gA==",
       "dependencies": {
         "undici-types": "~5.26.4"
       }
@@ -737,9 +737,9 @@
       "integrity": "sha512-JOqsl+ZoCpP4e8TDke9W79FDcSgPAR0l6pixx2JHkhnRjvShyYiAYw2LVsnA7K08Y6DeOnaU6ujmENO4os/cYg=="
     },
     "node_modules/@types/qs": {
-      "version": "6.9.12",
-      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.12.tgz",
-      "integrity": "sha512-bZcOkJ6uWrL0Qb2NAWKa7TBU+mJHPzhx9jjLL1KHF+XpzEcR7EXHvjbHlGtR/IsP1vyPrehuS6XqkmaePy//mg=="
+      "version": "6.9.13",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.9.13.tgz",
+      "integrity": "sha512-iLR+1vTTJ3p0QaOUq6ACbY1mzKTODFDT/XedZI8BksOotFmL4ForwDfRQ/DZeuTHR7/2i4lI1D203gdfxuqTlA=="
     },
     "node_modules/@types/range-parser": {
       "version": "1.2.7",
@@ -882,9 +882,9 @@
       }
     },
     "node_modules/appium-android-driver": {
-      "version": "9.0.2",
-      "resolved": "https://registry.npmjs.org/appium-android-driver/-/appium-android-driver-9.0.2.tgz",
-      "integrity": "sha512-VR9WZhwiC1ozTPUGFLQ/Su/fBUjohbgITZ58ha3GffnEffbi3ZCWfTGG8sA+Q2REu59AAbolYGgv1eZQ8DX5ZA==",
+      "version": "9.0.3",
+      "resolved": "https://registry.npmjs.org/appium-android-driver/-/appium-android-driver-9.0.3.tgz",
+      "integrity": "sha512-SMw+eHKr4sQjHMxoGtggL85wzABFGnxalAXBDVTDJvssGwRjkMZtI2+A/D712VBAXkUNbRXWAfPBUPWnNHNB5A==",
       "dependencies": {
         "@appium/support": "^4.2.0",
         "@colors/colors": "^1.6.0",
@@ -914,9 +914,9 @@
       }
     },
     "node_modules/appium-chromedriver": {
-      "version": "5.6.35",
-      "resolved": "https://registry.npmjs.org/appium-chromedriver/-/appium-chromedriver-5.6.35.tgz",
-      "integrity": "sha512-6yk3ruhbIJVPIVZ0+5umrMlSJoUw/+27+3CU7k4q1nINQJpJKeoVyLaQxoaH6YBrw5Js0g46BEoV+Z6JJDbRsA==",
+      "version": "5.6.39",
+      "resolved": "https://registry.npmjs.org/appium-chromedriver/-/appium-chromedriver-5.6.39.tgz",
+      "integrity": "sha512-ymPQk/gpeE95nuB2+VtxDkHRi4LhD+eBJFmGryz0sAejWsiPEXiMmzdo9Se5atOsvm2b5smbddOeqpWGNeYrOg==",
       "hasInstallScript": true,
       "dependencies": {
         "@appium/base-driver": "^9.1.0",
@@ -1843,9 +1843,9 @@
       }
     },
     "node_modules/follow-redirects": {
-      "version": "1.15.5",
-      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.5.tgz",
-      "integrity": "sha512-vSFWUON1B+yAw1VN4xMfxgn5fTUiaOzAJCKBwIIgT/+7CuGy9+r+5gITvP62j3RmaD5Ph65UaERdOSRGUzZtgw==",
+      "version": "1.15.6",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.6.tgz",
+      "integrity": "sha512-wWN62YITEaOpSK584EZXJafH1AGpO8RVgElfkuXbTOrPX4fIfOyEpW/CsiNd8JdYrAoOvafRTOEnvsO++qCqFA==",
       "funding": [
         {
           "type": "individual",
@@ -2136,9 +2136,9 @@
       "integrity": "sha512-8Rf9Y83NBReMnx0gFzA8JImQACstCYWUplepDa9xprwwtmgEZUF0h/i5xSA625zB/I37EtrswSST6OXxwaaIJQ=="
     },
     "node_modules/hasown": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.1.tgz",
-      "integrity": "sha512-1/th4MHjnwncwXsIW6QMzlvYL9kG5e/CpVvLRZe4XPa8TOUNbCELqmvhDmnkNsAjwaG4+I8gJJL0JBvTTLO9qA==",
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
       "dependencies": {
         "function-bind": "^1.1.2"
       },
@@ -3396,16 +3396,16 @@
       "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw=="
     },
     "node_modules/set-function-length": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.1.tgz",
-      "integrity": "sha512-j4t6ccc+VsKwYHso+kElc5neZpjtq9EnRICFZtWyBsLojhmeF/ZBd/elqm22WJh/BziDe/SBiOeAt0m2mfLD0g==",
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/set-function-length/-/set-function-length-1.2.2.tgz",
+      "integrity": "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==",
       "dependencies": {
-        "define-data-property": "^1.1.2",
+        "define-data-property": "^1.1.4",
         "es-errors": "^1.3.0",
         "function-bind": "^1.1.2",
-        "get-intrinsic": "^1.2.3",
+        "get-intrinsic": "^1.2.4",
         "gopd": "^1.0.1",
-        "has-property-descriptors": "^1.0.1"
+        "has-property-descriptors": "^1.0.2"
       },
       "engines": {
         "node": ">= 0.4"

package/package.json

@@ -7,7 +7,7 @@
     "automated testing",
     "android"
   ],
-  "version": "2.36.2",
+  "version": "2.37.0",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {