Protokół WebDriver

newSession

Komenda New Session tworzy nową sesję WebDriver z węzłem końcowym. Jeśli tworzenie nie powiedzie się, zwracany jest błąd utworzenia sesji.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.newSession(capabilities)

Parametry

Nazwa	Typ	Szczegóły
capabilities	object	obiekt JSON, zestaw możliwości, które ostatecznie zostały scalony i dopasowane w algorytmie przetwarzania możliwości

Zwraca

• <Object> session: Obiekt zawierający sessionId i możliwości utworzonej sesji WebDriver.

---

deleteSession

Komenda Delete Session zamyka wszystkie główne konteksty przeglądania powiązane z bieżącą sesją, kończy połączenie i ostatecznie zamyka bieżącą sesję.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.deleteSession(deleteSessionOpts)

Parametry

Nazwa	Typ	Szczegóły
deleteSessionOpts opcjonalny	object	Obiekt zawierający opcje dla komendy deleteSession, np. { shutdownDriver: boolean }

---

status

Komenda Status zwraca informacje o tym, czy zdalny końcówka jest w stanie, w którym może tworzyć nowe sesje i może dodatkowo zawierać dowolne meta informacje, które są specyficzne dla implementacji.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.status()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> status: Obiekt zawierający status sterownika.

---

getTimeouts

Komenda Get Timeouts pobiera czasy oczekiwania związane z bieżącą sesją.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getTimeouts()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> timeouts: Obiekt zawierający czasy oczekiwania dla script, pageLoad i implicit.

---

setTimeouts

Komenda Set Timeouts ustawia czasy oczekiwania powiązane z bieżącą sesją. Limity czasowe, które można kontrolować, są wymienione w tabeli limitów czasu sesji poniżej.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.setTimeouts(implicit, pageLoad, script)

Parametry

Nazwa	Typ	Szczegóły
implicit opcjonalny	number	liczba całkowita w ms dla niejawnego oczekiwania sesji
pageLoad opcjonalny	number	liczba całkowita w ms dla limitu czasu ładowania strony sesji
script opcjonalny	number	liczba całkowita w ms dla limitu czasu skryptu sesji

Przykład

examples.js

loading...

View on GitHub

---

getUrl

Komenda Get Current URL zwraca adres URL obecnego głównego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getUrl()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> url: adres URL dokumentu aktywnego dokumentu w głównym kontekście przeglądania

---

navigateTo

Komenda navigateTo (go) służy do spowodowania nawigacji agenta użytkownika w bieżącym głównym kontekście przeglądania do nowej lokalizacji.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: url. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.navigateTo(url)

Parametry

