Skip to content

Browser Automation

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

38 modules

ModuleDescription
Cliquer sur l'elementCliquer sur un element de la page
Fermer le navigateurFermer l'instance du navigateur et liberer les ressources
Capturer la consoleCapturer les journaux de la console du navigateur (erreurs, avertissements, infos)
Gerer les cookiesObtenir, definir ou effacer les cookies du navigateur
Gerer le dialogueGerer les dialogues alert, confirm et prompt
Telecharger le fichierTelecharger un fichier depuis le navigateur
Glisser-deposerGlisser-deposer des elements
Émuler un appareilÉmuler un appareil ou définir une fenêtre personnalisée
Assurer le navigateurAssurez-vous qu'une session de navigateur existe (réutiliser ou lancer)
Executer JavaScriptExecuter du code JavaScript dans le contexte de la page
Extraire les donneesExtraire des donnees structurees de la page
Trouver des elementsTrouver des elements dans la page et retourner la liste des ID
Remplir le formulaireRemplissage intelligent de formulaires avec détection automatique des champs
Changer de frameBasculer vers le contexte iframe ou frame
Simuler la geolocalisationSimuler la geolocalisation du navigateur
Aller a l'URLNaviguer vers une URL specifique
Survoler l'elementSurvoler un element avec la souris
Lancer le navigateurLancer une nouvelle instance de navigateur avec Playwright
Naviguer dans l'historiqueNaviguer dans l'historique du navigateur (retour, avant, recharger)
Moniteur reseauSurveiller et intercepter les requetes reseau
Lister les PagesLister toutes les pages/onglets ouverts du navigateur
Paginer & ExtrairePagination automatique à travers les pages et extraction de données
Generer un PDFGenerer un PDF de la page actuelle
Métriques de PerformanceCollecter les métriques de performance du navigateur
Appuyer sur une toucheAppuyer sur une touche du clavier
Enregistrer les actionsEnregistrer les actions utilisateur comme workflow
Libérer le navigateurLibérer la session du navigateur (fermer uniquement si possédé)
Prendre une capture d'ecranPrendre une capture d'ecran de la page actuelle
Faire defiler la pageFaire defiler la page vers un element, une position ou une direction
Selectionner une optionSelectionner une option dans un element deroulant
Instantané DOMCapturer un instantané DOM de la page actuelle
Stockage du navigateurAcceder au localStorage et sessionStorage
Gerer les ongletsCreer, basculer et fermer des onglets du navigateur
Trace du NavigateurDémarrer, arrêter ou enregistrer les traces de performance du navigateur
Saisir du texteSaisir du texte dans un champ de saisie
Telecharger un fichierTelecharger un fichier vers un element d'entree de fichier
Définir la fenêtreObtenez ou définissez la taille de la fenêtre du navigateur
AttendreAttendre une duree ou jusqu'a ce qu'un element apparaisse

Modules

Cliquer sur l'element

browser.click

Cliquer sur un element de la page

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)
statusstringStatut de l'operation (succes/erreur)
selectorstringStatut de l'operation (succes/erreur)
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

Fermer le navigateur

browser.close

Fermer l'instance du navigateur et liberer les ressources

Parameters:

NameTypeRequiredDefaultDescription
_no_paramsbooleanNoTrueThis module requires no parameters

Output:

FieldTypeDescription
statusstringFermer l'instance du navigateur
messagestringFermer l'instance du navigateur

Example: Example

yaml

Capturer la console

browser.console

Capturer les journaux de la console du navigateur (erreurs, avertissements, infos)

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
statusstringStatut de l'operation (succes/erreur)
messagesarrayStatut de l'operation (succes/erreur)
countnumberStatut de l'operation (succes/erreur)

Example: Example

yaml
timeout: 3000

Example: Example

yaml
level: error
timeout: 5000

Gerer les cookies

browser.cookies

Obtenir, definir ou effacer les cookies du navigateur

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
statusstringStatut de l'operation (succes/erreur)
cookiesarrayStatut de l'operation (succes/erreur)
countnumberStatut de l'operation (succes/erreur)

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

Gerer le dialogue

browser.dialog

Gerer les dialogues alert, confirm et 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
statusstringStatut de l'operation (succes/erreur)
messagestringStatut de l'operation (succes/erreur)
typestringStatut de l'operation (succes/erreur)
default_valuestringMessage de resultat decrivant l'issue

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

Telecharger le fichier

browser.download

Telecharger un fichier depuis le navigateur

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
statusstringStatut de l'operation (succes/erreur)
pathstringStatut de l'operation (succes/erreur)
filenamestringStatut de l'operation (succes/erreur)
sizenumberChemin du fichier ou de la ressource

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

Glisser-deposer

browser.drag

Glisser-deposer des elements

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
statusstringPosition dans l'element cible {x, y} en pourcentages
sourcestringPosition dans l'element cible {x, y} en pourcentages
targetstringStatut de l'operation (succes/erreur)

Example: Example

yaml
source: #item1
target: #dropzone

Example: Example

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

Émuler un appareil

browser.emulate

Émuler un appareil ou définir une fenêtre personnalisée

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-Nom de l'appareil à émuler (par ex. iPhone 13)
widthnumberNo-Largeur de la fenêtre en pixels
heightnumberNo-Hauteur de la fenêtre en pixels
user_agentstringNo-Chaîne d'agent utilisateur personnalisée
is_mobilebooleanNo-Si l'on doit émuler un appareil mobile
has_touchbooleanNo-Si l'appareil a un support tactile
device_scale_factornumberNo-Ratio de pixels de l'appareil

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
devicestringNom de l'appareil émulé
viewportobjectDimensions actuelles de la fenêtre
is_mobilebooleanSi l'émulation mobile est active

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

Assurer le navigateur

browser.ensure

Assurez-vous qu'une session de navigateur existe (réutiliser ou lancer)

Parameters:

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

Output:

FieldTypeDescription
statusstringSi le navigateur a été lancé ou réutilisé
messagestringSi le navigateur a été lancé ou réutilisé
is_ownerbooleanSi le navigateur a été lancé ou réutilisé

Example: Example

yaml
headless: false

Example: Example

yaml
headless: true

Executer JavaScript

browser.evaluate

Executer du code JavaScript dans le contexte de la page

Parameters:

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

Output:

FieldTypeDescription
statusstringStatut de l'operation (succes/erreur)
resultanyStatut de l'operation (succes/erreur)

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"

Extraire les donnees

browser.extract

Extraire des donnees structurees de la page

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
statusstringStatut de l'operation (succes/erreur)
dataarrayStatut de l'operation (succes/erreur)
countnumberStatut de l'operation (succes/erreur)

Example: Example

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

Trouver des elements

browser.find

Trouver des elements dans la page et retourner la liste des ID

Parameters:

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

Output:

FieldTypeDescription
statusstringStatut de l'operation (succes/erreur)
countnumberStatut de l'operation (succes/erreur)
element_idsarrayStatut de l'operation (succes/erreur)

Example: Find search results

yaml
selector: div.tF2Cxc
limit: 10

Remplir le formulaire

browser.form

Remplissage intelligent de formulaires avec détection automatique des champs

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_fieldsarrayDélai entre le remplissage de chaque champ (pour un comportement plus humain)
failed_fieldsarrayListe des champs remplis
submittedbooleanListe des champs remplis

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

Changer de frame

browser.frame

Basculer vers le contexte iframe ou 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
statusstringAction sur la frame (enter pour basculer, list pour lister)
frame_urlstringAction sur la frame (enter pour basculer, list pour lister)
frame_namestringStatut de l'operation (succes/erreur)
framesarrayURL de la frame

Example: Example

yaml
selector: iframe#content-frame

Example: Example

yaml
name: main-content

Example: Example

yaml
action: exit

Example: Example

yaml
action: list

Simuler la geolocalisation

browser.geolocation

Simuler la geolocalisation du navigateur

Parameters:

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

Output:

FieldTypeDescription
statusstringPrecision de la position en metres
locationobjectPrecision de la position en metres

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

Aller a l'URL

browser.goto

Naviguer vers une URL specifique

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
statusstringStatut de l'operation (succes/erreur)
urlstringNaviguer vers une URL specifique

Example: Example

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

Survoler l'element

browser.hover

Survoler un element avec la souris

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
statusstringStatut de l'operation (succes/erreur)
selectorstringStatut de l'operation (succes/erreur)

Example: Example

yaml
selector: .menu-item

Example: Example

yaml
selector: #dropdown-trigger
timeout_ms: 5000

Lancer le navigateur

browser.launch

Lancer une nouvelle instance de navigateur avec Playwright

Parameters:

NameTypeRequiredDefaultDescription
headlessbooleanNoFalseRun browser without visible window
widthnumberNo1280Browser viewport width in pixels
heightnumberNo720Browser viewport height in pixels
browser_typeselect (chromium, firefox, webkit)NochromiumMoteur de navigateur à utiliser (chromium, firefox, webkit)
proxystringNo-URL du serveur proxy
user_agentstringNo-Chaîne d'agent utilisateur personnalisée
localestringNoen-USBrowser locale (e.g. en-US, zh-TW, ja-JP)
slow_monumberNo0Ralentir les opérations de la durée spécifiée en millisecondes
record_video_dirstringNo-Directory to save recorded videos (enables Playwright video recording)

Output:

FieldTypeDescription
statusstringStatut de l'operation (succes/erreur)
messagestringLancer une nouvelle instance de navigateur
browser_typestringType de navigateur lancé
headlessbooleanSi le navigateur fonctionne en mode sans tête
viewportobjectDimensions actuelles de la fenêtre

Example: Example

yaml
headless: true

Example: Example

yaml
headless: false

browser.navigation

Naviguer dans l'historique du navigateur (retour, avant, recharger)

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
statusstringStatut de l'opération (succès/erreur)
actionstringAction de navigation effectuée
urlstringURL actuelle après navigation

Example: Example

yaml
action: back

Example: Example

yaml
action: forward

Example: Example

yaml
action: reload
wait_until: networkidle

Moniteur reseau

browser.network

Surveiller et intercepter les requetes reseau

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
statusstringReponse a retourner pour les requetes interceptees
requestsarrayReponse a retourner pour les requetes interceptees
blocked_countnumberStatut de l'operation (succes/erreur)

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\": []}"}

Lister les Pages

browser.pages

Lister toutes les pages/onglets ouverts du navigateur

Parameters:

NameTypeRequiredDefaultDescription
include_detailsbooleanNoTrueInclure des informations détaillées pour chaque page
include_content_infobooleanNoFalseInclure les informations de type de contenu pour chaque page

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
pagesarrayListe des pages ouvertes
countnumberNombre de pages ouvertes
current_indexnumberIndex de la page active actuelle

Example: Example

yaml
include_details: true

Example: Example

yaml
include_details: false

Example: Example

yaml
include_details: true
include_content_info: true

Paginer & Extraire

browser.pagination

Pagination automatique à travers les pages et extraction de données

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
itemsarraySélecteur qui apparaît quand il n'y a plus de pages (arrête la pagination)
total_itemsintegerTous les éléments extraits de toutes les pages
pages_processedintegerTous les éléments extraits de toutes les pages
stopped_reasonstringNombre de pages traitées

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

Generer un PDF

browser.pdf

Generer un PDF de la page actuelle

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
statusstringEchelle du rendu de la page web (0.1-2)
pathstringStatut de l'operation (succes/erreur)
sizenumberStatut de l'operation (succes/erreur)

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

Métriques de Performance

browser.performance

Collecter les métriques de performance du navigateur

Parameters:

NameTypeRequiredDefaultDescription
metricsarrayNo['all']Métriques de performance à collecter
timeout_msnumberNo3000Délai d'attente en millisecondes
setup_observersbooleanNoTrueConfigurer les observateurs de performance avant de collecter

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
metricsobjectMétriques de performance collectées

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

Appuyer sur une touche

browser.press

Appuyer sur une touche du clavier

Parameters:

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

Output:

FieldTypeDescription
statusstringStatut de l'operation (succes/erreur)
keystringAppuyer sur une touche du clavier

Example: Example

yaml
key: Enter

Example: Example

yaml
key: Escape

Enregistrer les actions

browser.record

Enregistrer les actions utilisateur comme workflow

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 du workflow enregistre (yaml ou json)
recordingarrayFormat du workflow enregistre (yaml ou json)
workflowstringStatut de l'operation (succes/erreur)

Example: Example

yaml
action: start

Example: Example

yaml
action: stop
output_format: yaml

Example: Example

yaml
action: get

Libérer le navigateur

browser.release

Libérer la session du navigateur (fermer uniquement si possédé)

Parameters:

NameTypeRequiredDefaultDescription
forcebooleanNoFalseFermer le navigateur même s'il n'est pas possédé par ce modèle

Output:

FieldTypeDescription
statusstringFermer le navigateur même s'il n'est pas possédé par ce modèle
messagestringQuelle action a été prise
was_ownerbooleanQuelle action a été prise

Example: Example

yaml

