Selenium Core Extensions (User-Extensions.js)

Selenium Rozšíření jádra

Abychom pochopili rozšíření, nejprve si ujasněme tři pilíře Selenium IDEKaždý příkaz, který zaznamenáte nebo zadáte do IDE, patří do jedné ze tří níže uvedených kategorií a každý snímek obrazovky ukazuje, jak se daná kategorie zobrazuje v seznamu příkazů IDE.

1. Akce: Jakou operaci provádíte na obrazovce uživatelského rozhraní.

   

2. Přístupové metody / Tvrzení: Jaké ověření provádíte u dat získaných z uživatelského rozhraní.

   

3. Strategie lokátoru: Jak najdete prvek v uživatelském rozhraní.

   

Selenium IDE je dodáváno s propracovanou knihovnou, která již obsahuje spoustu akcí, přístupových metod a asercí a strategií lokátoru.

Někdy však projekt potřebuje funkce, které v dané knihovně nejsou. V takové situaci můžete knihovnu rozšířit přidáním vlastního rozšíření. Tato vlastní rozšíření se nazývají uživatelské rozšíření.

Předpokládejme například, že potřebujete akci, která převede text na velká písmena před jeho vložením do webového prvku. Ve výchozí knihovně taková akce neexistuje, takže si vytvoříte vlastní uživatelské rozšíření. V tomto tutoriálu se naučíte, jak vytvořit uživatelské rozšíření, které převede text na velká písmena.

⚠️ Než začnete: Zde popsaný pracovní postup patří Selenium Jádro a originál Firefox-plugin Selenium IDE. Selenium Jádro bylo vyřazeno a podpora uživatelských rozšíření byla zrušena. Selenium sklenice v Selenium 3. Níže uvedené kroky a kód jsou zachovány, protože na nich stále závisí velké množství starších sad Selenese; moderní náhrada je popsána dále v tomto článku.

Požadavek na vytvoření Selenium Uživatelská přípona

Vytvoření uživatelské linky pro Selenium IDE, potřebujete základní pojmy JavaScénář a zejména JavaObjekt prototypu skriptu. Níže uvedený diagram ukazuje dva objekty prototypů, ke kterým se uživatelské rozšíření připojuje.

Chcete-li vytvořit uživatelské rozšíření, napíšete JavaSkriptovací metody a jejich přidání do Selenium prototyp objektu a prototyp objektu PageBot.

Jak Selenium IDE rozpoznává uživatelské rozšíření

Po přidání uživatelské linky do Selenium IDE a IDE je spuštěno, každá funkce je na nich registrovaná JavaPrototypy skriptů jsou načteny a Selenium IDE rozpoznává každý z nich podle jeho názvu. Proto prefixy názvů v následující části nejsou stylistickou volbou – jde o to, jak IDE klasifikuje váš příkaz.

Jak vytvořit uživatelské rozšíření

Krok 1) Akce – všechny akce začínají doPokud akce převádí text na velká písmena, její název je doTextUpperCaseKdyž přidáte tuto metodu akce do Selenium IDE, samotné IDE vytváří odpovídající metodu čekání, takže doTextUpperCase také vytváří funkci wait textUpperCaseAndWaitMetoda může přijímat dva parametry.

Příklad: Akce textu s velkými písmeny

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

Krok 2) Přístupové metody / Tvrzení – všichni přístupoví uživatelé registrovaní na Selenium prototypy objektů mají předponu získat or is, například getValueFromCompoundTable nebo isValueFromCompoundTable. Přístupový objekt může přijímat dva parametry, jeden pro cíl a jeden pro pole hodnoty v testovacím případě. Následující snímek obrazovky ukazuje, jak se tyto prefixy zobrazují po načtení rozšíření.

Pro každý přístupový objekt, Selenium IDE generuje odpovídající ověřovací funkce s prefixem ověřit si a tvrdí, plus funkce čekání s předponou čekat na.

Příklad: Pro přístupové objekty pro text s velkými písmeny

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

Krok 3) Strategie lokátoru – pokud chcete vytvořit vlastní funkci pro vyhledání prvku, rozšiřte prototyp PageBot o funkci s předponou locateElementByPřijímá dva parametry: řetězec lokátoru a dokument, ve kterém má být prvek prohledán.

Příklad: Pro lokátor textu velkých písmen

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

Uložte všechny tři funkce do jednoho souboru s názvem user-extensions.jsSoubor je prostý. JavaSkript, takže postačí libovolný textový editor.

Jak používat nově vytvořené rozšíření Core

Načtení souboru je v originále čtyřkrokový úkol Firefox-plugin IDE. Každý snímek obrazovky níže odpovídá očíslovanému kroku vedle něj.

1. Přejít Selenium IDE a klikněte Možnosti -> Možnosti…

   

2. v obecně V sekci vyberte umístění nově vytvořeného Selenium Rozšíření jádra.

   

3. klikněte OK a restartujte Selenium SDI.

   

4. Rozšíření najdete v seznamu příkazů.

   

Selenium Základní rozšíření vs. Selenium Rozšíření IDE

Tyto dva termíny se ve starších materiálech používají zaměnitelně, ale popisují různé vrstvy a toto rozlišení je důležité při rozhodování, kam umístit vlastní logiku.

Stručně řečeno, rozšíření Core mění, co test dokáže, zatímco rozšíření IDE mění, co nástroj dokáže.

Jak moderní Selenium IDE Nahrazuje user-extensions.js

Jedno Firefox-plugin Selenium IDE přestalo fungovat, když Firefox přesunuto na architekturu WebExtensions a IDE bylo přepsáno jako Chrome, Firefox a rozšíření prohlížeče Edge. Toto přepsání odstranilo výše uvedené pole Možnosti, takže není místo, kde by se dal odkazovat na soubor user-extensions.js. Stejnou oblast pokrývají dvě podporované alternativy.

• Příkaz pro spuštění skriptu. Pro jednorázové JavaSkript, přidejte spustit skript or spustit asynchronní skript vstoupit přímo do testu a uložit výsledek do proměnné. Toto je nejbližší ekvivalent malé vlastní akce.
• Plugin. Pro opakovaně použitelné příkazy vytvořte rozšíření prohlížeče, které zaregistruje manifest v IDE. Manifest deklaruje každý nový příkaz s ID, názvem, volitelným typem a dokumentací a může také deklarovat nové lokátory.

Manifest je registrován odesláním zprávy do rozšíření IDE, jak je znázorněno v oficiálním Selenium Dokumentace k pluginům IDE.

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

Pojmenovací disciplína přežila migraci: příkaz pluginu je stále deklarován jednou a poté znovu použit v každém testu, přesně jako rozšíření Core.

Oblíbená rozšíření a pluginy používané v Selenium IDE

Níže uvedené doplňky byly nejrozšířenější ve starším IDE. Několik z nich, jako například řízení toku a funkce pro pořízení snímku obrazovky při selhání, je nyní integrováno do aktuálního IDE nebo je k dispozici jako udržované pluginy.

Starý SeleniumStránka pro stahování HQ, která tyto soubory hostovala, již neexistuje. Aktuální pluginy a samotné IDE jsou distribuovány z Selenium Web projektu IDE a z Chromu, Firefox a obchody s doplňky pro Edge.

stáhněte Selenium Core Extension použité v tomto kurzu

Nejčastější dotazy