Nazwa	Typ	Szczegóły
url	string	ciąg reprezentujący bezwzględny URL (zaczynający się od http(s)), ewentualnie zawierający fragment (#...), może być również lokalnym schematem (about: itp.)

Przykład

examples.js

loading...

View on GitHub

---

back

Komenda Back powoduje, że przeglądarka wykonuje jeden krok wstecz we wspólnej historii sesji bieżącego głównego kontekstu przeglądania. Jest to równoważne naciśnięciu przycisku wstecz w pasku narzędzi przeglądarki lub wywołaniu window.history.back.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.back()

Przykład

examples.js

loading...

View on GitHub

---

forward

Komenda Forward powoduje, że przeglądarka wykonuje jeden krok do przodu we wspólnej historii sesji bieżącego głównego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.forward()

Przykład

examples.js

loading...

View on GitHub

---

refresh

Komenda Refresh powoduje, że przeglądarka ponownie ładuje stronę w bieżącym głównym kontekście przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.refresh()

Przykład

examples.js

loading...

View on GitHub

---

getTitle

Komenda Get Title zwraca tytuł dokumentu bieżącego głównego kontekstu przeglądania, równoważne wywołaniu document.title.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getTitle()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> title: Zwraca ciąg, który jest taki sam jak document.title bieżącego głównego kontekstu przeglądania.

---

getWindowHandle

Komenda Get Window Handle zwraca uchwyt okna dla bieżącego głównego kontekstu przeglądania. Może być używany jako argument dla Switch To Window.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getWindowHandle()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> handle: Zwraca ciąg, który jest uchwytem okna dla bieżącego głównego kontekstu przeglądania.

---

closeWindow

Komenda Close Window zamyka bieżący główny kontekst przeglądania. Po zakończeniu, jeśli nie ma więcej otwartych głównych kontekstów przeglądania, sama sesja WebDriver jest zamykana.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.closeWindow()

Przykład

examples.js

loading...

View on GitHub

---

switchToWindow

Komenda Switch To Window służy do wyboru bieżącego głównego kontekstu przeglądania dla bieżącej sesji, czyli tego, który będzie używany do przetwarzania poleceń.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: switchWindow. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.switchToWindow(handle)

Parametry

Nazwa	Typ	Szczegóły
handle	string	ciąg reprezentujący uchwyt okna, powinien być jednym z ciągów zwróconych w wywołaniu getWindowHandles

Przykład

examples.js

loading...

View on GitHub

---

createWindow

Utwórz nowy główny kontekst przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.createWindow(type)

Parametry

Nazwa	Typ	Szczegóły
type	string	Ustaw na 'tab', jeśli nowo utworzone okno dzieli okno na poziomie systemu operacyjnego z bieżącym kontekstem przeglądania, lub 'window' w przeciwnym razie.

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> window: Nowy obiekt okna zawierający 'handle' z wartością uchwytu i 'type' z wartością typu utworzonego okna

---

getWindowHandles

Komenda Get Window Handles zwraca listę uchwytów okien dla każdego otwartego głównego kontekstu przeglądania. Kolejność, w jakiej zwracane są uchwyty okien, jest dowolna.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getWindowHandles()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <String[]> handles: Tablica będąca listą uchwytów okien.

---

printPage

Komenda Print Page renderuje dokument do paginowanego dokumentu PDF. Uwaga: Chrome obecnie obsługuje to tylko w trybie headless, zobacz crbug753118).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
orientation opcjonalny	string	orientacja strony. Domyślnie: portrait
scale opcjonalny	number	skala strony. Domyślnie: 1
background opcjonalny	boolean	tło strony. Domyślnie: false
width opcjonalny	number	szerokość strony w cm. Domyślnie: 21.59 ze strony
height opcjonalny	number	wysokość strony w cm. Domyślnie: 27.94 ze strony
top opcjonalny	number	margines strony w cm od górnego marginesu. Domyślnie: 1
bottom opcjonalny	number	margines strony w cm od dolnego marginesu. Domyślnie: 1
left opcjonalny	number	margines strony w cm od lewego marginesu. Domyślnie: 1
right opcjonalny	number	margines strony w cm od prawego marginesu. Domyślnie: 1
shrinkToFit opcjonalny	boolean	zmniejsz pdf, aby dopasować do strony. Domyślnie: true
pageRanges opcjonalny	object[]	zakresy stron. Domyślnie []

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> pdf: Reprezentacja PDF dokumentu w formacie base64.

---

switchToFrame

Komenda Switch To Frame służy do wyboru bieżącego głównego kontekstu przeglądania lub kontekstu przeglądania potomnego bieżącego kontekstu przeglądania, który będzie używany jako bieżący kontekst przeglądania dla kolejnych poleceń.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

ostrożnie

Ta komenda protokołu jest przestarzała
Ta komenda jest przestarzała i zachęcamy wszystkich do używania zamiast niej switchFrame do przełączania ramek. Więcej informacji o tej komendzie na https://webdriver.io/docs/api/browser/switchFrame.

Użycie

browser.switchToFrame(id)

Parametry

Nazwa	Typ	Szczegóły
id	number, object, null	jeden z trzech możliwych typów: null: reprezentuje kontekst przeglądania najwyższego poziomu (tzn. nie iframe), Liczba, reprezentująca indeks obiektu window odpowiadającego ramce, obiekt Element otrzymany za pomocą findElement.

Przykład

examples.js

loading...

View on GitHub

---

switchToParentFrame

Komenda Switch to Parent Frame ustawia bieżący kontekst przeglądania dla przyszłych poleceń jako rodzica bieżącego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.switchToParentFrame()

Przykład

examples.js

loading...

View on GitHub

---

getWindowRect

Komenda Get Window Rect zwraca rozmiar i pozycję na ekranie okna systemu operacyjnego odpowiadającego bieżącemu głównemu kontekstowi przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: getWindowSize. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getWindowRect()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> windowRect: Reprezentacja JSON obiektu "okno prostokąt". Ma 4 właściwości: x, y, width i height.

