Skip to content

Browser Automation

Full web automation: navigation, interaction, data extraction, screenshots, and performance monitoring.

38 modules

ModuleDescription
Kliknij elementKliknij element na stronie
Zamknij przegladarkeZamknij instancje przegladarki i zwolnij zasoby
Przechwytuj konsolePrzechwytuj logi konsoli przegladarki (bledy, ostrzezenia, informacje)
Zarzadzaj ciasteczkamiPobierz, ustaw lub wyczysc ciasteczka przegladarki
Obsluz okno dialogoweObsluguj okna dialogowe alert, confirm i prompt
Pobierz plikPobierz plik z przegladarki
Przeciagnij i upuscPrzeciagnij i upusc elementy
Symuluj UrządzenieSymuluj urządzenie lub ustaw niestandardowy widok
Upewnij się, że przeglądarkaUpewnij się, że istnieje sesja przeglądarki (ponowne użycie lub uruchomienie)
Wykonaj JavaScriptWykonaj kod JavaScript w kontekscie strony
Wyodrebnij daneWyodrebnij ustrukturyzowane dane ze strony
Znajdz elementyZnajdz elementy na stronie i zwroc liste ID elementow
Wypełnij formularzInteligentne wypełnianie formularzy z automatycznym wykrywaniem pól
Przelacz ramkePrzelacz na kontekst iframe lub frame
Symuluj geolokalizacjeSymuluj geolokalizacje przegladarki
Przejdz do URLPrzejdz do okreslonego URL
Najedz na elementNajedz myszka na element
Uruchom przegladarkeUruchom nowa instancje przegladarki z Playwright
Nawigacja w HistoriiNawiguj w historii przeglądarki (wstecz, do przodu, odśwież)
Monitor sieciMonitoruj i przechwytuj zadania sieciowe
Lista StronWyświetl wszystkie otwarte strony/karty przeglądarki
Paginuj i wyodrębnijAutomatyczne paginowanie przez strony i wyodrębnianie danych
Wygeneruj PDFWygeneruj PDF z biezacej strony
Metryki WydajnościZbieraj metryki wydajności przeglądarki
Nacisnij klawiszNacisnij klawisz klawiatury
Nagrywaj akcjeNagrywaj akcje uzytkownika jako przeplyw
Zwolnij przeglądarkęZwolnij sesję przeglądarki (zamknij tylko, jeśli posiadasz)
Zrob zrzut ekranuZrob zrzut ekranu biezacej strony
Przewin stronePrzewin strone do elementu, pozycji lub kierunku
Wybierz opcjeWybierz opcje z elementu rozwijanego
Zrzut DOMZrób zrzut DOM bieżącej strony
Magazyn przegladarkiDostep do localStorage i sessionStorage
Zarzadzaj kartamiTworzenie, przelaczanie i zamykanie kart przegladarki
Ślad PrzeglądarkiRozpocznij, zatrzymaj lub zapisz ślady wydajności przeglądarki
Wpisz tekstWpisz tekst w pole wejsciowe
Przeslij plikPrzeslij plik do elementu wejscia pliku
Ustaw widokPobierz lub ustaw rozmiar widoku przeglądarki
CzekajCzekaj przez okreslony czas lub az pojawi sie element

Modules

Kliknij element

browser.click

Kliknij element na stronie

Parameters:

NameTypeRequiredDefaultDescription
click_methodselect (text, button, id, selector)NotextChoose the easiest way to identify the element you want to click
targetstringNo-e.g. "Submit", "Next Page", "Login"
selectorstringNo-CSS selector, XPath, or text selector
buttonselect (left, right, middle)NoleftWhich mouse button to use for clicking
click_countnumberNo1Number of clicks (2 for double-click, 3 for triple-click)
forcebooleanNoFalseForce click even if element is not actionable (covered, invisible)
modifiersarrayNo-Modifier keys to hold during click
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
browserobjectBrowser session (pass-through for chaining)
statusstringStatus operacji (sukces/blad)
selectorstringStatus operacji (sukces/blad)
methodstringClick method used

Example: Example

