Selenium Kernerweiterungen (User-Extensions.js)

Selenium Kernerweiterungen

Um Erweiterungen zu verstehen, wollen wir zunächst die drei Säulen verstehen. Selenium IDEJeder Befehl, den Sie in der IDE aufzeichnen oder eingeben, gehört zu einer der drei unten aufgeführten Kategorien, und jeder Screenshot zeigt, wie diese Kategorie in der Befehlsliste der IDE dargestellt wird.

1. Aktion: Welche Operation führen Sie auf dem Benutzeroberflächenbildschirm aus?

   

2. Zugriffsmethoden / Behauptung: Welche Überprüfung führen Sie an den Daten durch, die Sie über die Benutzeroberfläche erhalten?

   

3. Standortstrategie: So finden Sie das Element in der Benutzeroberfläche.

   

Selenium Die IDE wird mit einer ausgereiften Bibliothek ausgeliefert, die bereits zahlreiche Aktionen, Zugriffsmethoden und Zusicherungen sowie Locator-Strategien enthält.

Manchmal benötigt ein Projekt jedoch Funktionen, die in dieser Bibliothek nicht enthalten sind. In diesem Fall können Sie die Bibliothek durch Hinzufügen einer eigenen benutzerdefinierten Erweiterung erweitern. Diese benutzerdefinierten Erweiterungen werden als Erweiterungen bezeichnet. Benutzererweiterung.

Angenommen, Sie benötigen eine Aktion, die Text in Großbuchstaben umwandelt, bevor er in ein Web-Element eingefügt wird. Da eine solche Aktion in der Standardbibliothek nicht vorhanden ist, erstellen Sie eine eigene Benutzererweiterung. In diesem Tutorial erfahren Sie, wie Sie eine solche Benutzererweiterung entwickeln.

⚠️ Bevor Sie beginnen: Der hier beschriebene Arbeitsablauf gehört zu Selenium Core und das Original Firefox-Plugin Selenium IDE. Selenium Die Core-Version wurde eingestellt, und die Unterstützung für Benutzererweiterungen wurde entfernt. Selenium Gläser in Selenium 3. Die folgenden Schritte und der Code werden beibehalten, da eine große Anzahl älterer Selenese-Suites noch immer darauf angewiesen ist; der moderne Ersatz wird später in diesem Artikel beschrieben.

Anforderung zur Erstellung eines Selenium Benutzererweiterung

Um eine Benutzererweiterung zu erstellen für Selenium IDE, Sie benötigen die grundlegenden Konzepte von JavaSkript und insbesondere die JavaSkript-Prototypobjekt. Das folgende Diagramm zeigt die beiden Prototypobjekte, an die sich eine Benutzererweiterung anhängt.

Um Ihre Benutzererweiterung zu erstellen, schreiben Sie JavaSkriptmethoden und fügen Sie sie dem hinzu Selenium Objektprototyp und zum PageBot-Objektprototyp.

Wie Selenium Die IDE erkennt eine Benutzererweiterung

Nachdem eine Benutzererweiterung hinzugefügt wurde Selenium IDE und die IDE wird gestartet, jede Funktion ist auf diesen registriert JavaSkriptprototypen werden geladen, und Selenium Die IDE erkennt jeden Befehl an seinem Namen. Daher sind die Namenspräfixe im nächsten Abschnitt keine Stilfrage – sie dienen lediglich der Klassifizierung Ihres Befehls durch die IDE.

So erstellen Sie eine Benutzererweiterung

Schritt 1) ​​Aktion – alle Aktionen beginnen mit doWenn die Aktion Text in Großbuchstaben umwandelt, lautet ihr Name: doTextUpperCaseWenn Sie diese Aktionsmethode hinzufügen zu Selenium Die IDE selbst erstellt eine passende Wartemethode, daher doTextUpperCase erzeugt auch die Wartefunktion textUpperCaseAndWaitDie Methode kann zwei Parameter akzeptieren.

Beispiel: Textaktion in Großbuchstaben

Selenium.prototype.doTextUpperCase = function(locator, text) {
// Here findElement is itself capable to handle all type of locator(xpath,css,name,id,className), We just need to pass the locator text
var element = this.page().findElement(locator);

// Create the text to type
text = text.toUpperCase();

// Replace the element text with the new text
this.page().replaceText(element, text);
};

Schritt 2) Zugriffsmethoden / Assertion – alle auf der Selenium Objektprototypen werden mit einem Präfix versehen bekommen or isBeispielsweise `getValueFromCompoundTable` oder `isValueFromCompoundTable`. Ein Accessor kann zwei Parameter akzeptieren: einen für das Ziel und einen für das Wertfeld im Testfall. Der folgende Screenshot zeigt, wie diese Präfixe nach dem Laden der Erweiterung aussehen.

Für jeden Accessor Selenium Die IDE generiert die entsprechenden Verifizierungsfunktionen mit dem Präfix überprüfen und behaupten, plus eine Wartefunktion mit dem Präfix warteAuf.

Beispiel: Zugriffsmethoden für Großbuchstaben

Selenium.prototype.assertTextUpperCase = function(locator, text) {
// All locator-strategies are automatically handled by "findElement"
var element = this.page().findElement(locator);

// Create the text to verify
text = text.toUpperCase();

// Get the actual element value
var actualValue = element.value;

// Make sure the actual value matches the expected
Assert.matches(expectedValue, actualValue);
};

Selenium.prototype.isTextEqual = function(locator, text) {
return this.getText(locator).value===text;
};

Selenium.prototype.getTextValue = function(locator, text) {
return this.getText(locator).value;
};

Schritt 3) Locator-Strategie – Wenn Sie eine eigene Funktion zum Auffinden eines Elements erstellen möchten, erweitern Sie den PageBot-Prototyp um eine Funktion mit dem Präfix locateElementByEs benötigt zwei Parameter: die Locatorzeichenfolge und das Dokument, in dem das Element gesucht werden soll.

Beispiel: Für den Text-Locator in Großbuchstaben

// The "inDocument" is a document you are searching.
PageBot.prototype.locateElementByUpperCase = function(text, inDocument) {
// Create the text to search for
var expectedValue = text.toUpperCase();

// Loop through all elements, looking for ones that have
// a value === our expected value
var allElements = inDocument.getElementsByTagName("*");
// This star '*' is a kind of regular expression it will go through every element (in HTML DOM every element surely have a tag name like<body>,<a>,<h1>,<table>,<tr>,<td> etc. ). Here our motive is to find an element which matched with the Upper Case text we have passed so we will search it with all elements and when we get match we will have the correct web element.
for (var i = 0; i < allElements.length; i++) {
var testElement = allElements[i];
if (testElement.innerHTML && testElement.innerHTML === expectedValue) {
return testElement;
}
}
return null;
};

Speichern Sie alle drei Funktionen in einer einzigen Datei mit dem Namen user-extensions.jsDie Datei ist im Klartextformat. JavaDa es sich um ein Skript handelt, genügt jeder Texteditor.

So verwenden Sie die neu erstellte Core-Erweiterung

Das Laden der Datei ist im Original ein vierstufiger Vorgang. Firefox-Plugin-IDE. Jeder der folgenden Screenshots entspricht dem daneben nummerierten Schritt.

1. Zurück Nach Selenium IDE und klicken Optionen -> Optionen…

   

2. Im Allgemein Im Abschnitt „Speicherort des neu erstellten“ Selenium Kernerweiterung.

   

3. Klicken Sie auf OK und neu starten Selenium IDE.

   

4. Die Erweiterung finden Sie in der Befehlsliste.

   

Selenium Core Extensions vs Selenium IDE-Erweiterungen

Die beiden Begriffe werden in älteren Materialien synonym verwendet, beschreiben aber unterschiedliche Ebenen, und die Unterscheidung ist wichtig, wenn Sie entscheiden, wo Sie benutzerdefinierte Logik platzieren.

Kurz gesagt, eine Core-Erweiterung verändert, was ein Test leisten kann, während eine IDE-Erweiterung verändert, was das Tool leisten kann.

Wie die Moderne Selenium Die IDE ersetzt user-extensions.js

Das Firefox-Plugin Selenium Die IDE funktionierte nicht mehr, als Firefox Umstellung auf die WebExtensions-Architektur und die IDE wurde als Chrome neu geschrieben. Firefox und der Edge-Browsererweiterung. Durch diese Überarbeitung wurde das oben gezeigte Optionsfeld entfernt, sodass keine Möglichkeit mehr besteht, auf eine user-extensions.js-Datei zu verweisen. Zwei unterstützte Alternativen decken denselben Bereich ab.

• Der Befehl zum Ausführen des Skripts. Für einmalige Zwecke JavaSkript, fügen Sie ein Skript ausführen or Führe asynchrones Skript aus Führe den Test direkt aus und speichere das Ergebnis in einer Variablen. Dies entspricht am ehesten einer kleinen benutzerdefinierten Aktion.
• Ein Plugin. Für wiederverwendbare Befehle erstellen Sie eine Browsererweiterung, die ein Manifest in der IDE registriert. Das Manifest deklariert jeden neuen Befehl mit einer ID, einem Namen, einem optionalen Typ und einer Dokumentation und kann auch neue Locators deklarieren.

Das Manifest wird registriert, indem eine Nachricht an die IDE-Erweiterung gesendet wird, wie in der offiziellen Dokumentation gezeigt. Selenium IDE-Plugin-Dokumentation.

browser.runtime.sendMessage(SIDE_ID, {
uri: "/register",
verb: "post",
payload: {
name: "Selenium IDE plugin",
version: "1.0.0",
commands: [
{ id: "textUpperCase", name: "text upper case" }
]
}
}).catch(console.error);

Die Namenskonvention bleibt auch nach der Migration erhalten: Ein Plugin-Befehl wird weiterhin nur einmal deklariert und dann in jedem Test wiederverwendet, genau wie es bei einer Core-Erweiterung der Fall war.

Beliebte Erweiterungen und Plug-ins, die verwendet werden in Selenium IDE

Die unten aufgeführten Add-ons waren in der alten IDE am weitesten verbreitet. Einige davon, wie beispielsweise Ablaufsteuerung und Screenshot-Funktion bei Fehlern, sind mittlerweile in die aktuelle IDE integriert oder als gepflegte Plugins verfügbar.

Die alte SeleniumDie Downloadseite des Hauptsitzes, auf der diese Dateien gehostet wurden, existiert nicht mehr. Aktuelle Plugins und die IDE selbst werden von der [Website-Adresse/Plattform einfügen] vertrieben. Selenium IDE-Projektseite und von Chrome aus Firefox und Edge-Add-on-Stores.

Laden Sie Selenium In diesem Tutorial verwendete Kernerweiterung

Häufig gestellte Fragen