Selenium Kerneudvidelser (User-Extensions.js)

Selenium Kerneudvidelser

For at forstå udvidelser, lad os først forstå de tre søjler Selenium IDEHver kommando, du optager eller skriver i IDE'en, tilhører en af ​​de tre kategorier nedenfor, og hvert skærmbillede viser, hvordan den pågældende kategori vises på IDE-kommandolisten.

1. Handling: Hvilken handling du udfører på brugergrænsefladen.

   

2. Tilgangspersoner / Påstand: Hvilken verifikation du udfører på de data, du får fra brugergrænsefladen.

   

3. Lokaliseringsstrategi: Hvordan du finder elementet i brugergrænsefladen.

   

Selenium IDE leveres med et modent bibliotek, der allerede indeholder masser af handlinger, accessorer og assertions samt locator-strategier.

Nogle gange har et projekt dog brug for funktionalitet, der ikke findes i det pågældende bibliotek. I den situation kan du udvide biblioteket ved at tilføje din egen brugerdefinerede udvidelse. Disse brugerdefinerede udvidelser kaldes en brugerudvidelse.

Lad os for eksempel antage, at du har brug for en handling, der konverterer tekst til store bogstaver, før den udfyldes i et webelement. En sådan handling findes ikke i standardbiblioteket, så du opretter din egen brugerudvidelse. I denne vejledning lærer du, hvordan du bygger en brugerudvidelse, der konverterer tekst til store bogstaver.

⚠️ Inden du starter: den her beskrevne arbejdsgang tilhører Selenium Kernen og originalen Firefox-plugin Selenium IDE. Selenium Core er blevet udfaset, og understøttelse af brugerudvidelser er blevet fjernet fra Selenium krukker i Selenium 3. Trinene og koden nedenfor er bevaret, fordi et stort antal ældre Selenese-pakker stadig er afhængige af dem; den moderne erstatning er beskrevet senere i denne artikel.

Krav om at oprette en Selenium Brugerudvidelse

Sådan opretter du en brugerudvidelse til Selenium IDE, du har brug for de grundlæggende koncepter JavaScript og især den JavaScriptprototypeobjekt. Diagrammet nedenfor viser de to prototypeobjekter, som en brugerudvidelse knytter sig til.

For at oprette din brugerudvidelse skal du skrive JavaScriptmetoder og tilføj dem til Selenium objektprototypen og til PageBot-objektprototypen.

Hvordan Selenium IDE genkender en brugerudvidelse

Efter en brugerudvidelse er tilføjet til Selenium IDE, og IDE'en startes, hver funktion registreret på disse JavaScriptprototyper er indlæst, og Selenium IDE genkender hver kommando ved sit navn. Derfor er navngivningspræfikserne i næste afsnit ikke et stilvalg – de er, hvordan IDE'en klassificerer din kommando.

Sådan opretter du en brugerudvidelse

Trin 1) Handling – alle handlinger starter med doHvis handlingen konverterer tekst til store bogstaver, bliver dens navn doTextUpperCaseNår du tilføjer denne handlingsmetode til Selenium IDE, opretter IDE'en selv en matchende ventemetode, så doTextUpperCase producerer også ventefunktionen tekstStoreBogstaverOgVentMetoden kan acceptere to parametre.

Eksempel: Teksthandling med store bogstaver

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);
};

Trin 2) Tilgange / Påstand – alle tiltrædere registreret på Selenium objektprototyper har præfikset få or is, for eksempel getValueFromCompoundTable eller isValueFromCompoundTable. En accessor kan acceptere to parametre, én for målet og én for værdifeltet i testcasen. Skærmbilledet nedenfor viser, hvordan disse præfikser vises, når udvidelsen er indlæst.

For hver adgangsgiver, Selenium IDE genererer de tilsvarende verifikationsfunktioner præfikset af verificere og hævde, plus en ventefunktion præfikset af ventPå.

Eksempel: For teksttilgange med store bogstaver

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;
};

Trin 3) Lokaliseringsstrategi – hvis du vil oprette din egen funktion til at finde et element, skal du udvide PageBot-prototypen med en funktion præfikset af locateElementByDen kræver to parametre: lokaliseringsstrengen og det dokument, hvor elementet skal søges i.

Eksempel: Til tekstsøgning af store bogstaver

// 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;
};

Gem alle tre funktioner i en enkelt fil med navnet brugerudvidelser.jsFilen er almindelig JavaScript, så enhver teksteditor er tilstrækkelig.

Sådan bruger du den nyoprettede Core-udvidelse

Indlæsning af filen er en firetrinsopgave i originalen Firefox-plugin IDE. Hvert skærmbillede nedenfor svarer til det nummererede trin ved siden af.

1. Gå til Selenium IDE og klik Valgmuligheder -> Valgmuligheder…

   

2. I Generelt sektion, vælg placeringen af ​​den nyoprettede Selenium Kerneudvidelse.

   

3. Klik OK og genstart Selenium SDI.

   

4. Du finder udvidelsen i kommandolisten.

   

Selenium Kerneudvidelser vs. Selenium IDE-udvidelser

De to udtryk bruges i flæng i ældre materiale, men de beskriver forskellige lag, og sondringen er vigtig, når du beslutter, hvor du skal placere brugerdefineret logik.

Kort sagt ændrer en Core-udvidelse, hvad en test kan gøre, mens en IDE-udvidelse ændrer, hvad værktøjet kan gøre.

Hvordan den moderne Selenium IDE erstatter user-extensions.js

Firefox-plugin Selenium IDE stoppede med at virke, da Firefox flyttede til WebExtensions-arkitekturen, og IDE'en blev omskrevet som en Chrome, Firefox og Edge browserudvidelsen. Den omskrivning fjernede feltet Indstillinger vist ovenfor, så der er ikke plads til at pege på en user-extensions.js-fil. To understøttede alternativer dækker det samme område.

• Kommandoen "execute script". Til engangsforeteelser JavaScript, tilføj et udfør script or udfør asynkront script Gå direkte ind i testen og gem resultatet i en variabel. Dette er det tætteste svar på en lille brugerdefineret handling.
• Et plugin. For genbrugelige kommandoer skal du bygge en browserudvidelse, der registrerer et manifest med IDE'et. Manifestet deklarerer hver ny kommando med et id, et navn, en valgfri type og dokumentation, og det kan også deklarere nye locatorer.

Manifestet registreres ved at sende en besked til IDE-udvidelsen, som vist i den officielle Selenium Dokumentation til IDE-plugin.

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);

Navngivningsdisciplinen overlever migreringen: en plugin-kommando deklareres stadig én gang og genbruges derefter på tværs af hver test, præcis som en Core-udvidelse blev.

Populære udvidelser og plugins brugt i Selenium IDE

Tilføjelsesprogrammerne nedenfor var de mest anvendte i det ældre IDE. Flere af dem, såsom flowkontrol og screenshot-on-failure, er nu indbygget i det nuværende IDE eller tilgængelige som vedligeholdte plugins.

Den gamle SeleniumHQ-downloadsiden, der hostede disse filer, findes ikke længere. Nuværende plugins og selve IDE'en distribueres fra Selenium IDE-projektets websted og fra Chrome, Firefox og Edge-tilføjelsesbutikker.

Download Selenium Core Extension brugt i denne selvstudie

Ofte Stillede Spørgsmål