HTML-Module
Der Ordner Engines->Html in der Standard-Untermenge enthält Module, die bestimmte Aufgaben für die XBrowser Engine 3.0 ausführen.
Der Ordner Html enthält auch Unterordner mit zusätzlichen Modulen:
Barrierefreiheit von Webseiten überprüfen
Mit dem Modul Check Webpage Accessibility können Sie testen, wie benutzerfreundlich Ihre Webseite ist. Hier erfahren Sie, wie es verwendet wird: Testen der Barrierefreiheit im Internet.
Das Modul hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Sie können auch einen Platzhalter * hinzufügen. Wenn Sie möchten, dass die XBrowser Engine 3.0 die einzige geöffnete Registerkarte in Ihrem Browserfenster verwendet, geben Sie * ein. |
|
Url |
URL der Seite, die Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Fenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem geöffneten Browserfenster mit einem Title, der mit Tricentis beginnt, https://support-hub.tricentis.com/ als URL und einem Window Index von 2. Sobald sie das richtige Browserfenster gefunden hat, führt die XBrowser Engine 3.0 eine Barrierefreiheitsanalyse durch.
Beispiel – Test für Barrierefreiheit im Internet basierend auf den Modulattributen des Moduls Check Webpage Accessibility |
Execute JavaScript
Das Modul Execute JavaScript ermöglicht es Ihnen, JavaScript-Aufrufe auf Webseiten auszuführen.
Es besitzt die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Geben Sie für eine Übereinstimmung mit einem beliebigen Titel einen *-Wert an. Wenn Sie beispielsweise möchten, dass die XBrowser Engine 3.0 die einzige in Ihrem Browserfenster geöffnete Registerkarte findet und verwendet, geben Sie * ein. |
|
Url |
URL des Browserfensters, das Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Browserfenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
JavaScript |
Return-Anweisung, die Sie ausführen möchten. Wenn die Zeichenfolge doppelte Anführungszeichen " enthält, müssen Sie die Zeichenfolge mit zwei zusätzlichen Paaren von Anführungszeichen maskieren. Zum Beispiel: window.location.href="""http://support.tricentis.com""" |
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem geöffneten Browserfenster mit einem Title, der mit Tricentis beginnt, https://support-hub.tricentis.com/ als URL und einem Window Index von 2. Sobald sie das richtige Browserfenster gefunden hat, leitet sie es an https://support-hub.tricentis.com/open weiter.
Beispiel - Execute JavaScript |
Verify JavaScript Result
Das Modul Verify JavaScript Result ermöglicht es Ihnen, das Ergebnis eines JavaScript-Aufrufs zu überprüfen. So können Sie beispielsweise die Werte von Browser-Cookies und JavaScript-Variablen abrufen und überprüfen.
Es besitzt die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Geben Sie für eine Übereinstimmung mit einem beliebigen Titel einen *-Wert an. Wenn Sie beispielsweise möchten, dass die XBrowser Engine 3.0 die einzige in Ihrem Browserfenster geöffnete Registerkarte findet und verwendet, geben Sie * ein. |
|
Url |
URL des Browserfensters, das Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Browserfenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
JavaScript |
Geben Sie return und die JavaScript-Anweisung ein, deren Ergebnis Sie überprüfen möchten. Wenn die Zeichenfolge doppelte Anführungszeichen " enthält, müssen Sie die Zeichenfolge mit zwei zusätzlichen Paaren von Anführungszeichen maskieren. Zum Beispiel: document.cookie |
|
Result |
Der erwartete Rückgabewert des JavaScript-Aufrufs. |
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem spezifischen Browserfenster, das die folgenden Kriterien erfüllt:
Einmal gefunden, ruft es die Cookies ab und überprüft, ob der zurückgegebene Wert username-Jane Doe; language=en-US lautet.
Beispiel - JavaScript-Ergebnis überprüfen |
OpenUrl
Das Modul OpenUrl ermöglicht es Ihnen, Webseiten in einem Browser zu öffnen.
Es besitzt die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Url |
URL, die Sie öffnen möchten. Wenn Sie den Browser angeben möchten, verwenden Sie den Testkonfigurationsparameter Browser (siehe Kapitel "Browser angeben"). |
|
UseActiveTab |
Definiert, ob der Tosca Commander nach einem offenen Browserfenster sucht, um eine URL in der aktiven Registerkarte dieses Fensters zu öffnen. Auf True gesetzt, verhält sich der Tosca Commander wie folgt:
Ist dies auf False gesetzt oder leer, verhält sich der Tosca Commander wie folgt:
Wenn Sie Ihren Testfall über WebDriver ausführen, hat diese Einstellung keine Auswirkungen. |
|
Befehlszeilenargumente zum Starten Ihres Browsers. Wenn Sie mehrere Argumente verwenden möchten, geben Sie jedes Argument in einen separaten Testschrittwert ein. Beachten Sie, dass die Argumente für jeden Browser unterschiedlich sind. |
|
Die XBrowser Engine 3.0 überprüft nicht, ob die von Ihnen angegebene URL zugänglich ist. Selbst wenn die URL nicht erreichbar ist, wird der Testschritt durchlaufen. |
|
In diesem Beispiel öffnen Sie die URL https://support.tricentis.com in Chrome.
Webseite öffnen |
Open embedded Chrome/Chromium application
Das Modul Open embedded Chrome/Chromium application ermöglicht es Ihnen, Applikationen zu öffnen, die Chrome oder Chromium mit WebDriver einbetten.
Für Informationen zur Steuerung dieser Applikationen siehe Kapitel " Eingebettetes Chrome oder Chromium automatisieren".
|
Die XBrowser Engine 3.0 unterstützt nur die lokale Ausführung über WebDriver. |
Das Modul hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Application Path |
Vollständiger Pfad zur Applikation, die Sie steuern möchten, einschließlich Dateiname und -endung. |
|
Window Classname |
Klassenname des Hauptapplikationsfensters. Dieses Modulattribut ist optional. Es beschleunigt die Suche nach dem Applikationsfenster. |
|
WebDriver Server Path |
Pfad zur chromedriver.exe, die Sie verwenden möchten. Dieses Modulattribut ist optional. Wenn Sie keinen Pfad angeben, verwendet die XBrowser Engine 3.0 den Standardserver. |
|
Url |
URL, die Sie nach dem Öffnen der Applikation anzeigen möchten. Dieses Modulattribut ist optional. |
|
Arguments |
Schreibgeschützt. Sie können hier nichts eingeben. |
|
Arguments->Argument |
Argument, das Sie an die Applikation übertragen möchten. Dieses Modulattribut ist optional. |
|
Dieses Beispiel zeigt, wie Sie eine eingebettete Chromium-Applikation öffnen. Die untenstehende XBrowser Engine 3.0 führt die folgenden Aktionen durch:
Chromium-Applikation öffnen |
ClickOnScreen
Das Modul ClickOnScreen ermöglicht es Ihnen, auf eine bestimmte Position in Ihrer Browserregisterkarte zu klicken (siehe Kapitel " Auf eine Bildschirmposition des Browsers klicken").
Es besitzt die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Caption |
Titel der Registerkarte, auf der Sie den Klick ausführen möchten. |
|
X |
Geben Sie die X-Koordinate in Prozent an. Der ganz linke Wert ist 0 und der ganz rechte Wert ist 100. |
|
Y |
Geben Sie die Y-Koordinate in Prozent an. Der oberste Wert ist 0 und der unterste Wert ist 100. |
|
In diesem Beispiel führt die XBrowser Engine 3.0 die folgenden Aktionen durch:
Eine bestimmte Bildschirmposition anklicken |
CloseBrowser
Das Modul CloseBrowser ermöglicht es Ihnen, Registerkarten in Ihrem Browser zu schließen.
Es hat das folgende Modulattribut:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel der Registerkarte, die Sie schließen möchten. Sie können Platzhalter verwenden. Wenn Sie die Registerkarte in mehreren Browsern geöffnet haben, sie aber nur in einem Browser schließen möchten, verwenden Sie den Testkonfigurationsparameter Browser (siehe Kapitel "Browser angeben"). Wenn Sie WebDriver verwenden, schließen Sie mit dem Testkonfigurationsparameter HubAddress nur die Reiter, die für die angegebene WebDriver-Hub-Adresse geöffnet sind. |
|
Dieses Beispiel zeigt, wie Sie eine Browserregisterkarte schließen. Diese Browserregisterkarte hat den Titel Tricentis Vehicle Insurance. Anstatt den gesamten Titel einzugeben, verwenden Sie einen Platzhalter.
Browserregisterkarte schließen Da Sie die Registerkarte nur in Chrome schließen möchten, legen Sie den Testkonfigurationsparameter Browser mit dem Wert Chrome für Ihren Testfall an.
Geben Sie an, in welchem Browser Sie den Reiter schließen möchten |
Connect to Chrome/Chromium application
Das Modul Connect to Chrome/Chromium application ermöglicht es Ihnen, eine Verbindung zu Applikationen herzustellen, die Chrome oder Chromium mit WebDriver einbetten.
Für Informationen zur Steuerung dieser Applikationen siehe Kapitel " Eingebettetes Chrome oder Chromium automatisieren".
|
Die XBrowser Engine 3.0 unterstützt nur die lokale Ausführung über WebDriver. |
Das Modul hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Debug Port |
Debug-Port, unter dem die Applikation läuft. |
|
WebDriver Server Path |
Pfad zur chromedriver.exe, die Sie verwenden möchten. Dieses Modulattribut ist optional. Wenn Sie keinen Pfad angeben, verwendet die XBrowser Engine 3.0 den Standardserver. |
|
Window Classname |
Klassenname des Hauptapplikationsfensters. Dieses Modulattribut ist optional. Es beschleunigt die Suche nach dem Applikationsfenster. |
|
In diesem Beispiel stellen Sie eine Verbindung zu einer eingebetteten Chromium-Applikation her. Die XBrowser Engine 3.0 führt die folgenden Aktionen durch:
Mit Chrome/Chromium-Applikation verbinden |
HTML-Log-Überwachung starten
Mit dem Modul Start HTML Log Monitoring können Sie die Verfolgung entweder der Konsolen-Logs oder der Netzwerk-Logs starten. Sie können dieses Feature beim Debuggen Ihrer Applikation verwenden.
|
|
Dieses Modul unterstützt nur die Browser Google Chrome und Microsoft Edge. Um Ihre Applikation über den XBrowser zu steuern, müssen sich sowohl das Modul HTML-Log-Überwachung starten als auch HTML-Log-Überwachung stoppen im selben Testfall befinden. |
Das Modul hat folgende Attribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Geben Sie für eine Übereinstimmung mit einem beliebigen Titel einen *-Wert an. Wenn Sie beispielsweise möchten, dass die XBrowser Engine 3.0 die einzige in Ihrem Browserfenster geöffnete Registerkarte findet und verwendet, geben Sie * ein. |
|
Url |
URL des Browserfensters, das Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Browserfenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
Log Type |
Art der Log-Überwachung, die auf der Seite durchgeführt werden soll, die Sie steuern möchten. Geben Sie einen dieser Werte an:
|
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
Darüber hinaus müssen Sie für Ausführungen über eine Selenium Grid-Serverversion, die älter als 4.8.2 ist, den Browser mit einem zusätzlichen Argument starten: --remote-allow-origins=*.
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem spezifischen Browserfenster, das die folgenden Kriterien erfüllt:
Einmal gefunden, startet sie ihre Console-Log-Überwachung.
Beispiel – HTML-Log-Überwachung starten |
HTML-Log-Überwachung stoppen
Das Modul Stop HTML Log Monitoring ermöglicht es Ihnen, die Verfolgung entweder der Console-Logs oder der Network-Logs, die Sie zuvor gestartet haben, zu stoppen und die Überwachungsdaten abzurufen. Sie können dieses Feature beim Debuggen Ihrer Applikation verwenden.
|
|
Dieses Modul unterstützt nur die Browser Google Chrome und Microsoft Edge. Um Ihre Applikation über den XBrowser zu steuern, müssen sich sowohl das Modul HTML-Log-Überwachung starten als auch HTML-Log-Überwachung stoppen im selben Testfall befinden. |
Das Modul hat folgende Attribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Geben Sie für eine Übereinstimmung mit einem beliebigen Titel einen *-Wert an. Wenn Sie beispielsweise möchten, dass die XBrowser Engine 3.0 die einzige in Ihrem Browserfenster geöffnete Registerkarte findet und verwendet, geben Sie * ein. |
|
Url |
URL des Browserfensters, das Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Browserfenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
Log Type |
Art der Log-Überwachung, die auf der Seite durchgeführt werden soll, die Sie steuern möchten. Geben Sie einen dieser Werte an:
|
|
Log File Path |
Speicherort, an dem Sie Reportdateien mit den Log-Einträgen speichern möchten, die zwischen den Start- und den Stopp-Aufgaben aufgetreten sind. Dieses Modulattribut generiert verschiedene Log-Dateien basierend auf dem Log Type:
Geben Sie den Ordnerpfad an. |
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
Darüber hinaus müssen Sie für Ausführungen über eine Selenium Grid-Serverversion, die älter als 4.8.2 ist, den Browser mit einem zusätzlichen Argument starten: --remote-allow-origins=*.
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem spezifischen Browserfenster, das die folgenden Kriterien erfüllt:
Einmal gefunden, stoppt sie ihre Console-Log-Überwachung und speichert die Report-Log-Datei in %TEMP%\NetworkLog.txt.
Beispiel – HTML-Log-Überwachung stoppen |
Dialogfenster steuern
Das Modul Steer Dialog Box ermöglicht es Ihnen, JavaScript-Dialogfenster in Ihrer Applikation zu steuern, was Ihre Testgenauigkeit erhöht. Hier erfahren Sie, wie dieses Modul verwendet wird: JavaScript-Dialogfenster steuern.
|
|
Sie können dieses Modul über den XBrowser nur mit den Browsern Google Chrome oder Microsoft Edge verwenden. |
Das Modul hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title |
Titel des Browserfensters, das Sie steuern möchten. Geben Sie für eine Übereinstimmung mit einem beliebigen Titel einen *-Wert an. Wenn Sie beispielsweise möchten, dass die XBrowser Engine 3.0 die einzige in Ihrem Browserfenster geöffnete Registerkarte findet und verwendet, geben Sie * ein. |
|
Url |
URL des Browserfensters, das Sie steuern möchten. Zum Beispiel: http://support.tricentis.com |
|
Window Index |
Index des Browserfensters, das Sie steuern möchten, falls mehrere Browserfenster den vorherigen Kriterien entsprechen. Geben Sie einen dieser Werte an:
|
|
Confirmation |
Die Antwort, die Sie an einen Bestätigungsdialog senden möchten. Geben Sie einen dieser Werte an:
|
|
PromptText |
Der Text, den Sie in das Texteingabefeld eines Eingabeaufforderungsdialogs eingeben möchten. Beachten Sie, dass dieses Modulattribut nur mit der Aktion Input funktioniert. |
|
Sie müssen mindestens eines der Search Criteria angeben: Title, Url oder Window Index. |
|
In diesem Beispiel sucht die XBrowser Engine 3.0 nach dem spezifischen Browserfenster, das die folgenden Kriterien erfüllt:
Sobald die XBrowser Engine 3.0 das Browserfenster gefunden hat, gibt sie den Text Tricentis Tosca in das Texteingabefeld des Eingabeaufforderungsdialogs ein und wählt OK aus.
Beispiel – Dialogfenster steuern |
Check Webpage for Broken Links
Mit dem Modul Check Webpage for Broken Links können Sie nach Links suchen, die Client-Fehlerantworten (400-499) oder Server-Fehlerantworten (500-599) zurückgeben. Auf diese Weise können Sie beispielsweise überprüfen, ob sich auf einer Webseite fehlerhafte Links befinden.
Beachten Sie, dass Tricentis Tosca mit einer vorhandenen Browser-Session arbeiten muss, um eine Überprüfung auf Fehlerantworten durchzuführen. Dies bedeutet, dass die Webseite, die die zu überprüfenden Links enthält, zum Zeitpunkt der Überprüfung geöffnet sein muss.
Das Modul hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title* |
Identifiziert die Webseite, die die zu überprüfenden Links enthält, anhand des HTML-Titels der Seite. Sie können Platzhalter verwenden. Um beispielsweise die einzige geöffnete Registerkarte in Ihrem Browserfenster zu verwenden, geben Sie * ein. |
|
URL* |
Identifiziert die Webseite, die die zu überprüfenden Links enthält, indem die URL der aktuell geöffneten Seite verwendet wird. Zum Beispiel: http://support.tricentis.com |
|
Window Index* |
Identifiziert die Webseite, die die zu überprüfenden Links enthält, anhand des Index des Browserfensters, das sie überprüfen möchten. Geben Sie einen dieser Werte ein:
|
|
Ignore Errors |
Fehlercode, den Sie in Ihrem Test ignorieren möchten. Geben Sie z. B. 403 ein, um alle Links mit einer Antwort „Zugriff verweigert“ zu ignorieren. |
|
*Sie müssen mindestens einen dieser Werte in Ihrem Testfall angeben, damit Tricentis Tosca das richtige Browserfenster finden kann. Wenn Sie mehrere Browserfenster mit denselben oder sehr ähnlichen Bezeichnern haben, verwenden Sie mehr als einen dieser Werte in Ihrem Testfall. |
|
|
In diesem Beispiel untersucht der Testfall die Seite unter http://myapplication.tricentis.com auf fehlerhafte Links. Er prüft auf alle Fehlerarten außer 403-Fehler.
Beispiel – Prüfung auf Fehlerantworten Sobald er das Fenster gefunden hat, überprüft er alle Links auf dieser Webseite auf Fehlerantworten:
Beispiel für Link-Überprüfung in Tricentis Tosca |
Web-QR/Barcode lesen
Mit dem Modul Read Web QR/Barcode können Sie QR-Codes oder Barcodes in einem Browser überprüfen oder in den Buffer schreiben.
Beachten Sie, dass die Webseite, die die QR-Codes oder Barcodes enthält, die Sie lesen möchten, geöffnet sein muss, wenn Sie Ihren Test ausführen.
Das Modul Read Web QR/Barcode hat die folgenden Modulattribute:
|
Modulattribut |
Beschreibung |
|---|---|
|
Title* |
Geben Sie den HTML-Titel der Webseite ein, die die QR-Codes oder Barcodes enthält, die Sie überprüfen oder in den Buffer schreiben möchten. Sie können Platzhalter verwenden. Um beispielsweise die einzige geöffnete Registerkarte in Ihrem Browserfenster zu verwenden, geben Sie * ein. |
|
URL* |
Geben Sie die URL der aktuell geöffneten Webseite ein, die die QR-Codes oder Barcodes enthält, die Sie überprüfen oder in den Buffer schreiben möchten. |
|
Window Index* |
Geben Sie den Index des Browserfensters ein, das die QR-Codes oder Barcodes enthält, die Sie überprüfen oder in den Buffer schreiben möchten. Sie können jeden der folgenden Werte verwenden:
|
|
Type |
Wählen Sie die Art des Codes aus, den Sie überprüfen oder in den Buffer schreiben möchten. Sie können jeden der folgenden Werte verwenden:
|
|
Index |
Geben Sie die Indexposition der QR-Codes oder Barcodes ein, den Sie überprüfen oder in den Buffer schreiben möchten. Geben Sie z. B. 5 ein, um den fünften QR-Code auf der Seite anzugeben. Um alle QR-Codes und Barcodes auf einer Seite zu überprüfen oder in den Buffer zu schreiben, lassen Sie Index leer. |
|
Value |
Um QR-Codes oder Barcodes zu überprüfen, geben Sie die zu überprüfenden erwarteten Werte ein. Wählen Sie dann die Aktion Verify aus. Geben Sie einen Namen für Ihren neuen Buffer ein, um QR-Codes oder Barcodes in den Buffer zu schreiben. Wählen Sie dann die Aktion Buffer aus. |
|
*Sie müssen mindestens einen dieser Werte in Ihrem Testfall angeben, damit Tosca das richtige Browserfenster finden kann. Wenn Sie mehrere Browserfenster mit denselben oder sehr ähnlichen Bezeichnern haben, verwenden Sie mehr als einen dieser Werte in Ihrem Testfall. |
|
|
In diesem Beispiel überprüft der Testfall den ersten QR-Code unter https://www.example.com/signup. Er liest den QR-Code und überprüft, ob er den Wert https://www.example.com/download enthält.
Web-QR-Code überprüfen |