@testingbot/mobilewright-driver 0.1.0

package/dist/webview.js

@@ -0,0 +1,109 @@
+import createDebug from 'debug';
+const debug = createDebug('testingbot:webview');
+const NATIVE_CONTEXT = 'NATIVE_APP';
+/**
+ * WebView support over Appium's context API. Attaching switches the ONE
+ * WebDriver context the session has — native commands issued while a webview
+ * session is open target the web layer, which is also how the reference
+ * drivers behave. close() switches back to the native context.
+ */
+export class AppiumWebViewBridge {
+    hub;
+    sessionId;
+    constructor(hub, sessionId) {
+        this.hub = hub;
+        this.sessionId = sessionId;
+    }
+    async listWebViews() {
+        const sessionId = this.sessionId();
+        // `mobile: getContexts` is richer (title/url) but not uniform across
+        // drivers; fall back to the plain context list (names only).
+        let entries;
+        try {
+            entries = await this.hub.execute(sessionId, 'mobile: getContexts', []);
+        }
+        catch {
+            entries = await this.hub.get(sessionId, '/contexts');
+        }
+        return entries
+            .map((entry) => normalizeContext(entry))
+            .filter((info) => info !== undefined && info.id !== NATIVE_CONTEXT);
+    }
+    async attachWebView(id) {
+        const sessionId = this.sessionId();
+        await this.hub.post(sessionId, '/context', { name: id });
+        debug('attached to %s', id);
+        return new AppiumWebViewSession(this.hub, sessionId, id);
+    }
+}
+class AppiumWebViewSession {
+    hub;
+    sessionId;
+    contextId;
+    constructor(hub, sessionId, contextId) {
+        this.hub = hub;
+        this.sessionId = sessionId;
+        this.contextId = contextId;
+    }
+    async evaluate(expr) {
+        return await this.hub.execute(this.sessionId, `return (${expr});`, []);
+    }
+    async goto(url) {
+        await this.hub.post(this.sessionId, '/url', { url });
+    }
+    async goBack() {
+        await this.hub.post(this.sessionId, '/back', {});
+    }
+    async goForward() {
+        await this.hub.post(this.sessionId, '/forward', {});
+    }
+    async url() {
+        return await this.hub.get(this.sessionId, '/url');
+    }
+    async title() {
+        return await this.hub.get(this.sessionId, '/title');
+    }
+    async reload() {
+        await this.hub.post(this.sessionId, '/refresh', {});
+    }
+    async waitForLoadState(state = 'load') {
+        const acceptable = state === 'load' ? ['complete'] : ['interactive', 'complete'];
+        const deadline = Date.now() + 30_000;
+        for (;;) {
+            const readyState = await this.evaluate('document.readyState').catch(() => '');
+            if (acceptable.includes(readyState))
+                return;
+            if (Date.now() >= deadline) {
+                throw new Error(`TestingBotDriver: webview ${this.contextId} did not reach "${state}" within 30s`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+    }
+    async close() {
+        await this.hub.post(this.sessionId, '/context', { name: NATIVE_CONTEXT });
+        debug('detached from %s', this.contextId);
+    }
+}
+/** Contexts arrive as plain names or driver-specific objects. */
+function normalizeContext(entry) {
+    if (typeof entry === 'string') {
+        return { id: entry, url: '', title: '' };
+    }
+    if (entry && typeof entry === 'object') {
+        const record = entry;
+        const pages = Array.isArray(record['pages']) ? record['pages'] : [];
+        const id = str(record['id']) ?? str(record['name']) ?? str(record['webviewName']);
+        if (!id)
+            return undefined;
+        return {
+            id,
+            url: str(record['url']) ?? str(pages[0]?.['url']) ?? '',
+            title: str(record['title']) ?? str(pages[0]?.['title']) ?? '',
+        };
+    }
+    return undefined;
+}
+function str(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+//# sourceMappingURL=webview.js.map

package/dist/webview.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@testingbot/mobilewright-driver",
+  "version": "0.1.0",
+  "description": "TestingBot driver for Mobilewright — run mobilewright tests on TestingBot's device cloud",
+  "homepage": "https://testingbot.com",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/testingbot/mobilewright-testingbot.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mobilewright",
+    "testingbot",
+    "appium",
+    "webdriver",
+    "mobile",
+    "testing",
+    "ios",
+    "android"
+  ],
+  "peerDependencies": {
+    "@mobilewright/protocol": ">=0.0.53 <0.1.0",
+    "testingbot-tunnel-launcher": ">=1.1.0"
+  },
+  "dependencies": {
+    "debug": "^4.4.0",
+    "fast-xml-parser": "^5.11.0"
+  },
+  "devDependencies": {
+    "@mobilewright/protocol": "0.0.53",
+    "@types/debug": "^4.1.12",
+    "@types/node": "^20.17.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.10"
+  },
+  "peerDependenciesMeta": {
+    "testingbot-tunnel-launcher": {
+      "optional": true
+    }
+  },
+  "bin": {
+    "mobilewright-driver": "dist/cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}