Protocollo WebDriver

newSession

Il comando New Session crea una nuova sessione WebDriver con il nodo endpoint. Se la creazione fallisce, viene restituito un errore di sessione non creata.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.newSession(capabilities)

Parametri

Nome	Tipo	Dettagli
capabilities	object	un oggetto JSON, l'insieme di capabilities che è stato ultimamente unito e abbinato nell'algoritmo di elaborazione delle capabilities

Restituisce

• <Object> session: Oggetto contenente sessionId e capabilities della sessione WebDriver creata.

---

deleteSession

Il comando Delete Session chiude qualsiasi contesto di navigazione di livello superiore associato alla sessione corrente, termina la connessione e infine chiude la sessione corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.deleteSession(deleteSessionOpts)

Parametri

Nome	Tipo	Dettagli
deleteSessionOpts opzionale	object	Oggetto contenente opzioni per il comando deleteSession, ad es. { shutdownDriver: boolean }

---

status

Il comando Status restituisce informazioni sul fatto che un endpoint remoto sia in uno stato in cui può creare nuove sessioni e può inoltre includere meta-informazioni arbitrarie specifiche dell'implementazione.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.status()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> status: Oggetto contenente lo stato del driver.

---

getTimeouts

Il comando Get Timeouts ottiene le durate di timeout associate alla sessione corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getTimeouts()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> timeouts: Oggetto contenente la durata dei timeout per script, pageLoad e timeout implicit.

---

setTimeouts

Il comando Set Timeouts imposta le durate di timeout associate alla sessione corrente. I timeout che possono essere controllati sono elencati nella tabella dei timeout di sessione qui sotto.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.setTimeouts(implicit, pageLoad, script)

Parametri

Nome	Tipo	Dettagli
implicit opzionale	number	intero in ms per il timeout implicito della sessione
pageLoad opzionale	number	intero in ms per il timeout di caricamento della pagina della sessione
script opzionale	number	intero in ms per il timeout di script della sessione

Esempio

examples.js

loading...

View on GitHub

---

getUrl

Il comando Get Current URL restituisce l'URL del contesto di navigazione di livello superiore corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getUrl()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> url: URL del documento attivo del contesto di navigazione di livello superiore corrente

---

navigateTo

Il comando navigateTo (go) viene utilizzato per far navigare l'agente utente nel contesto di navigazione di livello superiore corrente verso una nuova posizione.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: url. Si consiglia di utilizzare questo comando.

Utilizzo

browser.navigateTo(url)

Parametri

Nome	Tipo	Dettagli
url	string	stringa che rappresenta un URL assoluto (che inizia con http(s)), possibilmente incluso un frammento (#...), potrebbe anche essere uno schema locale (about: ecc.)

Esempio

examples.js

loading...

View on GitHub

---

back

Il comando Back fa sì che il browser si sposti di un passo indietro nella cronologia della sessione congiunta del contesto di navigazione di livello superiore corrente. Questo è equivalente a premere il pulsante indietro nel chrome del browser o a chiamare window.history.back.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.back()

Esempio

examples.js

loading...

View on GitHub

---

forward

Il comando Forward fa sì che il browser si sposti di un passo avanti nella cronologia della sessione congiunta del contesto di navigazione di livello superiore corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.forward()

Esempio

examples.js

loading...

View on GitHub

---

refresh

Il comando Refresh fa sì che il browser ricarichi la pagina nel contesto di navigazione di livello superiore corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.refresh()

Esempio

examples.js

loading...

View on GitHub

---

getTitle

Il comando Get Title restituisce il titolo del documento del contesto di navigazione di livello superiore corrente, equivalente a chiamare document.title.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getTitle()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> title: Restituisce una stringa uguale a document.title del contesto di navigazione di livello superiore corrente.

---

getWindowHandle

Il comando Get Window Handle restituisce l'handle della finestra per il contesto di navigazione di livello superiore corrente. Può essere utilizzato come argomento per Switch To Window.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getWindowHandle()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> handle: Restituisce una stringa che è l'handle della finestra per il contesto di navigazione di livello superiore corrente.

---

closeWindow

Il comando Close Window chiude il contesto di navigazione di livello superiore corrente. Una volta fatto, se non ci sono più contesti di navigazione di livello superiore aperti, la sessione WebDriver stessa viene chiusa.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.closeWindow()

Esempio

examples.js

loading...

View on GitHub

---

switchToWindow

Il comando Switch To Window viene utilizzato per selezionare il contesto di navigazione di livello superiore corrente per la sessione corrente, cioè quello che verrà utilizzato per l'elaborazione dei comandi.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: switchWindow. Si consiglia di utilizzare questo comando.

Utilizzo

browser.switchToWindow(handle)

Parametri

Nome	Tipo	Dettagli
handle	string	una stringa che rappresenta un handle di finestra, dovrebbe essere una delle stringhe restituite in una chiamata a getWindowHandles

Esempio

examples.js

loading...

View on GitHub

---

createWindow

Crea un nuovo contesto di navigazione di livello superiore.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.createWindow(type)

Parametri

Nome	Tipo	Dettagli
type	string	Impostato a 'tab' se la finestra appena creata condivide una finestra a livello di sistema operativo con il contesto di navigazione corrente, o 'window' altrimenti.

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> window: Nuovo oggetto finestra contenente 'handle' con il valore dell'handle e 'type' con il valore del tipo di finestra creata

---

getWindowHandles

Il comando Get Window Handles restituisce un elenco di handle di finestra per ogni contesto di navigazione di livello superiore aperto. L'ordine in cui vengono restituiti gli handle delle finestre è arbitrario.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getWindowHandles()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <String[]> handles: Un array che è un elenco di handle di finestre.

---

printPage

Il comando Print Page rende il documento in un documento PDF impaginato. Nota: Chrome attualmente supporta questo solo in modalità headless, vedi crbug753118).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.printPage(orientation, scale, background, width, height, top, bottom, left, right, shrinkToFit, pageRanges)

Parametri

Nome	Tipo	Dettagli
orientation opzionale	string	orientamento della pagina. Predefinito: portrait
scale opzionale	number	scala della pagina. Predefinito: 1
background opzionale	boolean	sfondo della pagina. Predefinito: false
width opzionale	number	larghezza della pagina in cm. Predefinito: 21.59 dalla pagina
height opzionale	number	altezza della pagina in cm. Predefinito: 27.94 dalla pagina
top opzionale	number	margine della pagina in cm dal margine superiore. Predefinito: 1
bottom opzionale	number	margine della pagina in cm dal margine inferiore. Predefinito: 1
left opzionale	number	margine della pagina in cm dal margine sinistro. Predefinito: 1
right opzionale	number	margine della pagina in cm dal margine destro. Predefinito: 1
shrinkToFit opzionale	boolean	ridurre il pdf per adattarlo alla pagina. Predefinito: true
pageRanges opzionale	object[]	intervalli di pagine. Predefinito []

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> pdf: La rappresentazione PDF codificata in base64 del documento impaginato.

---

switchToFrame

Il comando Switch To Frame viene utilizzato per selezionare il contesto di navigazione di livello superiore corrente o un contesto di navigazione figlio del contesto di navigazione corrente da utilizzare come contesto di navigazione corrente per i comandi successivi.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

attenzione

Questo comando di protocollo è deprecato
Questo comando è deprecato e incoraggiamo tutti a utilizzare switchFrame per passare ai frame. Maggiori informazioni su questo comando sono disponibili su https://webdriver.io/docs/api/browser/switchFrame.

Utilizzo

browser.switchToFrame(id)

Parametri

Nome	Tipo	Dettagli
id	number, object, null	uno di tre possibili tipi: null: rappresenta il contesto di navigazione di livello superiore (cioè, non un iframe), un Numero, che rappresenta l'indice dell'oggetto finestra corrispondente a un frame, un oggetto Element ricevuto usando findElement.

Esempio

examples.js

loading...

View on GitHub

---

switchToParentFrame

Il comando Switch to Parent Frame imposta il contesto di navigazione corrente per i comandi futuri al genitore del contesto di navigazione corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.switchToParentFrame()

Esempio

examples.js

loading...

View on GitHub

---

getWindowRect

Il comando Get Window Rect restituisce la dimensione e la posizione sullo schermo della finestra del sistema operativo corrispondente al contesto di navigazione di livello superiore corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: getWindowSize. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getWindowRect()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> windowRect: Una rappresentazione JSON di un oggetto "window rect". Ha 4 proprietà: x, y, width e height.

---

setWindowRect

Il comando Set Window Rect modifica la dimensione e la posizione della finestra del sistema operativo corrispondente al contesto di navigazione di livello superiore corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: setWindowSize. Si consiglia di utilizzare questo comando.

Utilizzo

browser.setWindowRect(x, y, width, height)

Parametri

Nome	Tipo	Dettagli
x	number, null	l'attributo screenX dell'oggetto finestra
y	number, null	l'attributo screenY dell'oggetto finestra
width	number, null	la larghezza delle dimensioni esterne del contesto di navigazione di livello superiore, incluso chrome del browser ecc...
height	number, null	l'altezza delle dimensioni esterne del contesto di navigazione di livello superiore, incluso chrome del browser ecc...

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> windowRect: Una rappresentazione JSON di un oggetto "window rect" basata sul nuovo stato della finestra.

---

maximizeWindow

Il comando Maximize Window invoca l'operazione specifica del gestore finestre "massimizza", se presente, sulla finestra che contiene il contesto di navigazione di livello superiore corrente. Questo tipicamente aumenta la finestra alla dimensione massima disponibile senza andare a schermo intero.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.maximizeWindow()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> windowRect: Una rappresentazione JSON di un oggetto "window rect" basata sul nuovo stato della finestra.

---

minimizeWindow

Il comando Minimize Window invoca l'operazione specifica del gestore finestre "minimizza", se presente, sulla finestra che contiene il contesto di navigazione di livello superiore corrente. Questo tipicamente nasconde la finestra nella barra delle applicazioni di sistema.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.minimizeWindow()

Restituisce

• <Object> windowRect: Una rappresentazione JSON di un oggetto "window rect" del (nuovo) contesto di navigazione di livello superiore corrente.

---

fullscreenWindow

Il comando Fullscreen Window invoca l'operazione specifica del gestore finestre "schermo intero", se presente, sulla finestra che contiene il contesto di navigazione di livello superiore corrente. Questo tipicamente aumenta la finestra alla dimensione del display fisico e può nascondere elementi del chrome del browser come le barre degli strumenti.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.fullscreenWindow()

Restituisce

• <Object> windowRect: Una rappresentazione JSON di un oggetto "window rect" del (nuovo) contesto di navigazione di livello superiore corrente.

---

findElement

Il comando Find Element viene utilizzato per trovare un elemento nel contesto di navigazione corrente che può essere utilizzato per comandi futuri. Questo comando restituisce una rappresentazione JSON dell'elemento che può essere passata al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: $. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElement(using, value)

Parametri

Nome	Tipo	Dettagli
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object> element: Una rappresentazione JSON di un oggetto elemento, ad es. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromShadowRoot

Il comando Find Element From Shadow Root viene utilizzato per trovare un elemento all'interno dello shadow root di un elemento che può essere utilizzato per comandi futuri. Questo comando restituisce una rappresentazione JSON dell'elemento che può essere passata al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: shadow$. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElementFromShadowRoot(shadowId, using, value)

Parametri

Nome	Tipo	Dettagli
shadowId	String	id dell'elemento di un elemento shadow root
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object> element: Una rappresentazione JSON di un oggetto shadow elemento, ad es. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElements

Il comando Find Elements viene utilizzato per trovare elementi nel contesto di navigazione corrente che possono essere utilizzati per comandi futuri. Questo comando restituisce un array di rappresentazioni JSON degli elementi che possono essere passati al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso (Vedi findElement).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: $$. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElements(using, value)

Parametri

Nome	Tipo	Dettagli
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object[]> elements: Un elenco JSON (possibilmente vuoto) di rappresentazioni di un oggetto elemento, ad es. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

findElementsFromShadowRoot

Il comando Find Elements viene utilizzato per trovare elementi all'interno dello shadow root di un elemento che possono essere utilizzati per comandi futuri. Questo comando restituisce un array di rappresentazioni JSON degli elementi che possono essere passati al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso (Vedi findElement).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: shadow$$. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElementsFromShadowRoot(shadowId, using, value)

Parametri

Nome	Tipo	Dettagli
shadowId	String	id dell'elemento di un elemento shadow root
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object[]> elements: Un elenco JSON (possibilmente vuoto) di rappresentazioni di un oggetto elemento, ad es. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromElement

Il comando Find Element From Element viene utilizzato per trovare un elemento da un elemento web nel contesto di navigazione corrente che può essere utilizzato per comandi futuri. Questo comando restituisce una rappresentazione JSON dell'elemento che può essere passata al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso (Vedi findElement).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: $. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElementFromElement(elementId, using, value)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object> element: Una rappresentazione JSON di un oggetto elemento, ad es. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementsFromElement

Il comando Find Elements From Element viene utilizzato per trovare elementi da un elemento web nel contesto di navigazione corrente che possono essere utilizzati per comandi futuri. Questo comando restituisce un array di rappresentazioni JSON degli elementi che possono essere passati al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso (Vedi findElement).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: $$. Si consiglia di utilizzare questo comando.

Utilizzo

browser.findElementsFromElement(elementId, using, value)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
using	string	una strategia di localizzazione di elementi valida
value	string	il selettore effettivo che verrà utilizzato per trovare un elemento

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <object[]> elements: Un elenco JSON (possibilmente vuoto) di rappresentazioni di un oggetto elemento, ad es. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

getElementShadowRoot

Ottiene l'oggetto shadow root di un elemento. L'oggetto risultante può essere utilizzato per recuperare elementi all'interno di questo shadow root utilizzando ad esempio findElementFromShadowRoots o findElementsFromShadowRoots.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: shadow$. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getElementShadowRoot(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> shadowRoot: Una rappresentazione JSON di uno shadow root elemento, ad es. { 'shadow-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

getActiveElement

Get Active Element restituisce l'elemento attivo del documento elemento del contesto di navigazione corrente. Questo comando restituisce una rappresentazione JSON dell'elemento che può essere passata al comando $ per trasformare il riferimento in un elemento WebdriverIO esteso (Vedi findElement).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getActiveElement()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> element: Una rappresentazione JSON di un oggetto elemento, ad es. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

isElementSelected

Is Element Selected determina se l'elemento referenziato è selezionato o meno. Questa operazione ha senso solo su elementi di input degli stati Checkbox e Radio Button, o elementi option.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: isSelected. Si consiglia di utilizzare questo comando.

Utilizzo

browser.isElementSelected(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Boolean> isSelected: true o false in base allo stato selezionato.

---

isElementDisplayed

Is Element Displayed determina la visibilità di un elemento che è guidata da ciò che è percettivamente visibile all'occhio umano. In questo contesto, la visualizzazione di un elemento non è correlata alle proprietà di stile visibility o display.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: isDisplayed. Si consiglia di utilizzare questo comando.

Utilizzo

browser.isElementDisplayed(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Boolean> isDisplayed: true o false in base allo stato visibile.

---

getElementAttribute

Il comando Get Element Attribute restituirà l'attributo di un elemento web.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: getAttribute. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getElementAttribute(elementId, name)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
name	String	nome del valore dell'attributo da recuperare

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> attribute: L'attributo nominato dell'elemento.

---

getElementProperty

Il comando Get Element Property restituirà il risultato dell'ottenimento di una proprietà di un elemento.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: getProperty. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getElementProperty(elementId, name)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
name	String	nome della proprietà dell'attributo da recuperare

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> property: La proprietà nominata dell'elemento, accessibile chiamando GetOwnProperty sull'oggetto elemento.

---

getElementCSSValue

Il comando Get Element CSS Value recupera il valore calcolato della proprietà CSS data dell'elemento web dato.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: getCSSProperty. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getElementCSSValue(elementId, propertyName)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
propertyName	String	nome della proprietà CSS da recuperare

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> cssValue: Il valore calcolato del parametro corrispondente al nome della proprietà dalle dichiarazioni di stile dell'elemento (a meno che il tipo di documento non sia xml, nel qual caso il valore restituito è semplicemente la stringa vuota).

---

getElementText

Il comando Get Element Text intende restituire il testo di un elemento "come reso". Il testo reso di un elemento viene anche utilizzato per localizzare elementi tramite il loro testo di link e testo parziale di link.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getElementText(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> text: Il testo visibile dell'elemento (inclusi elementi figli), seguendo l'algoritmo definito negli Atomi Selenium per bot.dom.getVisibleText.

---

getElementTagName

Il comando Get Element Tag Name restituisce il nome qualificato dell'elemento dato.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: getTagName. Si consiglia di utilizzare questo comando.

Utilizzo

browser.getElementTagName(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> text: L'attributo tagName dell'elemento.

---

getElementRect

Il comando Get Element Rect restituisce le dimensioni e le coordinate dell'elemento web dato.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nei seguenti metodi convenienti: getSize, getLocation. Si consiglia di utilizzare questi comandi.

Utilizzo

browser.getElementRect(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> elementRect: Un oggetto JSON che rappresenta la posizione e il rettangolo di delimitazione dell'elemento.

---

isElementEnabled

Is Element Enabled determina se l'elemento referenziato è abilitato o meno. Questa operazione ha senso solo sui controlli del modulo.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: isEnabled. Si consiglia di utilizzare questo comando.

Utilizzo

browser.isElementEnabled(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Boolean> isEnabled: Se l'elemento è in un documento xml, o è un controllo del modulo disabilitato: false, altrimenti, true.

---

elementClick

Il comando Element Click scorre in vista l'elemento se non è già interagibile con il puntatore, e fa clic sul suo punto centrale in vista. Se il punto centrale dell'elemento è oscurato da un altro elemento, viene restituito un errore di clic intercettato dell'elemento. Se l'elemento è fuori dal viewport, viene restituito un errore di elemento non interagibile.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: click. Si consiglia di utilizzare questo comando.

Utilizzo

browser.elementClick(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

---

elementClear

Il comando Element Clear scorre in vista un elemento modificabile o resettabile e poi tenta di cancellare i suoi file selezionati o il contenuto di testo.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: clearValue. Si consiglia di utilizzare questo comando.

Utilizzo

browser.elementClear(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Esempio

examples.js

loading...

View on GitHub

---

elementSendKeys

Il comando Element Send Keys scorre in vista l'elemento del controllo del modulo e poi invia i tasti forniti all'elemento. Nel caso in cui l'elemento non sia interagibile con la tastiera, viene restituito un errore di elemento non interagibile.

Lo stato di input chiave utilizzato per l'input può essere cancellato a metà della "digitazione" inviando il tasto null, che è U+E000 (NULL).

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nei seguenti metodi convenienti: addValue, setValue. Si consiglia di utilizzare questi comandi.

Utilizzo

browser.elementSendKeys(elementId, text)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
text	string	stringa da inviare come battute di tasti all'elemento

Esempio

examples.js

loading...

View on GitHub

---

getPageSource

Il comando Get Page Source restituisce una serializzazione di stringa del DOM del documento attivo del contesto di navigazione corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getPageSource()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> pageSource: il DOM del documento attivo del contesto di navigazione corrente

---

executeScript

Il comando Execute Script esegue una funzione JavaScript nel contesto del contesto di navigazione corrente e restituisce il valore di ritorno della funzione.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: execute. Si consiglia di utilizzare questo comando.

Utilizzo

browser.executeScript(script, args)

Parametri

Nome	Tipo	Dettagli
script	string	una stringa, il corpo della funzione Javascript che vuoi eseguita
args	string, object, number, boolean, null, undefined[]	un array di valori JSON che saranno deserializzati e passati come argomenti alla tua funzione

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <*> result: O il valore di ritorno del tuo script, l'adempimento della Promise restituita dal tuo script, o l'errore che è stato il motivo del rifiuto della Promise restituita dal tuo script.

---

executeAsyncScript

Il comando Execute Async Script fa eseguire JavaScript come una funzione anonima. A differenza del comando Execute Script, il risultato della funzione viene ignorato. Invece un argomento aggiuntivo viene fornito come argomento finale alla funzione. Questa è una funzione che, quando chiamata, restituisce il suo primo argomento come risposta.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

info

Questo comando di protocollo è incorporato nel seguente metodo conveniente: executeAsync. Si consiglia di utilizzare questo comando.

Utilizzo

browser.executeAsyncScript(script, args)

Parametri

Nome	Tipo	Dettagli
script	string	una stringa, il corpo della funzione Javascript che vuoi eseguita
args	string, object, number, boolean, null, undefined[]	un array di valori JSON che saranno deserializzati e passati come argomenti alla tua funzione

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <*> result: O il valore di ritorno del tuo script, l'adempimento della Promise restituita dal tuo script, o l'errore che è stato il motivo del rifiuto della Promise restituita dal tuo script.

---

getAllCookies

Il comando Get All Cookies restituisce tutti i cookie associati all'indirizzo del documento attivo del contesto di navigazione corrente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getAllCookies()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object[]> cookies: Un elenco di cookie serializzati. Ogni cookie serializzato ha un numero di campi opzionali che possono essere restituiti o meno in aggiunta a name e value.

---

addCookie

Il comando Add Cookie aggiunge un singolo cookie all'archivio dei cookie associato all'indirizzo del documento attivo.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.addCookie(cookie)

Parametri

Nome	Tipo	Dettagli
cookie	object	Un oggetto JSON che rappresenta un cookie. Deve avere almeno i campi name e value e potrebbe averne di più, inclusi expiry-time e così via

Esempio

examples.js

loading...

View on GitHub

---

deleteAllCookies

Il comando Delete All Cookies consente l'eliminazione di tutti i cookie associati all'indirizzo del documento attivo.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.deleteAllCookies()

Esempio

examples.js

loading...

View on GitHub

---

getNamedCookie

Il comando Get Named Cookie restituisce il cookie con il nome richiesto dai cookie associati nell'archivio dei cookie del documento attivo del contesto di navigazione corrente. Se non viene trovato alcun cookie, viene restituito un errore di cookie non presente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getNamedCookie(name)

Parametri

Nome	Tipo	Dettagli
name	String	nome del cookie da recuperare

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <Object> cookie: Un cookie serializzato, con campi name e value. Ci sono una serie di campi opzionali come path, domain e expiry-time che possono essere presenti.

---

deleteCookie

Il comando Delete Cookie consente di eliminare un singolo cookie dal parametro name o tutti i cookie associati all'indirizzo del documento attivo se name è indefinito.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.deleteCookie(name)

Parametri

Nome	Tipo	Dettagli
name	String	nome del cookie da eliminare

Esempio

examples.js

loading...

View on GitHub

---

performActions

Il comando Perform Actions viene utilizzato per eseguire azioni utente complesse. Vedi spec per maggiori dettagli.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.performActions(actions)

Parametri

Nome	Tipo	Dettagli
actions	object[]	un elenco di oggetti, ciascuno dei quali rappresenta una fonte di input e le relative azioni

---

releaseActions

Il comando Release Actions viene utilizzato per rilasciare tutti i tasti e i pulsanti del puntatore che sono attualmente premuti. Ciò fa sì che vengano generati eventi come se lo stato fosse stato rilasciato da una serie esplicita di azioni. Cancella anche tutto lo stato interno dei dispositivi virtuali.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.releaseActions()

---

dismissAlert

Il comando Dismiss Alert respinge una finestra di dialogo semplice se presente, altrimenti errore. Una richiesta di respingere un prompt utente, che potrebbe non avere necessariamente un pulsante di rifiuto, ha lo stesso effetto dell'accettarlo.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.dismissAlert()

Esempio

examples.js

loading...

View on GitHub

---

acceptAlert

Il comando Accept Alert accetta una finestra di dialogo semplice se presente, altrimenti errore.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.acceptAlert()

---

getAlertText

Il comando Get Alert Text restituisce il messaggio del prompt utente corrente. Se non c'è alcun prompt utente corrente, restituisce un errore.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getAlertText()

Esempio

examples.js

loading...

View on GitHub

Restituisce

• <string> alertText: Il messaggio del prompt utente.

---

sendAlertText

Il comando Send Alert Text imposta il campo di testo di un prompt utente window.prompt al valore dato.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.sendAlertText(text)

Parametri

Nome	Tipo	Dettagli
text	string	stringa da impostare nel prompt

---

takeScreenshot

Il comando Take Screenshot scatta uno screenshot del viewport del contesto di navigazione di livello superiore.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.takeScreenshot()

Restituisce

• <string> screenshot: I dati dell'immagine PNG codificati in base64 che compongono lo screenshot del viewport iniziale.

---

takeElementScreenshot

Il comando Take Element Screenshot scatta uno screenshot della regione visibile racchiusa dal rettangolo di delimitazione di un elemento.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.takeElementScreenshot(elementId, scroll)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)
scroll opzionale	boolean	scorrere in vista l'elemento. Predefinito: true

Restituisce

• <string> screenshot: I dati dell'immagine PNG codificati in base64 che compongono lo screenshot della regione visibile del rettangolo di delimitazione di un elemento dopo che è stato scrollato in vista.

---

getElementComputedRole

Ottiene il ruolo WAI-ARIA calcolato di un elemento.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getElementComputedRole(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Restituisce

• <string> role: Il risultato del calcolo del ruolo WAI-ARIA dell'elemento.

---

getElementComputedLabel

Ottiene il nome accessibile dell'elemento.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getElementComputedLabel(elementId)

Parametri

Nome	Tipo	Dettagli
elementId	String	l'id di un elemento restituito in una precedente chiamata a Find Element(s)

Restituisce

• <string> label: Il risultato di un calcolo del nome e della descrizione accessibili per il nome accessibile dell'elemento.

---

setPermissions

Simula la modifica da parte dell'utente dello stato di autorizzazione di un PermissionDescriptor. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.setPermissions(descriptor, state, oneRealm)

Parametri

Nome	Tipo	Dettagli
descriptor	object	Ogni funzionalità potente ha uno o più aspetti a cui i siti web possono richiedere il permesso di accedere. Per descrivere questi aspetti, ogni caratteristica definisce un sottotipo di PermissionDescriptor per essere il suo tipo di descrittore di autorizzazione. Nota: questa funzionalità non è ancora disponibile in tutti i browser.
state	string	Determina se l'autorizzazione è concessa, negata o richiesta.
oneRealm opzionale	boolean	Se applicare o meno le autorizzazioni a tutti i contesti di esecuzione.

Esempi

// imposta le autorizzazioni midi
browser.setPermissions(
  { name: 'midi', sysex: true },
  'granted' // può essere anche "denied" o "prompt"
);

// imposta le autorizzazioni della clipboard
browser.setPermissions({ name: 'clipboard-read' }, 'granted');
// ora puoi leggere la clipboard tramite, ad esempio
const clipboardText = await browser.execute(() => navigator.clipboard.readText());

---

generateTestReport

Genera un rapporto per i test. Estensione per Reporting API. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.generateTestReport(message, group)

Parametri

Nome	Tipo	Dettagli
message	string	Messaggio da visualizzare nel rapporto.
group opzionale	string	Specifica il gruppo di endpoint a cui consegnare il rapporto.

---

createMockSensor

Crea un sensore simulato per emulare sensori come Ambient Light Sensor. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.createMockSensor(mockSensorType, maxSamplingFrequency, minSamplingFrequency)

Parametri

Nome	Tipo	Dettagli
mockSensorType	string	Tipo di API del sensore da simulare, ad es. 'ambient-light'
maxSamplingFrequency opzionale	number	Un doppio che rappresenta la frequenza in Hz utilizzata per impostare la frequenza massima di campionamento supportata per il sensore simulato associato.
minSamplingFrequency opzionale	number	Un doppio che rappresenta la frequenza in Hz utilizzata per impostare la frequenza minima di campionamento supportata per il sensore simulato associato.

---

getMockSensor

Recupera informazioni su un determinato tipo di sensore simulato. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getMockSensor(type)

Parametri

Nome	Tipo	Dettagli
type	String	Tipo di sensore simulato da cui recuperare le informazioni.

Restituisce

• <object> sensorReading: Valori della lettura del sensore simulato.

---

updateMockSensor

Aggiorna il tipo di sensore simulato. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.updateMockSensor(type, mockSensorType, maxSamplingFrequency, minSamplingFrequency)

Parametri

Nome	Tipo	Dettagli
type	String	Tipo di sensore simulato per cui aggiornare le informazioni.
mockSensorType	string	Tipo di API del sensore da simulare, ad es. 'ambient-light'
maxSamplingFrequency opzionale	number	Un doppio che rappresenta la frequenza in Hz utilizzata per impostare la frequenza massima di campionamento supportata per il sensore simulato associato.
minSamplingFrequency opzionale	number	Un doppio che rappresenta la frequenza in Hz utilizzata per impostare la frequenza minima di campionamento supportata per il sensore simulato associato.

---

deleteMockSensor

Il comando Delete Session chiude tutti i contesti di navigazione di livello superiore associati alla sessione corrente, termina la connessione e infine chiude la sessione corrente. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.deleteMockSensor(type)

Parametri

Nome	Tipo	Dettagli
type	String	Tipo di sensore simulato da eliminare.

---

setTimeZone

Simula il cambio di un fuso orario ai fini del test. Nota: questa funzionalità non è ancora disponibile in tutti i browser.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.setTimeZone(time_zone)

Parametri

Nome	Tipo	Dettagli
time_zone	string	Nome del fuso orario, ad es. Asia/Tokyo

---

addVirtualAuthenticator

Crea un software Virtual Authenticator.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.addVirtualAuthenticator(protocol, transport, hasResidentKey, hasUserVerification, isUserConsenting, isUserVerified, extensions, uvm)

Parametri

Nome	Tipo	Dettagli
protocol opzionale	string	Valori validi: 'ctap1/u2f', 'ctap2', 'ctap2_1'.
transport opzionale	string	Valori validi: 'usb', 'nfc', 'ble' o 'internal'.
hasResidentKey opzionale	boolean	Valori validi: true, false.
hasUserVerification opzionale	boolean	Valori validi: true, false.
isUserConsenting opzionale	boolean	Valori validi: true, false.
isUserVerified opzionale	boolean	Valori validi: Un array contenente identificatori di estensione.
extensions opzionale	string[]	Valori validi: Fino a 3 voci del metodo di verifica dell'utente.
uvm opzionale	object[]

Restituisce

• <string> authenticatorId: Restituisce l'ID stringa dell'autenticatore.

---

removeVirtualAuthenticator

Rimuove un Virtual Authenticator creato in precedenza.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.removeVirtualAuthenticator(authenticatorId)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	id dell'autenticatore

---

addCredential

Inietta una fonte di credenziali di chiave pubblica in un Virtual Authenticator esistente.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.addCredential(authenticatorId, credentialId, isResidentCredential, rpId, privateKey, userHandle, signCount, largeBlob)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	ID dell'autenticatore
credentialId	string	L'ID della credenziale codificato usando la codifica Base64url.
isResidentCredential	boolean	Se impostato a true, viene creata una credenziale rilevabile lato client. Se impostato a false, viene invece creata una credenziale lato server.
rpId	string	L'ID della Relying Party a cui è limitata la credenziale.
privateKey	string	Un pacchetto di chiave asimmetrica contenente una singola chiave privata secondo [RFC5958], codificato usando la codifica Base64url.
userHandle	string	L'userHandle associato alla credenziale codificato usando la codifica Base64url. Questa proprietà potrebbe non essere definita.
signCount	number	Il valore iniziale per un contatore di firma associato alla fonte di credenziali di chiave pubblica.
largeBlob opzionale	string	Il grande blob per credenziale associato alla fonte di credenziali di chiave pubblica, codificato usando la codifica Base64url. Questa proprietà potrebbe non essere definita.

---

getCredentials

Restituisce un oggetto Credential Parameters per ogni fonte di credenziale di chiave pubblica memorizzata in un Virtual Authenticator, indipendentemente dal fatto che siano stati archiviati utilizzando Add Credential o navigator.credentials.create().

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.getCredentials(authenticatorId)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	id dell'autenticatore

Restituisce

• <object[]> credentials: Restituisce un array di credenziali.

---

removeAllCredentials

Rimuove tutte le fonti di credenziali di chiave pubblica memorizzate su un Virtual Authenticator.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.removeAllCredentials(authenticatorId)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	id dell'autenticatore

---

removeCredential

Rimuove una fonte di credenziale di chiave pubblica memorizzata su un Virtual Authenticator.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.removeCredential(authenticatorId, credentialId)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	id dell'autenticatore
credentialId	String	id della credenziale

---

setUserVerified

Il comando di estensione Set User Verified imposta la proprietà isUserVerified sul Virtual Authenticator.

Comando del protocollo WebDriver. Maggiori dettagli possono essere trovati nella documentazione ufficiale del protocollo.

Utilizzo

browser.setUserVerified(authenticatorId)

Parametri

Nome	Tipo	Dettagli
authenticatorId	String	id dell'autenticatore