@xenon-device-management/xenon 2.14.0 → 2.15.0

package/lib/test/unit/fingerprint-identity.spec.js

@@ -0,0 +1,433 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const sinon_1 = __importDefault(require("sinon"));
+const typedi_1 = require("typedi");
+const CommandInterceptor_1 = require("../../src/interceptors/CommandInterceptor");
+const HealEtalonService_1 = require("../../src/services/healing/HealEtalonService");
+const HealedLocatorGenerator_1 = require("../../src/services/healing/HealedLocatorGenerator");
+const FuzzyXmlHealingProvider_1 = require("../../src/services/healing/FuzzyXmlHealingProvider");
+const resilioPath_1 = require("../../src/services/healing/resilioPath");
+const fingerprintIdentity_1 = require("../../src/services/healing/fingerprintIdentity");
+const waitFor_1 = require("../../src/services/autowait/waitFor");
+const container_registration_1 = require("../helpers/container-registration");
+/**
+ * A fingerprint has to say which element it is, not only where it was.
+ *
+ * Through 2.14, learning asked the driver for `getElementAttribute`, which
+ * UiAutomator2 and XCUITest don't have (the command is `getAttribute(name,
+ * elementId)`). Every read failed quietly, so a learnt fingerprint held only
+ * the element's type and rect. Fuzzy XML weighs position at 5 of about 8, so
+ * any element of that type at that spot healed the selector: on an unexpected
+ * screen, the test tapped whatever button sat where "Pay" used to be.
+ */
+describe('selector fingerprints identify their element', () => {
+    let restoreContainer;
+    beforeEach(() => {
+        restoreContainer = (0, container_registration_1.saveRegistrations)(HealEtalonService_1.HealEtalonService, HealedLocatorGenerator_1.HealedLocatorGenerator);
+        typedi_1.Container.set(HealedLocatorGenerator_1.HealedLocatorGenerator, new HealedLocatorGenerator_1.HealedLocatorGenerator());
+    });
+    afterEach(() => {
+        sinon_1.default.restore();
+        restoreContainer();
+    });
+    describe('learning', () => {
+        let saved;
+        let existing;
+        beforeEach(() => {
+            existing = null;
+            saved = sinon_1.default.stub().resolves();
+            typedi_1.Container.set(HealEtalonService_1.HealEtalonService, {
+                getSignature: () => __awaiter(void 0, void 0, void 0, function* () { return existing; }),
+                saveSignature: saved,
+            });
+        });
+        let asked;
+        beforeEach(() => {
+            asked = [];
+        });
+        /**
+         * UiAutomator2 as it is: getAttribute(name, elementId) answers
+         * String(value), so an unset attribute is the string "null", and an
+         * attribute it doesn't know throws.
+         */
+        const androidDriver = () => ({
+            caps: { platformName: 'Android' },
+            getAttribute: (name, elementId) => __awaiter(void 0, void 0, void 0, function* () {
+                (0, chai_1.expect)(elementId).to.equal('el-1');
+                asked.push(name);
+                const known = {
+                    'resource-id': 'com.shop:id/pay',
+                    text: 'Pay now',
+                    name: 'Pay now',
+                    'content-desc': null,
+                    hint: null,
+                };
+                if (!(name in known))
+                    throw new Error(`No such attribute '${name}'`);
+                return String(known[name]);
+            }),
+            getElementRect: () => __awaiter(void 0, void 0, void 0, function* () { return ({ x: 40, y: 900, width: 300, height: 96 }); }),
+            getName: () => __awaiter(void 0, void 0, void 0, function* () { return 'android.widget.Button'; }),
+            getPageSource: () => __awaiter(void 0, void 0, void 0, function* () { return '<hierarchy><android.widget.Button text="Pay now" resource-id="com.shop:id/pay" bounds="[40,900][340,996]"/></hierarchy>'; }),
+        });
+        /** XCUITest as it is: WebDriverAgent throws for an attribute it doesn't have. */
+        const iosDriver = () => ({
+            caps: { platformName: 'iOS' },
+            getAttribute: (name) => __awaiter(void 0, void 0, void 0, function* () {
+                asked.push(name);
+                const known = { name: 'checkout.pay', label: 'Pay now' };
+                if (!(name in known))
+                    throw new Error('FBUnknownAttributeException');
+                return known[name];
+            }),
+            getElementRect: () => __awaiter(void 0, void 0, void 0, function* () { return ({ x: 20, y: 800, width: 388, height: 50 }); }),
+            getName: () => __awaiter(void 0, void 0, void 0, function* () { return 'XCUIElementTypeButton'; }),
+            getPageSource: () => __awaiter(void 0, void 0, void 0, function* () { return '<AppiumAUT><XCUIElementTypeButton name="checkout.pay" label="Pay now" x="20" y="800" width="388" height="50"/></AppiumAUT>'; }),
+        });
+        let sessions = 0;
+        function learn(driver) {
+            return __awaiter(this, void 0, void 0, function* () {
+                sessions += 1;
+                const interceptor = typedi_1.Container.get(CommandInterceptor_1.CommandInterceptor);
+                yield interceptor.triggerLearning(driver, ['id', 'com.shop:id/pay'], { ELEMENT: 'el-1' }, `fp-${sessions}`);
+                const done = yield (0, waitFor_1.waitFor)(() => __awaiter(this, void 0, void 0, function* () { return (saved.called ? true : null); }), {
+                    timeoutMs: 2000,
+                    intervalMs: 5,
+                });
+                return 'value' in done;
+            });
+        }
+        it("reads an Android element's attributes with the driver's getAttribute", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, chai_1.expect)(yield learn(androidDriver())).to.equal(true);
+            const [strategy, selector, node] = saved.firstCall.args;
+            (0, chai_1.expect)([strategy, selector]).to.deep.equal(['id', 'com.shop:id/pay']);
+            const identity = node.attributes.filter((a) => !['x', 'y', 'width', 'height'].includes(a.name));
+            // "null" is UiAutomator2's answer for an attribute the element hasn't set.
+            (0, chai_1.expect)(identity).to.deep.equal([
+                { name: 'resource-id', value: 'com.shop:id/pay' },
+                { name: 'text', value: 'Pay now' },
+            ]);
+            // Only what UiAutomator2 has, and never a field's value.
+            (0, chai_1.expect)(asked.sort()).to.deep.equal(['content-desc', 'hint', 'resource-id', 'text']);
+        }));
+        it("reads an iPhone element's identifier and label", () => __awaiter(void 0, void 0, void 0, function* () {
+            (0, chai_1.expect)(yield learn(iosDriver())).to.equal(true);
+            const node = saved.firstCall.args[2];
+            (0, chai_1.expect)(node.attributes).to.deep.include({ name: 'name', value: 'checkout.pay' });
+            (0, chai_1.expect)(node.attributes).to.deep.include({ name: 'label', value: 'Pay now' });
+            // WebDriverAgent throws for any other: no round trips that can only fail.
+            (0, chai_1.expect)(asked.sort()).to.deep.equal(['label', 'name']);
+        }));
+        it('learns again a fingerprint that has a path but nothing that says which element it is', () => __awaiter(void 0, void 0, void 0, function* () {
+            existing = {
+                nodeName: 'android.widget.Button',
+                attributes: { x: '40', y: '900', width: '300', height: '96' },
+                path: { format: resilioPath_1.RESILIO_PATH_FORMAT, nodes: [{ tag: 'hierarchy' }] },
+            };
+            (0, chai_1.expect)(yield learn(androidDriver())).to.equal(true);
+        }));
+    });
+    it("doesn't keep an element's value, which is what a test typed into a field", () => __awaiter(void 0, void 0, void 0, function* () {
+        const service = new HealEtalonService_1.HealEtalonService();
+        const store = { saveSignature: sinon_1.default.stub().resolves() };
+        service.store = store;
+        yield service.saveSignature('id', 'email', {
+            nodeName: 'XCUIElementTypeTextField',
+            attributes: [
+                { name: 'name', value: 'signup.email' },
+                { name: 'value', value: 'jane.doe@example.com' },
+            ],
+        });
+        (0, chai_1.expect)(store.saveSignature.firstCall.args[0].attributes).to.deep.equal({
+            name: 'signup.email',
+        });
+    }));
+    describe('Fuzzy XML', () => {
+        const ORDER_TITLE = '<android.widget.TextView text="Order #1042" resource-id="com.shop:id/title" bounds="[48,100][1032,180]"/>';
+        const IOS_APP_RECT = 'name="Shop" label="Shop" x="0" y="0" width="428" height="926"';
+        let fingerprint;
+        let resolved;
+        beforeEach(() => {
+            fingerprint = null;
+            resolved = [];
+        });
+        function heal(selector, strategy, pageSource) {
+            const provider = new FuzzyXmlHealingProvider_1.FuzzyXmlHealingProvider({
+                getSignature: () => __awaiter(this, void 0, void 0, function* () { return fingerprint; }),
+            });
+            return provider.heal({
+                sessionId: 's',
+                strategy,
+                selector,
+                pageSource,
+                driver: {
+                    findElement: (_using, xpath) => __awaiter(this, void 0, void 0, function* () {
+                        resolved.push(xpath);
+                        return { ELEMENT: 'healed-1' };
+                    }),
+                },
+            });
+        }
+        const android = (button) => `<hierarchy><android.widget.FrameLayout bounds="[0,0][1080,1920]">${ORDER_TITLE}` +
+            `${button}</android.widget.FrameLayout></hierarchy>`;
+        const AT_PAY = { x: '40', y: '900', width: '300', height: '96' };
+        const PAY = {
+            nodeName: 'android.widget.Button',
+            attributes: {
+                'resource-id': 'com.shop:id/pay',
+                text: 'Pay now',
+                x: '40',
+                y: '900',
+                width: '300',
+                height: '96',
+            },
+        };
+        it("doesn't heal to a different element at the same spot", () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = PAY;
+            const cancel = android('<android.widget.Button text="Cancel order" resource-id="com.shop:id/cancel" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/pay', 'id', cancel)).to.equal(null);
+        }));
+        it('heals an element whose id was renamed and kept its text', () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = PAY;
+            const renamed = android('<android.widget.Button text="Pay now" resource-id="com.shop:id/checkout_pay" bounds="[40,900][340,996]"/>');
+            const healed = yield heal('com.shop:id/pay', 'id', renamed);
+            (0, chai_1.expect)(healed === null || healed === void 0 ? void 0 : healed.id).to.equal('healed-1');
+            (0, chai_1.expect)(resolved[0]).to.match(/checkout_pay|Pay now/);
+        }));
+        it('heals an element that kept its id and changed its text', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = PAY;
+            const reworded = android('<android.widget.Button text="Pay" resource-id="com.shop:id/pay" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)((_a = (yield heal("//android.widget.Button[@text='Pay now']", 'xpath', reworded))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        const ios = (button) => `<AppiumAUT><XCUIElementTypeApplication ${IOS_APP_RECT}>` +
+            `${button}</XCUIElementTypeApplication></AppiumAUT>`;
+        const IOS_PAY = {
+            nodeName: 'XCUIElementTypeButton',
+            attributes: {
+                name: 'checkout.pay',
+                label: 'Pay now',
+                x: '20',
+                y: '800',
+                width: '388',
+                height: '50',
+            },
+        };
+        it('reads an iOS accessibility identifier the same way', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = IOS_PAY;
+            const cancel = ios('<XCUIElementTypeButton name="checkout.cancel" label="Cancel order" x="20" y="800" width="388" height="50"/>');
+            const reworded = ios('<XCUIElementTypeButton name="checkout.pay" label="Pay" x="20" y="800" width="388" height="50"/>');
+            (0, chai_1.expect)(yield heal('checkout.pay', 'accessibility id', cancel)).to.equal(null);
+            (0, chai_1.expect)((_a = (yield heal('checkout.pay', 'accessibility id', reworded))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it("doesn't heal to the opposite button", () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: Object.assign({ 'resource-id': 'com.shop:id/login', text: 'Log in' }, AT_PAY),
+            };
+            const logout = android('<android.widget.Button text="Log out" resource-id="com.shop:id/logout" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/login', 'id', logout)).to.equal(null);
+            fingerprint = {
+                nodeName: 'XCUIElementTypeButton',
+                attributes: {
+                    name: 'auth.signIn',
+                    label: 'Sign in',
+                    x: '20',
+                    y: '800',
+                    width: '388',
+                    height: '50',
+                },
+            };
+            const signUp = ios('<XCUIElementTypeButton name="auth.signUp" label="Sign up" x="20" y="800" width="388" height="50"/>');
+            (0, chai_1.expect)(yield heal('auth.signIn', 'accessibility id', signUp)).to.equal(null);
+        }));
+        it('heals an element whose id was renamed outright and kept its text', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = PAY;
+            const renamed = android('<android.widget.Button text="Pay now" resource-id="com.shop:id/btn_primary" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop:id/pay', 'id', renamed))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it('heals an icon whose id was renamed and kept its description', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = {
+                nodeName: 'android.widget.ImageButton',
+                attributes: Object.assign({ 'resource-id': 'com.shop:id/share', 'content-desc': 'Share' }, AT_PAY),
+            };
+            const icon = android('<android.widget.ImageButton content-desc="Share" resource-id="com.shop:id/action_3" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop:id/share', 'id', icon))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it("compares resource-ids without the app's package, as a debug build's differs", () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: Object.assign({ 'resource-id': 'com.shop.debug:id/pay', text: 'Pay now' }, AT_PAY),
+            };
+            const release = android('<android.widget.Button text="Pay" resource-id="com.shop:id/pay" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop.debug:id/pay', 'id', release))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it('reads the text again when an id gains words, as pay_later or undo_delete do', () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = PAY;
+            const later = android('<android.widget.Button text="Pay later" resource-id="com.shop:id/pay_later" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/pay', 'id', later)).to.equal(null);
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: Object.assign({ 'resource-id': 'com.mail:id/delete', text: 'Delete' }, AT_PAY),
+            };
+            const undo = android('<android.widget.Button text="Undo delete" resource-id="com.mail:id/undo_delete" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.mail:id/delete', 'id', undo)).to.equal(null);
+        }));
+        it("doesn't heal an icon with no text whose id names another", () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = {
+                nodeName: 'android.widget.ImageButton',
+                attributes: Object.assign({ 'resource-id': 'com.shop:id/cart' }, AT_PAY),
+            };
+            const menu = android('<android.widget.ImageButton resource-id="com.shop:id/menu" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/cart', 'id', menu)).to.equal(null);
+        }));
+        it('tells non-Latin identifiers and labels apart', () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = {
+                nodeName: 'XCUIElementTypeButton',
+                attributes: {
+                    name: 'checkout.pay',
+                    label: '支払う',
+                    x: '20',
+                    y: '800',
+                    width: '388',
+                    height: '50',
+                },
+            };
+            const cancel = ios('<XCUIElementTypeButton name="キャンセル" label="キャンセル" x="20" y="800" width="388" height="50"/>');
+            (0, chai_1.expect)(yield heal('checkout.pay', 'accessibility id', cancel)).to.equal(null);
+        }));
+        it('heals a heal-written fingerprint from a debug build, which has no position', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            // A heal stores the element of the page source: on Android its rect is
+            // bounds, not x and y, so the id and the text are all there is.
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: { 'resource-id': 'com.shop.debug:id/pay', text: 'Pay now' },
+            };
+            const release = android('<android.widget.Button text="Pay" resource-id="com.shop:id/pay" bounds="[40,1200][340,1296]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop.debug:id/pay', 'id', release))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it('heals a heal-written fingerprint whose id was renamed outright and kept its text', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            // No position: the score rests on the type, the text and the id. An id
+            // of the same app still earns a share of its weight, as through 2.14.
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: { 'resource-id': 'com.shop:id/pay', text: 'Pay now' },
+            };
+            const renamed = android('<android.widget.Button text="Pay now" resource-id="com.shop:id/btn_primary" bounds="[40,1200][340,1296]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop:id/pay', 'id', renamed))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it('reads the text of an element with no id where one with an id was, as on iOS', () => __awaiter(void 0, void 0, void 0, function* () {
+            var _a;
+            fingerprint = PAY;
+            const cancel = android('<android.widget.Button text="Cancel order" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/pay', 'id', cancel)).to.equal(null);
+            const idDropped = android('<android.widget.Button text="Pay now" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)((_a = (yield heal('com.shop:id/pay', 'id', idDropped))) === null || _a === void 0 ? void 0 : _a.id).to.equal('healed-1');
+        }));
+        it('takes an id that merely contains the old one for another element', () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: Object.assign({ 'resource-id': 'com.social:id/follow', text: 'Follow' }, AT_PAY),
+            };
+            const unfollow = android('<android.widget.Button text="Unfollow" resource-id="com.social:id/unfollow" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.social:id/follow', 'id', unfollow)).to.equal(null);
+        }));
+        it('takes "null" for nothing, as UiAutomator2 answers for an unset attribute', () => __awaiter(void 0, void 0, void 0, function* () {
+            fingerprint = {
+                nodeName: 'android.widget.ImageView',
+                attributes: Object.assign({ 'resource-id': 'null', 'content-desc': 'null', hint: 'null' }, AT_PAY),
+            };
+            const other = android('<android.widget.ImageView content-desc="Delete account" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/avatar', 'id', other)).to.equal(null);
+        }));
+        it("doesn't heal by position with a fingerprint that says nothing about the element", () => __awaiter(void 0, void 0, void 0, function* () {
+            // As every fingerprint learnt through 2.14 was.
+            fingerprint = {
+                nodeName: 'android.widget.Button',
+                attributes: { x: '40', y: '900', width: '300', height: '96' },
+            };
+            const cancel = android('<android.widget.Button text="Cancel order" resource-id="com.shop:id/cancel" bounds="[40,900][340,996]"/>');
+            (0, chai_1.expect)(yield heal('com.shop:id/pay', 'id', cancel)).to.equal(null);
+        }));
+    });
+    describe('comparing names', () => {
+        it('reads a resource-id without its package', () => {
+            (0, chai_1.expect)((0, fingerprintIdentity_1.resourceIdName)('com.shop:id/pay')).to.equal('pay');
+            (0, chai_1.expect)((0, fingerprintIdentity_1.resourceIdName)('com.shop.debug:id/pay_button')).to.equal('pay_button');
+            (0, chai_1.expect)((0, fingerprintIdentity_1.resourceIdName)('pay')).to.equal('pay');
+        });
+        it('takes identifiers with the same words for the same', () => {
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('btn-pay', 'pay_btn')).to.equal(true);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('payButton', 'pay_button')).to.equal(true);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('Checkout.Pay', 'checkout_pay')).to.equal(true);
+            // camelCase and accents in any script.
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('оплатаКнопка', 'оплата_кнопка')).to.equal(true);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('cafe\u0301.order', 'caf\u00e9_order')).to.equal(true);
+            // Neither has a letter or digit: nothing to tell them apart by.
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('___', '..')).to.equal(true);
+        });
+        it('takes any other identifier for another element', () => {
+            // Words added: the text decides (pay_later, undo_delete).
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('pay', 'checkout_pay')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('delete', 'undo_delete')).to.equal(false);
+            // In any script.
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('支払う', 'キャンセル')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('oplata', 'оплата')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('checkout.pay', '___')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('follow', 'unfollow')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('pay', 'paypal')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('ok', 'book')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameIdentifier)('checkout.cancel', 'checkout.pay')).to.equal(false);
+        });
+        it('takes texts as the same only when they read the same', () => {
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('Pay now', '  pay NOW!')).to.equal(true);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('Log in', 'Log out')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('Enable', 'Disable')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('X', 'Exit')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)(' ', 'Anything')).to.equal(false);
+        });
+        it('keeps the marks that make a word another word, and composes accents first', () => {
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('भुगतान दें', 'भुगतान दो')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('ยกเลิก', 'ยกเล็ก')).to.equal(false);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.sameText)('caf\u0065\u0301', 'caf\u00e9')).to.equal(true);
+        });
+        it('asks each platform for the attributes its driver has', () => {
+            (0, chai_1.expect)((0, fingerprintIdentity_1.attributesToLearn)('Android')).to.deep.equal([
+                'resource-id',
+                'content-desc',
+                'text',
+                'hint',
+            ]);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.attributesToLearn)('iOS')).to.deep.equal(['name', 'label']);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.attributesToLearn)('tvOS')).to.deep.equal(['name', 'label']);
+            (0, chai_1.expect)((0, fingerprintIdentity_1.attributesToLearn)('mac')).to.deep.equal([
+                'resource-id',
+                'content-desc',
+                'text',
+                'hint',
+                'name',
+                'label',
+            ]);
+        });
+    });
+});

