Selenium Kerneudvidelser (User-Extensions.js)

⚡ Smart opsummering

Selenium Kerneudvidelser, også kaldet brugerudvidelser, tilføjer brugerdefinerede handlinger, adgangspunkter og lokaliseringsstrategier til Selenium IDE ved at vedhæfte JavaScriptfunktioner til Selenium og PageBot-prototypeobjekter, når IDE'et starter.

  • 🔘 Tre søjler: Enhver Selenese-kommando er en handling, en accessor eller assertion eller en locator-strategi.
  • ☑️ Navngivningsregler: Handlinger starter med do, accessorer med get eller is, og locatorer med locateElementBy.
  • ✅ Kommandoen Fri vent: Registrering af doTextUpperCase får IDE'en til automatisk at generere textUpperCaseAndWait.
  • 🧪 Belastningsmekanisme: IDE'en læser user-extensions.js ved opstart, så værktøjet skal genstartes efter hver redigering.
  • 🛠️ Ældre status: Selenium Kernen og Firefox-plugin IDE blev udfaset, og Selenium 3 fjernede understøttelse af brugerudvidelser fra jar-filer.
  • 📊 Moderne rute: Det nuværende browserudvidelses-IDE eksponerer i stedet et plugin-manifest og en execute script-kommando.

Selenium Kerneudvidelser og user-extensions.js-filen

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.

    Selenium IDE-kommandoliste, der viser handlingskommandoer såsom klik og skriv

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

    Selenium IDE-adgangs- og assertion-kommandoer med præfikset get, is, verify og assert

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

    Selenium IDE-målboks, der viser lokationsstrategier såsom id, navn, css og xpath

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.

Diagram over Selenium prototype- og PageBot-prototypeobjekter brugt af en brugerudvidelse

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.

Selenium IDE, der viser get- og is-tilgangskommandoer genereret fra en brugerudvidelse

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…

    Selenium IDE-indstillinger-menuen åbnes for at åbne dialogboksen Indstillinger

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

    Selenium IDE-indstillinger-dialogboksen Fanen Generelt med Selenium Felt for sti til kerneudvidelser

  3. Klik OK og genstart Selenium SDI.

    Bekræftelsesprompt vises, når Selenium IDE genstartes for at indlæse udvidelsesfilen

  4. Du finder udvidelsen i kommandolisten.

    Selenium IDE-kommando-rullemenu med en liste over den nye textUpperCase-kommando fra user-extensions.js

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.

Aspect Selenium Kerneudvidelse Selenium IDE-udvidelse
Hvad det strækker sig Selenese-kommandobiblioteket, der bruges under afspilning Selve IDE-applikationen
Fil indlæst brugerudvidelser.js user-extensions-ide.js i det ældre IDE, et plugin-manifest i det nuværende IDE
Typisk brug Nye handlinger, adgangspunkter og lokaliseringsstrategier Nye menupunkter, paneler, formater og optagerens funktionsmåde
Berørte genstande Selenium.prototype og PageBot.prototype IDE-editor og -optager-API'er
Kører under Test udførelse Forfatterskab og optagelse

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.

Navn Formål
foretrukne Sådan markerer du en testsuite som favorit og udfører den med et enkelt klik
Flex Pilot X Til Flex baseret automatisering
FlexMonkium Til Adobe Flex-baseret optagelse og afspilning test in Selenium IDE
Fillogning Til at gemme logfiler i en fil
Flow Kontrol For at kontrollere testudførelsesflowet
Fremhæv elementer For at fremhæve en webkontrol
Implicit Vent At vente på et element i en bestemt tidsgrænse
Skærmbillede ved fejl Tag et skærmbillede af fejl
Test resultater Gem test sag resultat for en testsuite med et enkelt klik

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

Det konventionelle navn er user-extensions.js, og tilføjelsesprogrammer på IDE-niveau brugte user-extensions-ide.js. Det ældre IDE lod dig pege på en hvilken som helst sti, så navnet var en konvention snarere end et hårdt krav, men hold dig opdateret.ping det gør det nemmere at genkende delte suiter.

Prototypefunktioner er skrivebeskyttede, mens IDE'et indlæses, så en ændring foretaget efter opstart ignoreres. Gem filen, luk IDE'et helt, og åbn det igen. JavaScriptsyntaksfejl forhindrer også hele filen i at indlæses lydløst.

Åbn browserkonsollen, og genstart IDE'en. Hold derefter øje med en parse-fejl i filen. Tilføjelse af en console.log-linje øverst i filen bekræfter, om den overhovedet er indlæst, før du begynder at fejlfinde individuelle funktioner.

Du skriver kun versionen med præfikset do. Selenium IDE udleder AndWait-varianten for dig, som udfører den samme operation og derefter venter på, at siden er færdigindlæst. Brug AndWait-formularen, når handlingen udløser navigation.

Maskinlæringsmodeller kan udarbejde standardteksten for en ny kommando og foreslå en locatorstrategi ud fra et sidesnapshot. AI-assisteret locatorreparation er også nyttig her, fordi en brugerdefineret locateElementBy-funktion er præcis den kode, der går i stykker, når markup ændres.

Delvist. Copilot gengiver Selenium.prototype- og PageBot.prototype-mønstre, fordi de forekommer bredt i ældre arkiver, men den kan opfinde hjælpemetoder, der aldrig har eksisteret. Tjek alle foreslåede kald mod Selenese-kommandoreferencen, før du stoler på den.

Ja. En fil, der kun indeholder en locateElementBy-funktion på PageBot.prototype, er gyldig. Den nye strategi bliver derefter tilgængelig for alle eksisterende kommandoer, så klik, skriv og assert kan alle målrette elementer gennem den.

Selenium RC accepterede en brugerudvidelsesfil via en serverswitch, men RC og Selenium Kernen blev fjernet i Selenium 3. WebDriver har ingen tilsvarende hook, så den samme logik er skrevet som en almindelig hjælpemetode i dit testframework.

Opsummer dette indlæg med: