52.2

Das webResolvers-Modul

4.2+In den meisten Fällen kann man die Komponenten-Erkennung von QF-Test am besten mit einem klassischen Resolver anpassen, wie im letzen Kapitel Abschnitt 52.1 beschrieben. Wenn der Resolver jedoch für ein Web-Projekt verwendet wird und stark mit dem Browser interagiert, dann bietet sich mit dem webResolvers-Modul die Möglichkeit, den Resolver-Code direkt im Browser auszuführen.

52.2.1

Allgemeine Informationen

Hinweis QF-Test speichert den aktuellen Zustand der Webseite, die aktuell im Browser angezeigt wird, in einem lokalen Cache. Die meisten Methoden, die üblicherweise in einem Resolver verwendet werden, können von QF-Test mit Hilfe dieses Caches ausgeführt werden. Dies führt zu einer wesentlichen Steigerung der Ausführungs-Geschwindigkeit. Resolver, die mit dem webResolvers-Modul registriert werden, kommen immer direkt im Browser zur Ausführung, wodurch die Komponenten-Erkennung verlangsamt werden kann. Allerdings ist es sinnvoll, resolver mit dem webResolvers-Modul zu registrieren, wenn diese grundsätzlich stark auf Browser-Funktionen angewiesen sind, d.h. wenn sie auf Aufrufen der Methoden getAttributeIfSpecified oder evalJS(...) basieren.

Die API des webResolvers-Moduls imitiert diejenige des resolvers-Moduls. Daher haben die vorhandenen Methoden dieselben Namen und werden auch genauso verwendet wie die im letzen Kapitel vorgestellten Methoden. Der wesentliche Unterschied besteht bei der Definition des Resolver-Algorithmus: Hier werden immer JavaScript-Methoden (eingepackt in Strings) erwartet, die dann direkt im Browser ausgeführt werden. Dort erhalten Sie dann auch Browser- und JavaScript-Objekte als Argumente.

HinweisWenn das SUT-Skript, in welchem die Resolver registriert werden, selbst bereits in JavaScript geschrieben ist, so kann man als Argument auch direkt Funktionen angeben. Diese werden dann beim Aufruf in Strings umgewandelt und so im Browser registriert. Da sie dann aber im Browser-Kontext (und nicht in der SUT-Skript-Umgebung von QF-Test) ausgeführt werden, können keine Daten über gemeinsame Variablen zwischen dem registrierenden Skript und der Resolver-Funktion ausgetauscht werden

Das webResolvers-Modul beschränkt sich auf diese Resolver-Typen:

• NameResolver, wie in Abschnitt 52.1.7 beschrieben
• ClassNameResolver, wie in Abschnitt 52.1.9 beschrieben
• GenericClassNameResolver, wie in Abschnitt 52.1.8 beschrieben
• FeatureResolver, wie in Abschnitt 52.1.10 beschrieben
• ExtraFeatureResolver, wie in Abschnitt 52.1.11 beschrieben
• ItemNameResolver, wie in Abschnitt 52.1.12 beschrieben
• ItemValueResolver, wie in Abschnitt 52.1.13 beschrieben
• InterestingParentResolver, wie in Abschnitt 52.1.15 beschrieben
• TooltipResolver, wie in Abschnitt 52.1.16 beschrieben
• IdResolver, wie in Abschnitt 52.1.17 beschrieben
• EnabledResolver, wie in Abschnitt 52.1.18 beschrieben
• VisibilityResolver, wie in Abschnitt 52.1.19 beschrieben
• MainTextResolver, wie in Abschnitt 52.1.20 beschrieben
• WholeTextResolver, wie in Abschnitt 52.1.21 beschrieben
• BusyApplicationDetector, wie in Abschnitt 52.1.25 beschrieben
• ExtraFeatureMatcher, wie in Abschnitt 52.1.26.1 beschrieben

52.2.2

addResolver

Die generische Methode addResolver ist zentral für das webResolvers-Module. Sie registriert einen neuen Resolver. Der Typ wird dabei bestimmt anhand des Namens der JavaScript-Funktion (welcher nicht immer identisch mit dem Name der Variable, in der die Funktion gespeichert wurde) und der Anzahl der von ihr spezifierten Argumente.

52.2.3

removeResolver

Die über das webResolvers Modul registrierten Resolver können mittels der Funktion removeResolver deregistriert werden.

Im Beispiel wird zunächst ein unter dem Namen "myName" registrierter Resolver entfernt, danach alle über das webResolvers-Modul registrierten Resolver.

webResolvers.removeResolver("myName")
webResolvers.removeAll()

52.2.4

listNames

Gibt eine Liste der Namen der Resolver zurück, die über das webResolvers Modul registriert wurden.

Im Beispiel wird überprüft, ob ein spezifischer Resolver registriert wurde. Falls nicht wird dem Protokoll eine Fehlermeldung hinzugefügt.

if (! webResolvers.listNames().contains("specialNames")) {
    rc.logError("Special names resolver not registered!")
}

52.2.5

Beispiele

Die Benutzung der webResolver ist identisch zu Resolvern, welche über das resolvers-Modul registriert werden. Daher wird hier auf eine ausführliche Beschreibung der Resolver selbst und ihrer Funktionalität verzichtet und auf das vorangehende Kapitel verwiesen. Statt dessen wird hier durch ausgewählte Beispiele die Anwendung des webResolvers-Moduls dargestellt:

getNameFunc = """
function getName(node, name) {
    if (! name) return node.getAttribute("__name__");
}
"""

webResolvers.addResolver("myNames", getNameFunc, "DIV")

def getFeatureFunc = """
function getFeature(node, feature) {
    try {
        var title = node.firstChild.textContent;
        if (title) return title;
    } catch (e) {}
}
"""

webResolvers.addResolver("paneltitle", getFeatureFunc, "Panel")

function getExtraFeatures(node, features) {
    try {
        const myId = node.getAttribute("myId");
        if (myId) {
            features.add(ExtraFeature.STATE_MUST_MATCH,"myId", myId);
            return features;
        }
    } catch (e) {}
}

webResolvers.addResolver("myId", getExtraFeatures);

function getExtraFeatures(node, features) {
    const labelFeature == features.get("qfs:label");
    if (labelFeature && labelFeature.value == "bad name") {
        labelFeature.value = "good name";
        return features;
    }
}
webResolvers.addResolver("get label example", getExtraFeatures,"TextField");

getColumnIdFunc = """
function getColumnId(table, item, name) {
    var id;
    if (item[1] < 0 ) { // whole column addressed
        id = table.getElementsByTagName("TH")[0].id;
    }
    if (id) return id;
}
"""

webResolvers.addResolver("tableColumnId", getColumnIdFunc, "TableColumn")

def getTooltipFunc = """
function getTooltip(node, tooltip) {
    if (tooltip) {
        var userLang = navigator.language || navigator.userLanguage;
        if (userLang) {
            return tooltip + "-" + userLang;
        }
    }
}
"""

webResolvers.addResolver("tootip-lang", getTooltipFunc)

function isEnabled(node) {
    try {
        return ! node.className.split(' ').contains("v-disabled");
    } catch (e) {
        return true;
    }
}

webResolvers.addResolver("vEnabledResolver",isEnabledFunc);

function isVisible(element, visible) {
    const getOpacity = function(el) { // inner function, so it is part
                                           // of the registered resolver
        const style = window.getComputedStyle(el);
        const opacity = style.getPropertyValue("opacity")
        if (! opacity) return 1;
        return parseFloat(opacity);
    }
    return visible && getOpacity(element) > 0;
}

webResolvers.addResolver("opacityResolver",isVisible);

getMainTextFunc = """
function getMainText(element,text) {
    if (text) return text.replace("TO-DO","")
}
"""

webResolvers.addResolver("removeMarkFromText",getMainTextFunc)

function isBusy(element) {
    const overlay = element.getElementsByClassName("overlay")[0];
    return !!overlay;
}

webResolvers.addResolver("overlayBusyResolver",isBusy);

function applicationIsBusy() {
    const tasks = $specialFramework.waitingTasks();
    return tasks && tasks.length() > 0;
}

webResolvers.addResolver("taskChecker",applicationIsBusy);

function matchExtraFeature(element, name, value, regexp, negate) {
    if (name != "my:label") return;
    const label = element.getAttribute("my-label");
    var match = false;
    if (label) {
        if (regexp) {
           match = !! label.match(value);
        } else {
           match = (value == label);
        }
    }
    return negate ? ! match : match;
}

webResolvers.addResolver("myLabelResolver", matchExtraFeature)

function matchExtraFeature(element, name, value, regexp, negate) {
    const label = element.getAttribute("my-label");
    var match = false;
    if (label) {
        if (regexp) {
           match = !! label.match(value);
        } else {
           match = (value == label);
        }
    }
    return negate ? ! match : match;
}

webResolvers.addSpecificExtraFeatureMatcher("myLabelResolver",
                               matchExtraFeature, "my:label");

Letzte Änderung: 4.12.2023 Copyright © 1999-2023 Quality First Software GmbH