package/lib/test/unit/h264-multiplexer.spec.js

@@ -58,4 +58,50 @@ describe('H264Multiplexer', () => {
         (0, chai_1.expect)(m.clientCount).to.equal(0);
         (0, chai_1.expect)(got).to.deep.equal(['config']);
     });
+    // The H.264 service ends a capture the moment its last viewer leaves when a
+    // page has asked for MJPEG (AndroidH264StreamService.endWhenUnwatched).
+    it('tells its listener when the last client leaves, once', () => {
+        const m = new H264Multiplexer_1.H264Multiplexer();
+        let emptied = 0;
+        m.onEmpty(() => (emptied += 1));
+        const removeA = m.addClient(() => undefined);
+        const removeB = m.addClient(() => undefined);
+        removeA();
+        (0, chai_1.expect)(emptied, 'one viewer is still watching').to.equal(0);
+        removeB();
+        (0, chai_1.expect)(emptied).to.equal(1);
+        // A socket's close and error both remove the same client.
+        removeB();
+        (0, chai_1.expect)(emptied).to.equal(1);
+    });
+    // A capture stopped under its viewers (a recording starting, a stream/stop)
+    // left their sockets open with no frames: the picture froze on its last
+    // frame and the page never fell back to MJPEG.
+    it('close() tells every client its stream ended, and delivers nothing more', () => {
+        const m = new H264Multiplexer_1.H264Multiplexer();
+        const got = [];
+        const ended = [];
+        let emptied = 0;
+        m.onEmpty(() => (emptied += 1));
+        const removeA = m.addClient((p) => got.push(p.type), () => ended.push('a'));
+        m.addClient(() => undefined, () => ended.push('b'));
+        m.close();
+        m.push(P('key', 1));
+        removeA(); // the socket's own close, afterwards
+        (0, chai_1.expect)(ended).to.deep.equal(['a', 'b']);
+        (0, chai_1.expect)(got).to.deep.equal([]);
+        (0, chai_1.expect)(m.clientCount).to.equal(0);
+        (0, chai_1.expect)(emptied, 'a closed stream is not an unwatched one').to.equal(0);
+    });
+    it('ends a client that joins after close() at once', () => {
+        const m = new H264Multiplexer_1.H264Multiplexer();
+        m.setConfig(P('config', 0));
+        m.close();
+        const got = [];
+        let ended = 0;
+        m.addClient((p) => got.push(p.type), () => (ended += 1));
+        (0, chai_1.expect)(ended).to.equal(1);
+        (0, chai_1.expect)(got).to.deep.equal([]);
+        (0, chai_1.expect)(m.clientCount).to.equal(0);
+    });
 });