---

setWindowRect

Komenda Set Window Rect zmienia rozmiar i pozycję okna systemu operacyjnego odpowiadającego bieżącemu głównemu kontekstowi przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: setWindowSize. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
x	number, null	atrybut screenX obiektu window
y	number, null	atrybut screenY obiektu window
width	number, null	szerokość wymiarów zewnętrznych najwyższego kontekstu przeglądania, włącznie z elementami interfejsu przeglądarki itp...
height	number, null	wysokość wymiarów zewnętrznych najwyższego kontekstu przeglądania, włącznie z elementami interfejsu przeglądarki itp...

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> windowRect: Reprezentacja JSON obiektu "okno prostokąt" opartego na nowym stanie okna.

---

maximizeWindow

Komenda Maximize Window wywołuje operację "maksymalizacji" specyficzną dla menedżera okien, jeśli istnieje, na oknie zawierającym bieżący główny kontekst przeglądania. Zazwyczaj zwiększa to okno do maksymalnego dostępnego rozmiaru bez przechodzenia na pełny ekran.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.maximizeWindow()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> windowRect: Reprezentacja JSON obiektu "okno prostokąt" opartego na nowym stanie okna.

---

minimizeWindow

Komenda Minimize Window wywołuje operację "minimalizacji" specyficzną dla menedżera okien, jeśli istnieje, na oknie zawierającym bieżący główny kontekst przeglądania. Zazwyczaj ukrywa to okno w zasobniku systemowym.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.minimizeWindow()

Zwraca

• <Object> windowRect: Reprezentacja JSON obiektu "okno prostokąt" (nowego) bieżącego głównego kontekstu przeglądania.

---

fullscreenWindow

Komenda Fullscreen Window wywołuje operację "pełny ekran" specyficzną dla menedżera okien, jeśli istnieje, na oknie zawierającym bieżący główny kontekst przeglądania. Zazwyczaj zwiększa to okno do rozmiaru wyświetlacza fizycznego i może ukryć elementy interfejsu przeglądarki, takie jak paski narzędzi.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.fullscreenWindow()

Zwraca

• <Object> windowRect: Reprezentacja JSON obiektu "okno prostokąt" (nowego) bieżącego głównego kontekstu przeglądania.

---

findElement

Komenda Find Element służy do znalezienia elementu w bieżącym kontekście przeglądania, który może być używany do przyszłych poleceń. Ta komenda zwraca reprezentację JSON elementu, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: $. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElement(using, value)

Parametry

Nazwa	Typ	Szczegóły
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object> element: Reprezentacja JSON obiektu elementu, np. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromShadowRoot

Komenda Find Element From Shadow Root służy do znalezienia elementu w korzeniu cienia elementu, który może być używany do przyszłych poleceń. Ta komenda zwraca reprezentację JSON elementu, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: shadow$. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElementFromShadowRoot(shadowId, using, value)

Parametry

Nazwa	Typ	Szczegóły
shadowId	String	identyfikator elementu root shadow
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object> element: Reprezentacja JSON obiektu elementu shadow, np. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElements

Komenda Find Elements służy do znalezienia elementów w bieżącym kontekście przeglądania, które mogą być używane do przyszłych poleceń. Ta komenda zwraca tablicę reprezentacji JSON elementów, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO (Zobacz findElement).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: $$. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElements(using, value)

Parametry

Nazwa	Typ	Szczegóły
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object[]> elements: (Możliwie pusta) lista JSON reprezentacji obiektu elementu, np. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

findElementsFromShadowRoot

Komenda Find Elements służy do znalezienia elementów w korzeniu cienia elementu, które mogą być używane do przyszłych poleceń. Ta komenda zwraca tablicę reprezentacji JSON elementów, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO (Zobacz findElement).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: shadow$$. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElementsFromShadowRoot(shadowId, using, value)

Parametry

Nazwa	Typ	Szczegóły
shadowId	String	identyfikator elementu root shadow
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object[]> elements: (Możliwie pusta) lista JSON reprezentacji obiektu elementu, np. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromElement

Komenda Find Element From Element służy do znalezienia elementu z elementu webowego w bieżącym kontekście przeglądania, który może być używany do przyszłych poleceń. Ta komenda zwraca reprezentację JSON elementu, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO (Zobacz findElement).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: $. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElementFromElement(elementId, using, value)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object> element: Reprezentacja JSON obiektu elementu, np. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementsFromElement

Komenda Find Elements From Element służy do znalezienia elementów z elementu webowego w bieżącym kontekście przeglądania, które mogą być używane do przyszłych poleceń. Ta komenda zwraca tablicę reprezentacji JSON elementów, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO (Zobacz findElement).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: $$. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.findElementsFromElement(elementId, using, value)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
using	string	ważna strategia lokalizacji elementu
value	string	rzeczywisty selektor, który będzie używany do znalezienia elementu

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <object[]> elements: (Możliwie pusta) lista JSON reprezentacji obiektu elementu, np. [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

getElementShadowRoot

Pobierz obiekt shadow root elementu. Obiekt wynikowy może być używany do pobierania elementów w tym shadow root za pomocą np. findElementFromShadowRoots lub findElementsFromShadowRoots.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: shadow$. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getElementShadowRoot(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> shadowRoot: Reprezentacja JSON elementu shadow root, np. { 'shadow-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

getActiveElement

Get Active Element zwraca aktywny element dokumentu bieżącego kontekstu przeglądania. Ta komenda zwraca reprezentację JSON elementu, którą można przekazać do komendy $, aby przekształcić referencję na rozszerzony element WebdriverIO (Zobacz findElement).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getActiveElement()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> element: Reprezentacja JSON obiektu elementu, np. { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

isElementSelected

Is Element Selected określa, czy wskazany element jest zaznaczony czy nie. Ta operacja ma sens tylko na elementach wejściowych typu Checkbox i Radio Button lub elementach option.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: isSelected. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.isElementSelected(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Boolean> isSelected: true lub false w zależności od stanu zaznaczenia.

---

isElementDisplayed

Is Element Displayed określa widoczność elementu, którą określa to, co jest postrzegalne przez ludzkie oko. W tym kontekście, wyświetlanie elementu nie odnosi się do właściwości stylów visibility lub display.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: isDisplayed. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.isElementDisplayed(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Boolean> isDisplayed: true lub false w zależności od stanu widoczności.

---

getElementAttribute

Komenda Get Element Attribute zwróci atrybut elementu webowego.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: getAttribute. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getElementAttribute(elementId, name)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
name	String	nazwa wartości atrybutu do pobrania

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> attribute: Nazwany atrybut elementu.

---

getElementProperty

Komenda Get Element Property zwróci wynik uzyskania właściwości elementu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: getProperty. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getElementProperty(elementId, name)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
name	String	nazwa właściwości atrybutu do pobrania

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> property: Nazwana właściwość elementu, uzyskana przez wywołanie GetOwnProperty na obiekcie elementu.

---

getElementCSSValue

Komenda Get Element CSS Value pobiera obliczoną wartość podanej właściwości CSS danego elementu webowego.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: getCSSProperty. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getElementCSSValue(elementId, propertyName)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
propertyName	String	nazwa właściwości CSS do pobrania

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> cssValue: Obliczona wartość parametru odpowiadającego nazwie właściwości z deklaracji stylów elementu (chyba że typ dokumentu to xml, w którym to przypadku wartość zwracana jest po prostu pustym ciągiem).

---

getElementText

Komenda Get Element Text ma za zadanie zwrócić tekst elementu "tak jak jest renderowany". Renderowany tekst elementu jest również używany do lokalizowania elementów przez ich tekst linku i częściowy tekst linku.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getElementText(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> text: Widoczny tekst elementu (włącznie z elementami potomnymi), zgodnie z algorytmem zdefiniowanym w Selenium Atoms dla bot.dom.getVisibleText.

---

getElementTagName

Komenda Get Element Tag Name zwraca kwalifikowaną nazwę elementu danego elementu webowego.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: getTagName. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.getElementTagName(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> text: Atrybut tagName elementu.

---

getElementRect

Komenda Get Element Rect zwraca wymiary i współrzędne danego elementu webowego.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następujących wygodnych metodach: getSize, getLocation. Zalecane jest używanie tych komend zamiast protokołu.

Użycie

browser.getElementRect(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> elementRect: Obiekt JSON reprezentujący pozycję i prostokąt ograniczający elementu.

---

isElementEnabled

Is Element Enabled określa, czy wskazany element jest włączony czy nie. Ta operacja ma sens tylko na kontrolkach formularzy.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: isEnabled. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.isElementEnabled(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Boolean> isEnabled: Jeśli element znajduje się w dokumencie xml lub jest wyłączoną kontrolką formularza: false, w przeciwnym razie true.

---

elementClick

Komenda Element Click przewija do widoku elementu, jeśli nie jest już interaktywny wskaźnikiem, i klika jego widoczny punkt środkowy. Jeśli punkt środkowy elementu jest przysłonięty przez inny element, zwracany jest błąd przechwyconego kliknięcia elementu. Jeśli element jest poza widocznym obszarem, zwracany jest błąd elementu nieinteraktywnego.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: click. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.elementClick(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

---

elementClear

Komenda Element Clear przewija do widoku edytowalny lub resetowalny element, a następnie próbuje wyczyścić jego wybrane pliki lub zawartość tekstową.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: clearValue. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.elementClear(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Przykład

examples.js

loading...

View on GitHub

---

elementSendKeys

Komenda Element Send Keys przewija do widoku element kontrolki formularza, a następnie wysyła podane klawisze do elementu. W przypadku, gdy element nie jest interaktywny za pomocą klawiatury, zwracany jest błąd elementu nieinteraktywnego.

Stan wejścia klawiatury używany do wprowadzania danych może być czyszczony w trakcie "pisania" przez wysłanie klawisza null, który jest U+E000 (NULL).

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następujących wygodnych metodach: addValue, setValue. Zalecane jest używanie tych komend zamiast protokołu.

Użycie

browser.elementSendKeys(elementId, text)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
text	string	ciąg do wysłania jako naciśnięcia klawiszy do elementu

Przykład

examples.js

loading...

View on GitHub

---

getPageSource

Komenda Get Page Source zwraca serializację ciągową DOM aktywnego dokumentu bieżącego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getPageSource()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> pageSource: DOM aktywnego dokumentu bieżącego kontekstu przeglądania

---

executeScript

Komenda Execute Script wykonuje funkcję JavaScript w kontekście bieżącego kontekstu przeglądania i zwraca wartość zwróconą przez funkcję.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: execute. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.executeScript(script, args)

Parametry

Nazwa	Typ	Szczegóły
script	string	ciąg, treść funkcji Javascript, którą chcesz wykonać
args	string, object, number, boolean, null, undefined[]	tablica wartości JSON, które zostaną zdeserializowane i przekazane jako argumenty do funkcji

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <*> result: Albo wartość zwrócona przez skrypt, spełnienie obietnicy zwróconej przez skrypt, albo błąd, który był powodem odrzucenia obietnicy zwróconej przez skrypt.

---

executeAsyncScript

Komenda Execute Async Script powoduje wykonanie JavaScriptu jako funkcji anonimowej. W przeciwieństwie do komendy Execute Script, wynik funkcji jest ignorowany. Zamiast tego, dodatkowy argument jest dostarczany jako ostatni argument funkcji. Jest to funkcja, która po wywołaniu zwraca jej pierwszy argument jako odpowiedź.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

informacja

Ta komenda protokołu jest osadzona w następującej wygodnej metodzie: executeAsync. Zalecane jest używanie tej komendy zamiast protokołu.

Użycie

browser.executeAsyncScript(script, args)

Parametry

Nazwa	Typ	Szczegóły
script	string	ciąg, treść funkcji Javascript, którą chcesz wykonać
args	string, object, number, boolean, null, undefined[]	tablica wartości JSON, które zostaną zdeserializowane i przekazane jako argumenty do funkcji

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <*> result: Albo wartość zwrócona przez skrypt, spełnienie obietnicy zwróconej przez skrypt, albo błąd, który był powodem odrzucenia obietnicy zwróconej przez skrypt.

---

getAllCookies

Komenda Get All Cookies zwraca wszystkie ciasteczka powiązane z adresem aktywnego dokumentu bieżącego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getAllCookies()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object[]> cookies: Lista zserializowanych ciasteczek. Każde zserializowane ciasteczko ma kilka opcjonalnych pól, które mogą lub nie być zwrócone oprócz name i value.

---

addCookie

Komenda Add Cookie dodaje pojedyncze ciasteczko do magazynu ciasteczek powiązanego z adresem aktywnego dokumentu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.addCookie(cookie)

Parametry

Nazwa	Typ	Szczegóły
cookie	object	Obiekt JSON reprezentujący ciasteczko. Musi mieć co najmniej pola name i value, a może mieć więcej, w tym czas wygaśnięcia i tak dalej

Przykład

examples.js

loading...

View on GitHub

---

deleteAllCookies

Komenda Delete All Cookies umożliwia usunięcie wszystkich ciasteczek powiązanych z adresem aktywnego dokumentu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.deleteAllCookies()

Przykład

examples.js

loading...

View on GitHub

---

getNamedCookie

Komenda Get Named Cookie zwraca ciasteczko o żądanej nazwie z powiązanych ciasteczek w magazynie ciasteczek aktywnego dokumentu bieżącego kontekstu przeglądania. Jeśli nie znaleziono ciasteczka, zwracany jest błąd braku takiego ciasteczka.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getNamedCookie(name)

Parametry

Nazwa	Typ	Szczegóły
name	String	nazwa ciasteczka do pobrania

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <Object> cookie: Zserializowane ciasteczko, z polami name i value. Istnieje kilka opcjonalnych pól, takich jak path, domain i expiry-time, które również mogą być obecne.

---

deleteCookie

Komenda Delete Cookie umożliwia usunięcie pojedynczego ciasteczka według parametru nazwy lub wszystkich ciasteczek powiązanych z adresem aktywnego dokumentu, jeśli nazwa jest niezdefiniowana.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.deleteCookie(name)

Parametry

Nazwa	Typ	Szczegóły
name	String	nazwa ciasteczka do usunięcia

Przykład

examples.js

loading...

View on GitHub

---

performActions

Komenda Perform Actions służy do wykonywania złożonych akcji użytkownika. Zobacz specyfikację dla więcej szczegółów.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.performActions(actions)

Parametry

Nazwa	Typ	Szczegóły
actions	object[]	lista obiektów, z których każdy reprezentuje źródło wejściowe i powiązane z nim akcje

---

releaseActions

Komenda Release Actions służy do zwolnienia wszystkich klawiszy i przycisków wskaźnika, które są obecnie wciśnięte. Powoduje to generowanie zdarzeń, jakby stan został zwolniony przez wyraźną serię akcji. Czyści również cały wewnętrzny stan urządzeń wirtualnych.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.releaseActions()

---

dismissAlert

Komenda Dismiss Alert odrzuca proste okno dialogowe, jeśli jest obecne, w przeciwnym razie błąd. Żądanie odrzucenia monitu alertu użytkownika, który może nie mieć koniecznie przycisku odrzucenia, ma taki sam efekt jak zaakceptowanie go.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.dismissAlert()

Przykład

examples.js

loading...

View on GitHub

---

acceptAlert

Komenda Accept Alert akceptuje proste okno dialogowe, jeśli jest obecne, w przeciwnym razie błąd.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.acceptAlert()

---

getAlertText

Komenda Get Alert Text zwraca wiadomość bieżącego monitu użytkownika. Jeśli nie ma bieżącego monitu użytkownika, zwraca błąd.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getAlertText()

Przykład

examples.js

loading...

View on GitHub

Zwraca

• <string> alertText: Wiadomość monitu użytkownika.

---

sendAlertText

Komenda Send Alert Text ustawia pole tekstowe monitu użytkownika window.prompt na podaną wartość.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.sendAlertText(text)

Parametry

Nazwa	Typ	Szczegóły
text	string	ciąg do ustawienia w monicie

---

takeScreenshot

Komenda Take Screenshot wykonuje zrzut ekranu obszaru widocznego głównego kontekstu przeglądania.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.takeScreenshot()

Zwraca

• <string> screenshot: Dane obrazu PNG zakodowane w base64, składające się ze zrzutu ekranu początkowego obszaru widocznego.

---

takeElementScreenshot

Komenda Take Element Screenshot wykonuje zrzut ekranu widocznego obszaru objętego prostokątem ograniczającym elementu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.takeElementScreenshot(elementId, scroll)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)
scroll opcjonalny	boolean	przewiń do widoku element. Domyślnie: true

Zwraca

• <string> screenshot: Dane obrazu PNG zakodowane w base64, składające się ze zrzutu ekranu widocznego obszaru prostokąta ograniczającego elementu po przewinięciu go do widoku.

---

getElementComputedRole

Pobierz obliczoną rolę WAI-ARIA elementu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getElementComputedRole(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Zwraca

• <string> role: Wynik obliczenia roli WAI-ARIA elementu.

---

getElementComputedLabel

Pobierz dostępną nazwę elementu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getElementComputedLabel(elementId)

Parametry

Nazwa	Typ	Szczegóły
elementId	String	identyfikator elementu zwrócony w poprzednim wywołaniu Find Element(s)

Zwraca

• <string> label: Wynik obliczeń Accessible Name and Description Computation dla Accessible Name elementu.

---

setPermissions

Symuluje modyfikację przez użytkownika stanu uprawnienia PermissionDescriptor. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.setPermissions(descriptor, state, oneRealm)

Parametry

Nazwa	Typ	Szczegóły
descriptor	object	Każda potężna funkcja ma jeden lub więcej aspektów, do których witryny mogą prosić o dostęp. Aby opisać te aspekty, każda funkcja definiuje podtyp PermissionDescriptor jako swój typ deskryptora uprawnień. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.
state	string	Określa, czy uprawnienie jest przyznane, odrzucone lub wymagane zapytania.
oneRealm opcjonalny	boolean	Czy stosować uprawnienia do wszystkich kontekstów wykonania, czy nie.

Przykłady

// ustawienie uprawnień midi
browser.setPermissions(
  { name: 'midi', sysex: true },
  'granted' // może być też "denied" lub "prompt"
);

// ustawienie uprawnień schowka
browser.setPermissions({ name: 'clipboard-read' }, 'granted');
// teraz możesz odczytać schowek poprzez, np.
const clipboardText = await browser.execute(() => navigator.clipboard.readText());

---

generateTestReport

Generuje raport do testowania. Rozszerzenie dla Reporting API. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.generateTestReport(message, group)

Parametry

Nazwa	Typ	Szczegóły
message	string	Wiadomość do wyświetlenia w raporcie.
group opcjonalny	string	Określa grupę końcową, do której dostarczyć raport.

---

createMockSensor

Tworzy symulowany czujnik do emulacji czujników, takich jak czujnik światła otoczenia. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.createMockSensor(mockSensorType, maxSamplingFrequency, minSamplingFrequency)

Parametry

Nazwa	Typ	Szczegóły
mockSensorType	string	Typ API czujnika do symulacji, np. 'ambient-light'
maxSamplingFrequency opcjonalny	number	Liczba zmiennoprzecinkowa reprezentująca częstotliwość w Hz, która jest używana do ustawienia maksymalnej obsługiwanej częstotliwości próbkowania dla powiązanego czujnika symulowanego.
minSamplingFrequency opcjonalny	number	Liczba zmiennoprzecinkowa reprezentująca częstotliwość w Hz, która jest używana do ustawienia minimalnej obsługiwanej częstotliwości próbkowania dla powiązanego czujnika symulowanego.

---

getMockSensor

Pobiera informacje o danym typie symulowanego czujnika. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getMockSensor(type)

Parametry

Nazwa	Typ	Szczegóły
type	String	Typ czujnika symulowanego, z którego pobierać informacje.

Zwraca

• <object> sensorReading: Wartości odczytu czujnika symulowanego.

---

updateMockSensor

Aktualizuje typ czujnika symulowanego. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
type	String	Typ czujnika symulowanego, dla którego zaktualizować informacje.
mockSensorType	string	Typ API czujnika do symulacji, np. 'ambient-light'
maxSamplingFrequency opcjonalny	number	Liczba zmiennoprzecinkowa reprezentująca częstotliwość w Hz, która jest używana do ustawienia maksymalnej obsługiwanej częstotliwości próbkowania dla powiązanego czujnika symulowanego.
minSamplingFrequency opcjonalny	number	Liczba zmiennoprzecinkowa reprezentująca częstotliwość w Hz, która jest używana do ustawienia minimalnej obsługiwanej częstotliwości próbkowania dla powiązanego czujnika symulowanego.

---

deleteMockSensor

Komenda Delete Session zamyka wszystkie główne konteksty przeglądania powiązane z bieżącą sesją, kończy połączenie i ostatecznie zamyka bieżącą sesję. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.deleteMockSensor(type)

Parametry

Nazwa	Typ	Szczegóły
type	String	Typ czujnika symulowanego do usunięcia.

---

setTimeZone

Symuluje zmianę strefy czasowej do celów testowania. Uwaga: ta funkcja nie została jeszcze zaimplementowana we wszystkich przeglądarkach.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.setTimeZone(time_zone)

Parametry

Nazwa	Typ	Szczegóły
time_zone	string	Nazwa strefy czasowej, np. Asia/Tokyo

---

addVirtualAuthenticator

Tworzy programowy Wirtualny Uwierzytelniacz.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
protocol opcjonalny	string	Prawidłowe wartości: 'ctap1/u2f', 'ctap2', 'ctap2_1'.
transport opcjonalny	string	Prawidłowe wartości: 'usb', 'nfc', 'ble' lub 'internal'.
hasResidentKey opcjonalny	boolean	Prawidłowe wartości: true, false.
hasUserVerification opcjonalny	boolean	Prawidłowe wartości: true, false.
isUserConsenting opcjonalny	boolean	Prawidłowe wartości: true, false.
isUserVerified opcjonalny	boolean	Prawidłowe wartości: tablica zawierająca identyfikatory rozszerzeń.
extensions opcjonalny	string[]	Prawidłowe wartości: Do 3 wpisów User Verification Method.
uvm opcjonalny	object[]

Zwraca

• <string> authenticatorId: Zwraca ID uwierzytelniacza jako ciąg znaków.

---

removeVirtualAuthenticator

Usuwa wcześniej utworzony Wirtualny Uwierzytelniacz.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.removeVirtualAuthenticator(authenticatorId)

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	identyfikator uwierzytelniacza

---

addCredential

Wprowadza źródło poświadczenia klucza publicznego do istniejącego Wirtualnego Uwierzytelniacza.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

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

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	ID uwierzytelniacza
credentialId	string	ID poświadczenia zakodowane przy użyciu Base64url Encoding.
isResidentCredential	boolean	Jeśli ustawione na true, tworzone jest poświadczenie wykrywalne po stronie klienta. Jeśli ustawione na false, zamiast tego tworzone jest poświadczenie po stronie serwera.
rpId	string	ID Relying Party, do którego poświadczenie jest przypisane.
privateKey	string	Pakiet klucza asymetrycznego zawierający pojedynczy klucz prywatny zgodnie z [RFC5958], zakodowany przy użyciu Base64url Encoding.
userHandle	string	Uchwyt użytkownika powiązany z poświadczeniem zakodowanym przy użyciu Base64url Encoding. Ta właściwość może nie być zdefiniowana.
signCount	number	Początkowa wartość licznika podpisów powiązanego ze źródłem klucza publicznego.
largeBlob opcjonalny	string	Duży, indywidualny dla poświadczenia blob powiązany ze źródłem klucza publicznego, zakodowany przy użyciu Base64url Encoding. Ta właściwość może nie być zdefiniowana.

---

getCredentials

Zwraca jeden obiekt Credential Parameters dla każdego źródła klucza publicznego przechowywanego w Wirtualnym Uwierzytelniaczu, niezależnie od tego, czy zostały przechowane za pomocą Add Credential czy navigator.credentials.create().

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.getCredentials(authenticatorId)

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	identyfikator uwierzytelniacza

Zwraca

• <object[]> credentials: Zwraca tablicę poświadczeń.

---

removeAllCredentials

Usuwa wszystkie źródła klucza publicznego przechowywane w Wirtualnym Uwierzytelniaczu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.removeAllCredentials(authenticatorId)

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	identyfikator uwierzytelniacza

---

removeCredential

Usuwa źródło klucza publicznego przechowywane w Wirtualnym Uwierzytelniaczu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.removeCredential(authenticatorId, credentialId)

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	identyfikator uwierzytelniacza
credentialId	String	identyfikator poświadczenia

---

setUserVerified

Komenda rozszerzenia Set User Verified ustawia właściwość isUserVerified na Wirtualnym Uwierzytelniaczu.

Komenda protokołu WebDriver. Więcej szczegółów można znaleźć w oficjalnej dokumentacji protokołu.

Użycie

browser.setUserVerified(authenticatorId)

Parametry

Nazwa	Typ	Szczegóły
authenticatorId	String	identyfikator uwierzytelniacza