yaml
click_method: text
target: Submit

Example: Example

yaml
click_method: id
target: login-button

Example: Example

yaml
click_method: selector
selector: #submit-button

Zamknij przegladarke

browser.close

Zamknij instancje przegladarki i zwolnij zasoby

Parameters:

NameTypeRequiredDefaultDescription
_no_paramsbooleanNoTrueThis module requires no parameters

Output:

FieldTypeDescription
statusstringZamknij instancje przegladarki
messagestringZamknij instancje przegladarki

Example: Example

yaml

Przechwytuj konsole

browser.console

Przechwytuj logi konsoli przegladarki (bledy, ostrzezenia, informacje)

Parameters:

NameTypeRequiredDefaultDescription
levelselect (all, error, warning, info, log)NoallFilter console messages by level
timeoutnumberNo5000Maximum time to wait in milliseconds
clear_existingbooleanNoFalseClear existing messages before capturing

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
messagesarrayStatus operacji (sukces/blad)
countnumberStatus operacji (sukces/blad)

Example: Example

yaml
timeout: 3000

Example: Example

yaml
level: error
timeout: 5000

Zarzadzaj ciasteczkami

browser.cookies

Pobierz, ustaw lub wyczysc ciasteczka przegladarki

Parameters:

NameTypeRequiredDefaultDescription
actionselect (get, set, clear, delete)Yes-Action to perform on the storage
namestringNo-Name of the cookie
valuestringNo-Value of the cookie
domainstringNo-Cookie domain
pathstringNo/Cookie path
securebooleanNoFalseWhether cookie is secure (HTTPS only)
httpOnlybooleanNoFalseWhether cookie is HTTP only
expiresnumberNo-Cookie expiration time (Unix timestamp)

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
cookiesarrayStatus operacji (sukces/blad)
countnumberStatus operacji (sukces/blad)

Example: Example

yaml
action: get

Example: Example

yaml
action: get
name: session_id

Example: Example

yaml
action: set
name: user_pref
value: dark_mode
domain: example.com

Example: Example

yaml
action: clear

Obsluz okno dialogowe

browser.dialog

Obsluguj okna dialogowe alert, confirm i prompt

Parameters:

NameTypeRequiredDefaultDescription
actionselect (accept, dismiss, listen)Yes-How to respond to the dialog
prompt_textstringNo-Text to enter in prompt dialog (for accept action)
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
messagestringStatus operacji (sukces/blad)
typestringStatus operacji (sukces/blad)
default_valuestringWiadomosc wyniku opisujaca rezultat

Example: Example

yaml
action: accept

Example: Example

yaml
action: dismiss

Example: Example

yaml
action: accept
prompt_text: Hello World

Example: Example

yaml
action: listen
timeout: 5000

Pobierz plik

browser.download

Pobierz plik z przegladarki

Parameters:

NameTypeRequiredDefaultDescription
selectorstringNo-CSS selector, XPath, or text selector to find the element
save_pathstringYes-Path where to save the downloaded file
timeout_msnumberNo60000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
pathstringStatus operacji (sukces/blad)
filenamestringStatus operacji (sukces/blad)
sizenumberSciezka do pliku lub zasobu

Example: Example

yaml
selector: #download-btn
save_path: /downloads/report.pdf

Example: Example

yaml
selector: a.download
save_path: /downloads/large-file.zip
timeout_ms: 120000

Przeciagnij i upusc

browser.drag

Przeciagnij i upusc elementy

Parameters:

NameTypeRequiredDefaultDescription
sourcestringYes-CSS selector, XPath, or text selector to find the element
targetstringYes-CSS selector, XPath, or text selector to find the element
source_positionobjectNo-Position within source element {x, y} as percentages
target_positionobjectNo-Position within target element {x, y} as percentages
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringPozycja w elemencie docelowym {x, y} jako procenty
sourcestringPozycja w elemencie docelowym {x, y} jako procenty
targetstringStatus operacji (sukces/blad)

Example: Example

yaml
source: #item1
target: #dropzone

Example: Example

yaml
source: .draggable
target: .container
target_position: {"x": 0.5, "y": 0.5}

Symuluj Urządzenie

browser.emulate

Symuluj urządzenie lub ustaw niestandardowy widok

Parameters:

NameTypeRequiredDefaultDescription
deviceselect (iphone_12, iphone_14, iphone_14_pro_max, iphone_se, pixel_7, pixel_5, galaxy_s21, galaxy_s23, ipad_pro, ipad_mini, galaxy_tab_s8, desktop_chrome, desktop_firefox, desktop_safari, desktop_edge, laptop, macbook_pro, custom)Yes-Nazwa urządzenia do symulacji (np. iPhone 13)
widthnumberNo-Szerokość widoku w pikselach
heightnumberNo-Wysokość widoku w pikselach
user_agentstringNo-Niestandardowy ciąg agenta użytkownika
is_mobilebooleanNo-Czy symulować urządzenie mobilne
has_touchbooleanNo-Czy urządzenie obsługuje dotyk
device_scale_factornumberNo-Współczynnik skali pikseli urządzenia

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
devicestringNazwa urządzenia, które było symulowane
viewportobjectAktualne wymiary widoku
is_mobilebooleanCzy symulacja mobilna jest aktywna

Example: Example

yaml
device: iphone_14

Example: Example

yaml
device: ipad_pro

Example: Example

yaml
device: custom
width: 400
height: 800
is_mobile: true
has_touch: true
device_scale_factor: 2

Example: Example

yaml
device: desktop_chrome
user_agent: CustomBot/1.0

Upewnij się, że przeglądarka

browser.ensure

Upewnij się, że istnieje sesja przeglądarki (ponowne użycie lub uruchomienie)

Parameters:

NameTypeRequiredDefaultDescription
headlessbooleanNoFalseRun browser without visible window
widthnumberNo1280Browser viewport width in pixels
heightnumberNo720Browser viewport height in pixels

Output:

FieldTypeDescription
statusstringCzy przeglądarka została uruchomiona lub ponownie użyta
messagestringCzy przeglądarka została uruchomiona lub ponownie użyta
is_ownerbooleanCzy przeglądarka została uruchomiona lub ponownie użyta

Example: Example

yaml
headless: false

Example: Example

yaml
headless: true

Wykonaj JavaScript

browser.evaluate

Wykonaj kod JavaScript w kontekscie strony

Parameters:

NameTypeRequiredDefaultDescription
scriptstringYes-JavaScript code to execute (can use return statement)
argsarrayNo-Arguments to pass to the script function

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
resultanyStatus operacji (sukces/blad)

Example: Example

yaml
script: return document.title

Example: Example

yaml
script: return document.querySelectorAll("a").length

Example: Example

yaml
script: (selector) => document.querySelector(selector)?.textContent
args: ["#header"]

Example: Example

yaml
script: document.body.style.backgroundColor = "red"; return "done"

Wyodrebnij dane

browser.extract

Wyodrebnij ustrukturyzowane dane ze strony

Parameters:

NameTypeRequiredDefaultDescription
selectorstringYes-CSS selector, XPath, or text selector to find the element
limitnumberNo-Maximum number of items to extract
fieldsobjectNo-Define fields to extract from each item

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
dataarrayStatus operacji (sukces/blad)
countnumberStatus operacji (sukces/blad)

Example: Example

yaml
selector: .g
limit: 10
fields: {"title": {"selector": "h3", "type": "text"}, "url": {"selector": "a", "type": "attribute", "attribute": "href"}}

Znajdz elementy

browser.find

Znajdz elementy na stronie i zwroc liste ID elementow

Parameters:

NameTypeRequiredDefaultDescription
selectorstringYes-CSS selector, XPath, or text selector to find the element
limitnumberNo-Maximum number of items to extract

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
countnumberStatus operacji (sukces/blad)
element_idsarrayStatus operacji (sukces/blad)

Example: Find search results

yaml
selector: div.tF2Cxc
limit: 10

Wypełnij formularz

browser.form

Inteligentne wypełnianie formularzy z automatycznym wykrywaniem pól

Parameters:

NameTypeRequiredDefaultDescription
form_selectorstringNo-CSS selector for the form element (optional)
dataobjectYes-Key-value pairs to fill (key = field name/id, value = content)
field_mappingobjectNo-Custom selector mapping
clear_before_fillbooleanNoTrueClear existing field values before filling
submitbooleanNoFalseSubmit form after filling
submit_selectorstringNo-CSS selector for submit button
delay_between_fields_msnumberNo100Delay between filling each field (for more human-like behavior)

Output:

FieldTypeDescription
filled_fieldsarrayOpóźnienie między wypełnianiem każdego pola (dla bardziej ludzkiego zachowania)
failed_fieldsarrayLista pól, które zostały wypełnione
submittedbooleanLista pól, które zostały wypełnione

Example: Example

yaml
data: {"email": "user@example.com", "password": "secret123"}
submit: true

Example: Example

yaml
data: {"username": "john_doe", "bio": "Hello world"}
field_mapping: {"username": "#user-name-input", "bio": "textarea.bio-field"}

Przelacz ramke

browser.frame

Przelacz na kontekst iframe lub frame

Parameters:

NameTypeRequiredDefaultDescription
selectorstringNo-CSS selector, XPath, or text selector to find the element
namestringNo-Name attribute of the frame (alternative to selector)
urlstringNo-URL pattern to match frame (alternative to selector)
actionstringNoenterFrame action to perform
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringAkcja ramki (enter aby przelaeczyc na ramke, list aby wylistowac wszystkie ramki)
frame_urlstringAkcja ramki (enter aby przelaeczyc na ramke, list aby wylistowac wszystkie ramki)
frame_namestringStatus operacji (sukces/blad)
framesarrayURL ramki

Example: Example

yaml
selector: iframe#content-frame

Example: Example

yaml
name: main-content

Example: Example

yaml
action: exit

Example: Example

yaml
action: list

Symuluj geolokalizacje

browser.geolocation

Symuluj geolokalizacje przegladarki

Parameters:

NameTypeRequiredDefaultDescription
latitudenumberYes-Latitude coordinate (-90 to 90)
longitudenumberYes-Longitude coordinate (-180 to 180)
accuracynumberNo100Position accuracy in meters

Output:

FieldTypeDescription
statusstringDokladnosc pozycji w metrach
locationobjectDokladnosc pozycji w metrach

Example: Example

yaml
latitude: 37.7749
longitude: -122.4194

Example: Example

yaml
latitude: 51.5074
longitude: -0.1278
accuracy: 10

Example: Example

yaml
latitude: 35.6762
longitude: 139.6503

Przejdz do URL

browser.goto

Przejdz do okreslonego URL

Parameters:

NameTypeRequiredDefaultDescription
urlstringYes-URL to navigate to
wait_untilselect (load, domcontentloaded, networkidle)NodomcontentloadedWhen to consider navigation complete
timeout_msnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
urlstringPrzejdz do okreslonego URL

Example: Example

yaml
url: https://www.google.com
wait_until: domcontentloaded

Najedz na element

browser.hover

Najedz myszka na element

Parameters:

NameTypeRequiredDefaultDescription
selectorstringYes-CSS selector, XPath, or text selector to find the element
timeout_msnumberNo30000Maximum time to wait in milliseconds
positionobjectNo-Click position relative to element (0-1 range)

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
selectorstringStatus operacji (sukces/blad)

Example: Example

yaml
selector: .menu-item

Example: Example

yaml
selector: #dropdown-trigger
timeout_ms: 5000

Uruchom przegladarke

browser.launch

Uruchom nowa instancje przegladarki z Playwright

Parameters:

NameTypeRequiredDefaultDescription
headlessbooleanNoFalseRun browser without visible window
widthnumberNo1280Browser viewport width in pixels
heightnumberNo720Browser viewport height in pixels
browser_typeselect (chromium, firefox, webkit)NochromiumSilnik przeglądarki do użycia (chromium, firefox, webkit)
proxystringNo-URL serwera proxy
user_agentstringNo-Niestandardowy ciąg agenta użytkownika
localestringNoen-USBrowser locale (e.g. en-US, zh-TW, ja-JP)
slow_monumberNo0Spowolnij operacje o określoną liczbę milisekund
record_video_dirstringNo-Directory to save recorded videos (enables Playwright video recording)

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
messagestringUruchom nowa instancje przegladarki
browser_typestringTyp uruchomionej przeglądarki
headlessbooleanCzy przeglądarka działa w trybie bezgłowym
viewportobjectAktualne wymiary widoku

Example: Example

yaml
headless: true

Example: Example

yaml
headless: false

Nawigacja w Historii

browser.navigation

Nawiguj w historii przeglądarki (wstecz, do przodu, odśwież)

Parameters:

NameTypeRequiredDefaultDescription
actionselect (back, forward, reload)YesreloadWhich navigation action to perform
wait_untilselect (load, domcontentloaded, networkidle)NodomcontentloadedWhen to consider navigation complete
timeout_msnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
actionstringWykonana akcja nawigacji
urlstringAktualny URL po nawigacji

Example: Example

yaml
action: back

Example: Example

yaml
action: forward

Example: Example

yaml
action: reload
wait_until: networkidle

Monitor sieci

browser.network

Monitoruj i przechwytuj zadania sieciowe

Parameters:

NameTypeRequiredDefaultDescription
actionselect (monitor, block, intercept)Yes-Network action to perform
url_patternstringNo-Regex pattern to match request URLs
resource_typestringNo-Filter by resource type (document, script, image, etc)
timeoutnumberNo30000Maximum time to wait in milliseconds
mock_responseobjectNo-Response to return for intercepted requests

Output:

FieldTypeDescription
statusstringOdpowiedz do zwrocenia dla przechwyconych zadan
requestsarrayOdpowiedz do zwrocenia dla przechwyconych zadan
blocked_countnumberStatus operacji (sukces/blad)

Example: Example

yaml
action: monitor
url_pattern: .*api.*
timeout: 10000

Example: Example

yaml
action: block
resource_type: image

Example: Example

yaml
action: intercept
url_pattern: .*users.*
mock_response: {"status": 200, "body": "{\"users\": []}"}

Lista Stron

browser.pages

Wyświetl wszystkie otwarte strony/karty przeglądarki

Parameters:

NameTypeRequiredDefaultDescription
include_detailsbooleanNoTrueUwzględnij szczegółowe informacje dla każdej strony
include_content_infobooleanNoFalseUwzględnij informacje o typie treści dla każdej strony

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
pagesarrayLista otwartych stron
countnumberLiczba otwartych stron
current_indexnumberIndeks aktualnie aktywnej strony

Example: Example

yaml
include_details: true

Example: Example

yaml
include_details: false

Example: Example

yaml
include_details: true
include_content_info: true

Paginuj i wyodrębnij

browser.pagination

Automatyczne paginowanie przez strony i wyodrębnianie danych

Parameters:

NameTypeRequiredDefaultDescription
modeselect (next_button, infinite_scroll, page_numbers, load_more)Nonext_buttonHow to navigate between pages
item_selectorstringYes-CSS selector for items to extract on each page
fieldsobjectNo-Field definitions {name: {selector, attribute?}}
next_selectorstringNo-CSS selector for next page button
load_more_selectorstringNo-CSS selector for load more button
max_pagesnumberNo10Maximum number of pages to process (0 = unlimited)
max_itemsnumberNo0Stop after collecting this many items (0 = unlimited)
wait_between_pages_msnumberNo1000Wait time between page navigations
wait_for_selectorstringNo-Wait for this element after page change
scroll_amountnumberNo1000Pixels to scroll for infinite scroll mode
no_more_indicatorstringNo-Selector that appears when no more pages (stops pagination)

Output:

FieldTypeDescription
itemsarraySelektor, który pojawia się, gdy nie ma więcej stron (zatrzymuje paginację)
total_itemsintegerWszystkie wyodrębnione elementy ze wszystkich stron
pages_processedintegerWszystkie wyodrębnione elementy ze wszystkich stron
stopped_reasonstringLiczba przetworzonych stron

Example: Example

yaml
mode: next_button
item_selector: .product-card
fields: {"title": {"selector": ".title"}, "price": {"selector": ".price"}, "link": {"selector": "a", "attribute": "href"}}
next_selector: .pagination .next
max_pages: 5

Example: Example

yaml
mode: infinite_scroll
item_selector: .feed-item
fields: {"content": {"selector": ".content"}, "author": {"selector": ".author"}}
max_items: 100
no_more_indicator: .end-of-feed

Example: Example

yaml
mode: load_more
item_selector: .list-item
load_more_selector: button.load-more
max_pages: 10

Wygeneruj PDF

browser.pdf

Wygeneruj PDF z biezacej strony

Parameters:

NameTypeRequiredDefaultDescription
pathstringNo-Path where the output file will be saved
page_sizeselect (A4, Letter, Legal, A3, A5)NoA4Page size format
orientationselect (portrait, landscape)NoportraitPage orientation
print_backgroundbooleanNoTrueInclude background graphics
scalenumberNo1Scale of the webpage rendering (0.1-2)
marginnumberNo20Page margin in millimeters
headerstringNo-Header text for each page
footerstringNo-Footer text for each page

Output:

FieldTypeDescription
statusstringSkala renderowania strony (0.1-2)
pathstringStatus operacji (sukces/blad)
sizenumberStatus operacji (sukces/blad)

Example: Example

yaml
path: /output/page.pdf

Example: Example

yaml
path: /output/landscape.pdf
landscape: true

Example: Example

yaml
path: /output/custom.pdf
margin: {"top": "1cm", "bottom": "1cm", "left": "2cm", "right": "2cm"}

Metryki Wydajności

browser.performance

Zbieraj metryki wydajności przeglądarki

Parameters:

NameTypeRequiredDefaultDescription
metricsarrayNo['all']Metryki wydajności do zebrania
timeout_msnumberNo3000Limit czasu w milisekundach
setup_observersbooleanNoTrueSkonfiguruj obserwatorów wydajności przed zebraniem

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
metricsobjectZebrane metryki wydajności

Example: Example

yaml
metrics: ["all"]
timeout_ms: 5000

Example: Example

yaml
metrics: ["lcp", "fcp", "cls"]

Example: Example

yaml
metrics: ["ttfb", "domContentLoaded", "load"]
timeout_ms: 0

Nacisnij klawisz

browser.press

Nacisnij klawisz klawiatury

Parameters:

NameTypeRequiredDefaultDescription
keystringYes-The key to press (e.g., Enter, Escape, Tab)

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
keystringNacisnij klawisz klawiatury

Example: Example

yaml
key: Enter

Example: Example

yaml
key: Escape

Nagrywaj akcje

browser.record

Nagrywaj akcje uzytkownika jako przeplyw

Parameters:

NameTypeRequiredDefaultDescription
actionstringYes-Recording action to perform
output_formatstringNoyamlFormat for recorded workflow
output_pathstringNo-Path where the output file will be saved

Output:

FieldTypeDescription
statusstringFormat dla nagranego przeplywu (yaml lub json)
recordingarrayFormat dla nagranego przeplywu (yaml lub json)
workflowstringStatus operacji (sukces/blad)

Example: Example

yaml
action: start

Example: Example

yaml
action: stop
output_format: yaml

Example: Example

yaml
action: get

Zwolnij przeglądarkę

browser.release

Zwolnij sesję przeglądarki (zamknij tylko, jeśli posiadasz)

Parameters:

NameTypeRequiredDefaultDescription
forcebooleanNoFalseZamknij przeglądarkę, nawet jeśli nie jest posiadana przez ten szablon

Output:

FieldTypeDescription
statusstringZamknij przeglądarkę, nawet jeśli nie jest posiadana przez ten szablon
messagestringJakie działanie zostało podjęte
was_ownerbooleanJakie działanie zostało podjęte

Example: Example

yaml

Example: Example

yaml
force: true

Zrob zrzut ekranu

browser.screenshot

Zrob zrzut ekranu biezacej strony

Parameters:

NameTypeRequiredDefaultDescription
pathstringNoscreenshot.pngPath where the output file will be saved
full_pagebooleanNoFalseCapture the entire scrollable page
formatselect (png, jpeg, webp)NopngImage format for the screenshot
qualitynumberNo-Quality for JPEG/WebP format (0-100)

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
filepathstringZrob zrzut ekranu biezacej strony

Example: Example

yaml
path: output/page.png

Przewin strone

browser.scroll

Przewin strone do elementu, pozycji lub kierunku

Parameters:

NameTypeRequiredDefaultDescription
selectorstringNo-CSS selector, XPath, or text selector to find the element
directionselect (down, up, left, right)NodownDirection to scroll the page
amountnumberNo500Pixels to scroll (ignored if selector is provided)
behaviorselect (smooth, instant)NosmoothHow the scroll animation behaves

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
scrolled_toobjectStatus operacji (sukces/blad)

Example: Example

yaml
selector: #footer

Example: Example

yaml
direction: down
amount: 500

Example: Example

yaml
direction: up
amount: 10000
behavior: smooth

Wybierz opcje

browser.select

Wybierz opcje z elementu rozwijanego

Parameters:

NameTypeRequiredDefaultDescription
selectorstringYes-CSS selector, XPath, or text selector to find the element
valuestringNo-Option value attribute to select
labelstringNo-Option text content to select (alternative to value)
indexnumberNo-Option index to select (0-based)
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
selectedarrayStatus operacji (sukces/blad)
selectorstringStatus operacji (sukces/blad)

Example: Example

yaml
selector: select#country
value: us

Example: Example

yaml
selector: select#country
label: United States

Example: Example

yaml
selector: select#country
index: 2

Zrzut DOM

browser.snapshot

Zrób zrzut DOM bieżącej strony

Parameters:

NameTypeRequiredDefaultDescription
formatselect (html, mhtml, text)NohtmlFormat wyjściowy (html lub tekst)
selectorstringNo-Selektor CSS do zrzutu konkretnego elementu
pathstringNo-Ścieżka do zapisania zrzutu

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
formatstringFormat zrzutu
contentstringZawartość zrzutu
pathstringŚcieżka, gdzie zapisano zrzut
size_bytesnumberRozmiar zrzutu w bajtach

Example: Example

yaml
format: html

Example: Example

yaml
format: mhtml
path: /tmp/page.mhtml

Example: Example

yaml
format: text
selector: article.main-content

Example: Example

yaml
format: html
selector: #main
path: /tmp/section.html

Magazyn przegladarki

browser.storage

Dostep do localStorage i sessionStorage

Parameters:

NameTypeRequiredDefaultDescription
actionselect (get, set, remove, clear, keys, length)Yes-Action to perform on the storage
typeselect (local, session)NolocalBrowser storage type to access
keystringNo-Storage key
valuestringNo-Value to store

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
valueanyStatus operacji (sukces/blad)
keysarrayStatus operacji (sukces/blad)
lengthnumberZwrocona wartosc

Example: Example

yaml
action: get
type: local
key: user_token

Example: Example

yaml
action: set
type: session
key: temp_data
value: {"id": 123}

Example: Example

yaml
action: clear
type: local

Example: Example

yaml
action: keys
type: local

Zarzadzaj kartami

browser.tab

Tworzenie, przelaczanie i zamykanie kart przegladarki

Parameters:

NameTypeRequiredDefaultDescription
actionstringYes-Tab action to perform
urlstringNo-URL to navigate to
indexnumberNo-Tab index to switch to or close (0-based)

Output:

FieldTypeDescription
statusstringIndeks karty do przelaczenia lub zamkniecia (od 0)
tab_countnumberIndeks karty do przelaczenia lub zamkniecia (od 0)
current_indexnumberStatus operacji (sukces/blad)
tabsarrayLiczba kart

Example: Example

yaml
action: new
url: https://example.com

Example: Example

yaml
action: switch
index: 0

Example: Example

yaml
action: close

Example: Example

yaml
action: list

Ślad Przeglądarki

browser.trace

Rozpocznij, zatrzymaj lub zapisz ślady wydajności przeglądarki

Parameters:

NameTypeRequiredDefaultDescription
actionstringYes-Akcja śledzenia (rozpocznij, zatrzymaj, zapisz)
categoriesarrayNo['devtools.timeline']Kategorie śledzenia do uchwycenia
screenshotsbooleanNoTrueUwzględnij zrzuty ekranu w śladzie
pathstringNo-Ścieżka do zapisania pliku śladu

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
tracingbooleanCzy śledzenie jest obecnie aktywne
pathstringŚcieżka, gdzie zapisano ślad
size_bytesnumberRozmiar pliku śladu w bajtach

Example: Example

yaml
action: start
screenshots: true

Example: Example

yaml
action: start
categories: ["devtools.timeline", "v8.execute"]
screenshots: false

Example: Example

yaml
action: stop
path: /tmp/performance-trace.json

Wpisz tekst

browser.type

Wpisz tekst w pole wejsciowe

Parameters:

NameTypeRequiredDefaultDescription
type_methodselect (placeholder, label, name, id, selector)NoplaceholderChoose the easiest way to identify the input field
targetstringNo-e.g. "Enter your email", "Email", "username"
selectorstringNo-CSS selector, XPath, or text selector
input_typeselect (text, password, email)NotextType of input field — use Password to mask the value in the builder
textstringYes-
sensitive_textstringYes-
delaynumberNo0Delay between keystrokes in milliseconds
clearbooleanNoFalseClear the input field before typing
timeoutnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
browserobjectBrowser session (pass-through for chaining)
statusstringStatus operacji (sukces/blad)
selectorstringWpisz tekst w pole wejsciowe
methodstringType method used

Example: Example

yaml
type_method: placeholder
target: Enter your email
text: user@example.com

Example: Example

yaml
type_method: label
target: Email
text: user@example.com

Example: Example

yaml
type_method: placeholder
target: Password
input_type: password
sensitive_text: ${env.LOGIN_PASSWORD}

Example: Example

yaml
type_method: selector
selector: #email
text: user@example.com

Przeslij plik

browser.upload

Przeslij plik do elementu wejscia pliku

Parameters:

NameTypeRequiredDefaultDescription
selectorstringYes-CSS selector, XPath, or text selector to find the element
file_pathstringYes-Local path to the file to upload
timeout_msnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
filenamestringStatus operacji (sukces/blad)
sizenumberStatus operacji (sukces/blad)
selectorstringNazwa pliku

Example: Example

yaml
selector: input[type="file"]
file_path: /path/to/image.png

Example: Example

yaml
selector: #file-upload
file_path: /path/to/document.pdf

Ustaw widok

browser.viewport

Pobierz lub ustaw rozmiar widoku przeglądarki

Parameters:

NameTypeRequiredDefaultDescription
widthnumberYes1280Szerokość widoku w pikselach
heightnumberYes720Wysokość widoku w pikselach

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/błąd)
viewportobjectAktualne wymiary widoku
previous_viewportobjectPoprzednie wymiary widoku

Example: Example

yaml
width: 375
height: 667

Example: Example

yaml
width: 768
height: 1024

Example: Example

yaml
width: 1920
height: 1080

Example: Example

yaml
width: 1366
height: 768

Czekaj

browser.wait

Czekaj przez okreslony czas lub az pojawi sie element

Parameters:

NameTypeRequiredDefaultDescription
duration_msnumberNo1000Duration of the operation in milliseconds
selectorstringNo-CSS selector, XPath, or text selector to find the element
stateselect (visible, hidden, attached, detached)NovisibleStan do oczekiwania (widoczny, ukryty, dołączony, odłączony)
timeout_msnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatus operacji (sukces/blad)
selectorstringStatus operacji (sukces/blad)
duration_msnumberCzekaj przez okreslony czas lub az pojawi sie element

Example: Example

yaml
duration_ms: 2000

Example: Example

yaml
selector: #loading-complete
timeout_ms: 5000

Released under the Apache 2.0 License.