package/lib/test/unit/heal-report.spec.js

@@ -0,0 +1,71 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const http_1 = __importDefault(require("http"));
+const healReport_1 = require("../../src/gateway/healReport");
+/**
+ * How a node hands a heal back to its hub on the answer to the hub's command
+ * (healReport.ts): what goes on the answer, and what the hub accepts off it.
+ */
+describe('A heal reported to the hub', () => {
+    const answer = () => new http_1.default.ServerResponse(new http_1.default.IncomingMessage(null));
+    const heal = (selector) => ({
+        originalSelector: selector,
+        originalStrategy: 'xpath',
+        healedSelector: "//*[@text='Anmelden']",
+        healedStrategy: 'xpath',
+        confidence: 0.82,
+        tier: 2,
+    });
+    it('goes on the answer and comes off it whole, whatever its characters', () => {
+        const res = answer();
+        const sent = heal("//*[@text='Ünïcödé “quotes”']");
+        (0, chai_1.expect)((0, healReport_1.runReportingHeals)(res, () => (0, healReport_1.reportHeal)(sent))).to.equal('reported');
+        const headers = { [healReport_1.HEAL_REPORT_HEADER]: String(res.getHeader(healReport_1.HEAL_REPORT_HEADER)) };
+        (0, chai_1.expect)((0, healReport_1.takeHealReport)(headers)).to.deep.equal(sent);
+        (0, chai_1.expect)(headers, 'taken off the headers').to.not.have.property(healReport_1.HEAL_REPORT_HEADER);
+    });
+    it('is not sent for a command that did not come from a hub', () => {
+        (0, chai_1.expect)((0, healReport_1.reportHeal)(heal('//a'))).to.equal('not-from-hub');
+    });
+    it('is not sent when too long for the hub to read, so the command still answers', () => {
+        const res = answer();
+        const reported = (0, healReport_1.runReportingHeals)(res, () => (0, healReport_1.reportHeal)(heal(`//${'x'.repeat(10000)}`)));
+        (0, chai_1.expect)(reported).to.equal('too-long');
+        (0, chai_1.expect)(res.getHeader(healReport_1.HEAL_REPORT_HEADER)).to.equal(undefined);
+    });
+    it('is not put on an answer that has closed, by work the command left running', () => __awaiter(void 0, void 0, void 0, function* () {
+        const res = answer();
+        let release;
+        const gate = new Promise((resolve) => (release = resolve));
+        // Async work started during the command keeps its context after it.
+        const lingering = (0, healReport_1.runReportingHeals)(res, () => __awaiter(void 0, void 0, void 0, function* () {
+            yield gate;
+            return (0, healReport_1.reportHeal)(heal('//late'));
+        }));
+        res.emit('close');
+        release();
+        (0, chai_1.expect)(yield lingering).to.equal('not-from-hub');
+    }));
+    it('is ignored when it is not one', () => {
+        const notJson = { [healReport_1.HEAL_REPORT_HEADER]: 'not base64 json' };
+        const notAHeal = {
+            [healReport_1.HEAL_REPORT_HEADER]: Buffer.from('{"originalSelector":1}').toString('base64url'),
+        };
+        (0, chai_1.expect)((0, healReport_1.takeHealReport)(notJson)).to.equal(undefined);
+        (0, chai_1.expect)((0, healReport_1.takeHealReport)(notAHeal)).to.equal(undefined);
+        (0, chai_1.expect)((0, healReport_1.takeHealReport)({})).to.equal(undefined);
+    });
+});