Example: Example

yaml
force: true

Prendre une capture d'ecran

browser.screenshot

Prendre une capture d'ecran de la page actuelle

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
statusstringStatut de l'operation (succes/erreur)
filepathstringPrendre une capture d'ecran de la page actuelle

Example: Example

yaml
path: output/page.png

Faire defiler la page

browser.scroll

Faire defiler la page vers un element, une position ou une direction

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
statusstringStatut de l'operation (succes/erreur)
scrolled_toobjectStatut de l'operation (succes/erreur)

Example: Example

yaml
selector: #footer

Example: Example

yaml
direction: down
amount: 500

Example: Example

yaml
direction: up
amount: 10000
behavior: smooth

Selectionner une option

browser.select

Selectionner une option dans un element deroulant

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
statusstringStatut de l'operation (succes/erreur)
selectedarrayStatut de l'operation (succes/erreur)
selectorstringStatut de l'operation (succes/erreur)

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

Instantané DOM

browser.snapshot

Capturer un instantané DOM de la page actuelle

Parameters:

NameTypeRequiredDefaultDescription
formatselect (html, mhtml, text)NohtmlFormat de sortie (html ou texte)
selectorstringNo-Sélecteur CSS pour capturer un élément spécifique
pathstringNo-Chemin pour enregistrer l'instantané

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
formatstringFormat de l'instantané
contentstringContenu de l'instantané
pathstringChemin où l'instantané a été enregistré
size_bytesnumberTaille de l'instantané en octets

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

Stockage du navigateur

browser.storage

Acceder au localStorage et 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
statusstringStatut de l'operation (succes/erreur)
valueanyStatut de l'operation (succes/erreur)
keysarrayStatut de l'operation (succes/erreur)
lengthnumberLa valeur retournee

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

Gerer les onglets

browser.tab

Creer, basculer et fermer des onglets du navigateur

Parameters:

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

Output:

FieldTypeDescription
statusstringIndex de l'onglet a basculer ou fermer (base 0)
tab_countnumberIndex de l'onglet a basculer ou fermer (base 0)
current_indexnumberStatut de l'operation (succes/erreur)
tabsarrayLe nombre d'onglets

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

Trace du Navigateur

browser.trace

Démarrer, arrêter ou enregistrer les traces de performance du navigateur

Parameters:

NameTypeRequiredDefaultDescription
actionstringYes-Action de traçage (démarrer, arrêter, enregistrer)
categoriesarrayNo['devtools.timeline']Catégories de traçage à capturer
screenshotsbooleanNoTrueInclure des captures d'écran dans la trace
pathstringNo-Chemin pour enregistrer le fichier de trace

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
tracingbooleanSi la traçage est actuellement active
pathstringChemin où la trace a été enregistrée
size_bytesnumberTaille du fichier de trace en octets

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

Saisir du texte

browser.type

Saisir du texte dans un champ de saisie

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)
statusstringStatut de l'operation (succes/erreur)
selectorstringSaisir du texte dans un champ de saisie
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

Telecharger un fichier

browser.upload

Telecharger un fichier vers un element d'entree de fichier

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
statusstringStatut de l'operation (succes/erreur)
filenamestringStatut de l'operation (succes/erreur)
sizenumberStatut de l'operation (succes/erreur)
selectorstringNom du fichier

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

Définir la fenêtre

browser.viewport

Obtenez ou définissez la taille de la fenêtre du navigateur

Parameters:

NameTypeRequiredDefaultDescription
widthnumberYes1280Largeur de la fenêtre en pixels
heightnumberYes720Hauteur de la fenêtre en pixels

Output:

FieldTypeDescription
statusstringStatut de l'opération (succès/erreur)
viewportobjectDimensions actuelles de la fenêtre
previous_viewportobjectDimensions précédentes de la fenêtre

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

Attendre

browser.wait

Attendre une duree ou jusqu'a ce qu'un element apparaisse

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)NovisibleÉtat à attendre (visible, caché, attaché, détaché)
timeout_msnumberNo30000Maximum time to wait in milliseconds

Output:

FieldTypeDescription
statusstringStatut de l'operation (succes/erreur)
selectorstringStatut de l'operation (succes/erreur)
duration_msnumberAttendre une duree ou l'apparition d'un element

Example: Example

yaml
duration_ms: 2000

Example: Example

yaml
selector: #loading-complete
timeout_ms: 5000

Released under the Apache 2.0 License.