Selenium Estensioni principali (User-Extensions.js)

Selenium Estensioni principali

Per comprendere le estensioni, cerchiamo innanzitutto di comprendere i tre pilastri di Selenium IDEOgni comando che registri o digiti nell'IDE appartiene a una delle tre categorie seguenti, e ogni schermata mostra come appare tale categoria nell'elenco dei comandi dell'IDE.

1. Azione: Quale operazione stai eseguendo sulla schermata dell'interfaccia utente?

   

2. Accessori / Asserzione: Quali verifiche effettuate sui dati ricevuti dall'interfaccia utente?

   

3. Strategia di localizzazione: Come trovare l'elemento nell'interfaccia utente.

   

Selenium L'IDE viene fornito con una libreria matura che contiene già numerose azioni, metodi di accesso, asserzioni e strategie di localizzazione.

A volte, tuttavia, un progetto necessita di funzionalità non presenti in quella libreria. In tal caso, è possibile espandere la libreria aggiungendo una propria estensione personalizzata. Queste estensioni personalizzate sono chiamate interno utente.

Ad esempio, supponiamo di aver bisogno di un'azione che converta il testo in maiuscolo prima di inserirlo in un elemento web. Poiché tale azione non è presente nella libreria predefinita, è necessario creare un'estensione utente personalizzata. In questo tutorial imparerai come creare un'estensione utente che converte il testo in maiuscolo.

⚠️ Prima di iniziare: il flusso di lavoro qui descritto appartiene a Selenium Nucleo e l'originale Firefox-collegare Selenium IDE. Selenium Core è stato ritirato e il supporto per le estensioni utente è stato rimosso da Selenium barattoli in Selenium 3. I passaggi e il codice seguenti sono stati mantenuti perché un gran numero di suite Selenese obsolete ne dipendono ancora; la soluzione moderna sostitutiva è descritta più avanti in questo articolo.

Requisito per creare un Selenium Estensione utente

Per creare un'estensione utente per Selenium IDE, hai bisogno dei concetti di base di JavaCopione e, in particolare, il JavaOggetto prototipo dello script. Il diagramma seguente mostra i due oggetti prototipo a cui si collega un'estensione utente.

Per creare la tua estensione utente, scrivi JavaMetodi di scripting e aggiungili al Selenium prototipo dell'oggetto e al prototipo dell'oggetto PageBot.

Come Selenium L'IDE riconosce un'estensione utente

Dopo che un'estensione utente è stata aggiunta a Selenium IDE e l'IDE è avviato, ogni funzione registrata su quelle JavaLo script prototipi è caricato e Selenium L'IDE riconosce ciascun comando tramite il suo nome. Ecco perché i prefissi di denominazione nella sezione successiva non sono una scelta di stile, ma il modo in cui l'IDE classifica il comando.

Come creare un'estensione utente

Passaggio 1) Azione – tutte le azioni iniziano con doSe l'azione converte il testo in maiuscolo, il suo nome è doTextUpperCase. Quando aggiungi questo metodo di azione a Selenium IDE, l'IDE stesso crea un metodo di attesa corrispondente, quindi doTextUpperCase produce anche la funzione di attesa testoMaiuscoloEAttendiIl metodo può accettare due parametri.

Esempio: Azione con testo in maiuscolo

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

Passaggio 2) Accessori / Asserzione – tutti gli utenti registrati sul Selenium Il prototipo dell'oggetto è preceduto da ottenere or isAd esempio, getValueFromCompoundTable o isValueFromCompoundTable. Un accessor può accettare due parametri, uno per la destinazione e uno per il campo valore nel caso di test. Lo screenshot seguente mostra come appaiono questi prefissi una volta caricata l'estensione.

Per ogni accessor, Selenium L'IDE genera le corrispondenti funzioni di verifica precedute da verificare and affermare, più una funzione di attesa preceduta da attendere.

Esempio: per gli accessori di testo in maiuscolo

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

Fase 3) Strategia di localizzazione – se vuoi creare la tua funzione per individuare un elemento, estendi il prototipo PageBot con una funzione preceduta da localizzareElementoPerRichiede due parametri: la stringa di localizzazione e il documento in cui cercare l'elemento.

Esempio: per il localizzatore di testo in maiuscolo

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

Salva tutte e tre le funzioni in un unico file denominato user-extensions.jsIl file è semplice JavaSi tratta di uno script, quindi qualsiasi editor di testo è sufficiente.

Come utilizzare la nuova estensione Core

Il caricamento del file è un'operazione in quattro fasi nell'originale Firefox-plugin IDE. Ogni schermata qui sotto corrisponde al passaggio numerato accanto.

1. Vai su Selenium IDE e fai clic Opzioni -> Opzioni…

   

2. Nel General sezione, selezionare la posizione del appena creato Selenium Estensione del nucleo.

   

3. Clicchi OK e riavvia Selenium SDI.

   

4. Troverai l'estensione nell'elenco dei comandi.

   

Selenium Estensioni principali vs Selenium Estensioni IDE

Nei materiali più datati i due termini vengono usati in modo intercambiabile, ma descrivono livelli diversi, e la distinzione è importante quando si decide dove inserire la logica personalizzata.

In breve, un'estensione Core modifica le funzionalità di un test, mentre un'estensione IDE modifica le funzionalità dello strumento.

Come il moderno Selenium L'IDE sostituisce user-extensions.js

Migliori Firefox-collegare Selenium L'IDE ha smesso di funzionare quando Firefox è passato all'architettura WebExtensions e l'IDE è stato riscritto come Chrome, Firefox e l'estensione per il browser Edge. Tale riscrittura ha rimosso il campo Opzioni mostrato sopra, quindi non c'è modo di indicare un file user-extensions.js. Due alternative supportate coprono lo stesso ambito.

• Il comando di esecuzione dello script. Per una sola volta JavaScript, aggiungi un script eseguito or esegui script asincrono Esegui direttamente il test e memorizza il risultato in una variabile. Questa è la soluzione più simile a una piccola azione personalizzata.
• Un plugin. Per i comandi riutilizzabili, crea un'estensione del browser che registri un manifesto con l'IDE. Il manifesto dichiara ogni nuovo comando con un ID, un nome, un tipo opzionale e la documentazione, e può anche dichiarare nuovi localizzatori.

Il manifesto viene registrato inviando un messaggio all'estensione IDE, come mostrato nell'ufficiale Selenium documentazione del plugin 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);

La convenzione di denominazione sopravvive alla migrazione: un comando plugin viene ancora dichiarato una sola volta e poi riutilizzato in ogni test, esattamente come avveniva per un'estensione Core.

Estensioni e plug-in popolari utilizzati in Selenium IDE

I componenti aggiuntivi elencati di seguito erano i più utilizzati nella versione precedente dell'IDE. Molti di essi, come il controllo del flusso e la funzionalità di acquisizione schermata in caso di errore, sono ora integrati nell'IDE attuale o disponibili come plugin mantenuti.

Il vecchio SeleniumLa pagina di download HQ che ospitava questi file non esiste più. I plugin attuali e l'IDE stesso sono distribuiti da Selenium Sito del progetto IDE e da Chrome, Firefox e i negozi di componenti aggiuntivi di Edge.

Scarica la Selenium Estensione Core utilizzata in questo tutorial

DOMANDE FREQUENTI