package/lib/test/unit/healing-instrumentation.spec.js

@@ -187,7 +187,11 @@ describe('HealingOrchestrator instrumentation', () => {
         (0, chai_1.expect)(mockSpan.end.calledOnce).to.equal(true);
     }));
     it('marks span ERROR and ends on context-collection failure (driver throws)', () => __awaiter(void 0, void 0, void 0, function* () {
-        const orch = makeOrchestratorWithProviders([]);
+        // A tier to run, or nothing is collected at all; it never runs here.
+        const heal = sinon_1.default.stub().resolves(null);
+        const orch = makeOrchestratorWithProviders([
+            { name: 'p1', tier: types_1.HealingTier.TIER_1_RECOVERY, heal },
+        ]);
         const driver = {
             getPageSource: () => __awaiter(void 0, void 0, void 0, function* () {
                 throw new Error('disconnected');
@@ -198,6 +202,7 @@ describe('HealingOrchestrator instrumentation', () => {
         (0, chai_1.expect)(result).to.equal(null);
         (0, chai_1.expect)(mockSpan.addEvent.calledWith('context_collection_failed')).to.equal(true);
         (0, chai_1.expect)(mockSpan.end.calledOnce).to.equal(true);
+        (0, chai_1.expect)(heal.called).to.equal(false);
     }));
     it('does not put the original selector text on span attributes (cardinality discipline)', () => __awaiter(void 0, void 0, void 0, function* () {
         const provider = {