Verktyg

Följande verktyg är tillgängliga via WebdriverIO MCP-servern. Dessa verktyg gör det möjligt för AI-assistenter att automatisera webbläsare och mobilapplikationer.

Session Management

`start_browser`

Startar en Chrome-webbläsarsession.

Parameters

Parameter	Type	Mandatory	Default	Description
`headless`	boolean	No	`false`	Run Chrome in headless mode
`windowWidth`	number	No	`1920`	Browser window width (400-3840)
`windowHeight`	number	No	`1080`	Browser window height (400-2160)
`navigationUrl`	string	No	-	URL to navigate to after starting the browser

Example

Start a browser with 1920x1080 resolution and navigate to webdriver.io

Support

Desktop Browsers

`start_app_session`

Startar en mobilappsession på iOS eller Android via Appium.

Parameters

Parameter	Type	Mandatory	Default	Description
`platform`	string	Yes	-	Platform to automate: `iOS` or `Android`
`deviceName`	string	Yes	-	Name of the device or simulator/emulator
`appPath`	string	No*	-	Path to the app file (.app, .ipa, or .apk)
`platformVersion`	string	No	-	OS version (e.g., `17.0`, `14`)
`automationName`	string	No	Auto	`XCUITest` (iOS), `UiAutomator2` or `Espresso` (Android)
`udid`	string	No	-	Unique device identifier (required for real iOS devices)
`noReset`	boolean	No	`false`	Preserve app state between sessions
`fullReset`	boolean	No	`true`	Uninstall and reinstall app before session
`autoGrantPermissions`	boolean	No	`true`	Automatically grant app permissions
`autoAcceptAlerts`	boolean	No	`true`	Automatically accept system alerts
`autoDismissAlerts`	boolean	No	`false`	Dismiss (instead of accept) alerts
`appWaitActivity`	string	No	-	Activity to wait for on launch (Android only)
`newCommandTimeout`	number	No	`60`	Seconds before session times out due to inactivity
`appiumHost`	string	No	`127.0.0.1`	Appium server hostname
`appiumPort`	number	No	`4723`	Appium server port
`appiumPath`	string	No	`/`	Appium server path

*Either appPath must be provided, or noReset: true to connect to an already-running app.

Example

Start an iOS app session on iPhone 15 simulator with my app at /path/to/app.app

Support

iOS Simulators
iOS Real Devices
Android Emulators
Android Real Devices

`close_session`

Stänger den aktuella webbläsar- eller appsessionen.

Parameters

Parameter	Type	Mandatory	Default	Description
`detach`	boolean	No	`false`	Detach from session instead of closing (keeps browser/app running)

Notes

Sessions with noReset: true or without appPath automatically detach on close to preserve state.

Support

Desktop Browsers
Mobile Apps

`navigate`

Navigerar till en URL.

Parameters

Parameter	Type	Mandatory	Description
`url`	string	Yes	The URL to navigate to

Example

Navigate to https://webdriver.io

Support

Desktop Browsers

Element Interaction

`click_element`

Klickar på ett element identifierat av en selektor.

Parameters

Parameter	Type	Mandatory	Default	Description
`selector`	string	Yes	-	CSS selector, XPath, or mobile selector
`scrollToView`	boolean	No	`true`	Scroll element into view before clicking
`timeout`	number	No	`3000`	Max time to wait for element (ms)

Notes

Supports WebdriverIO text selectors: button=Exact text or a*=Contains text
Uses center alignment for scroll positioning

Example

Click the element with selector "#submit-button"

Support

Desktop Browsers
Mobile Native Apps

`set_value`

Skriver text i ett inmatningsfält.

Parameters

Parameter	Type	Mandatory	Default	Description
`selector`	string	Yes	-	Selector for the input element
`value`	string	Yes	-	Text to type
`scrollToView`	boolean	No	`true`	Scroll element into view before typing
`timeout`	number	No	`3000`	Max time to wait for element (ms)

Notes

Clears existing value before typing new text.

Example

Set the value "john@example.com" in the element with selector "#email"

Support

Desktop Browsers
Mobile Native Apps

Page Analysis

`get_visible_elements`

Hämtar synliga och interaktiva element på aktuell sida eller skärm. Detta är det primära verktyget för att upptäcka vilka element som är tillgängliga för interaktion.

Parameters

Parameter	Type	Mandatory	Default	Description
`elementType`	string	No	`interactable`	Type of elements: `interactable` (buttons/links/inputs), `visual` (images/SVGs), or `all`
`inViewportOnly`	boolean	No	`true`	Only return elements visible in the viewport
`includeContainers`	boolean	No	`false`	Include layout containers (ViewGroup, ScrollView, etc.)
`includeBounds`	boolean	No	`false`	Include element coordinates (x, y, width, height)
`limit`	number	No	`0`	Maximum elements to return (0 = unlimited)
`offset`	number	No	`0`	Number of elements to skip (for pagination)

Returns

{
  "total": 42,
  "showing": 20,
  "hasMore": true,
  "elements": [...]
}

Web elements include: tagName, type, id, className, textContent, value, placeholder, href, ariaLabel, role, cssSelector, isInViewport

Mobile elements include: Multiple locator strategies (accessibility ID, resource ID, XPath, UiAutomator/predicates), element type, text, and optionally bounds

Notes

Web: Uses an optimized browser script for fast element detection
Mobile: Uses efficient XML page source parsing (2 HTTP calls vs 600+ for element queries)
Use pagination (limit and offset) for large pages to reduce token usage

Example

Get all visible elements on the page with their coordinates

Support

Desktop Browsers
Mobile Apps

`get_accessibility`

Hämtar tillgänglighetsträdet för aktuell sida med semantisk information om roller, namn och tillstånd.

Parameters

Parameter	Type	Mandatory	Default	Description
`limit`	number	No	`100`	Maximum nodes to return (0 = unlimited)
`offset`	number	No	`0`	Number of nodes to skip (for pagination)
`roles`	string[]	No	All	Filter to specific roles (e.g., `["button", "link", "textbox"]`)
`namedOnly`	boolean	No	`true`	Only return nodes with a name/label

Returns

{
  "total": 85,
  "showing": 100,
  "hasMore": false,
  "nodes": [
    { "role": "button", "name": "Submit" },
    { "role": "link", "name": "Home" }
  ]
}

Notes

Browser-only. For mobile apps, use get_visible_elements instead
Useful when get_visible_elements doesn't return expected elements
namedOnly: true filters out anonymous containers and reduces noise

Support

Desktop Browsers

Screenshots

`take_screenshot`

Tar en skärmdump av aktuell vy.

Parameters

Parameter	Type	Mandatory	Description
`outputPath`	string	No	Path to save screenshot file. If omitted, returns base64 data

Returns

Base64-encoded image data (PNG or JPEG) with size information.

Notes

Screenshots are automatically optimized:

Maximum dimension: 2000px (scaled down if larger)
Maximum file size: 1MB
Format: PNG with max compression, or JPEG if needed to meet size limit

Support

Desktop Browsers
Mobile Apps

Scrolling

`scroll`

Rullar sidan upp eller ner med ett angivet antal pixlar.

Parameters

Parameter	Type	Mandatory	Default	Description
`direction`	string	Yes	-	Scroll direction: `up` or `down`
`pixels`	number	No	`500`	Number of pixels to scroll

Notes

Browser-only. For mobile scrolling, use the swipe tool instead.

Support

Desktop Browsers

`get_cookies`

Hämtar cookies från aktuell session.

Parameters

Parameter	Type	Mandatory	Description
`name`	string	No	Specific cookie name to retrieve (omit for all cookies)

Returns

Cookie objects with name, value, domain, path, expiry, secure, and httpOnly properties.

Support

Desktop Browsers

`set_cookie`

Sätter en cookie i aktuell session.

Parameters

Parameter	Type	Mandatory	Default	Description
`name`	string	Yes	-	Cookie name
`value`	string	Yes	-	Cookie value
`domain`	string	No	Current	Cookie domain
`path`	string	No	`/`	Cookie path
`expiry`	number	No	-	Expiration as Unix timestamp (seconds)
`secure`	boolean	No	-	Secure flag
`httpOnly`	boolean	No	-	HttpOnly flag
`sameSite`	string	No	-	SameSite attribute: `strict`, `lax`, or `none`

Support

Desktop Browsers

`delete_cookies`

Raderar cookies från aktuell session.

Parameters

Parameter	Type	Mandatory	Description
`name`	string	No	Specific cookie name to delete (omit to delete all)

Support

Desktop Browsers

Touch Gestures (Mobile)

`tap_element`

Trycker på ett element eller skärmkoordinater.

Parameters

Parameter	Type	Mandatory	Description
`selector`	string	No*	Selector for the element to tap
`x`	number	No*	X coordinate for tap
`y`	number	No*	Y coordinate for tap

*Either selector or both x and y are required.

Support

Mobile Apps

`swipe`

Utför en svepgest i angiven riktning.

Parameters

Parameter	Type	Mandatory	Default	Description
`direction`	string	Yes	-	Swipe direction: `up`, `down`, `left`, `right`
`duration`	number	No	`500`	Swipe duration in milliseconds (100-5000)
`percent`	number	No	0.5/0.95	Percentage of screen to swipe (0-1)

Notes

Default percent: 0.5 for vertical swipes, 0.95 for horizontal swipes
Direction indicates content movement: "swipe up" scrolls content up

Example

Swipe up to scroll down the screen

Support

Mobile Apps

`drag_and_drop`

Drar ett element till ett annat element eller koordinater.

Parameters

Parameter	Type	Mandatory	Description
`sourceSelector`	string	Yes	Source element selector to drag
`targetSelector`	string	No*	Target element selector to drop onto
`x`	number	No*	Target X offset (if no targetSelector)
`y`	number	No*	Target Y offset (if no targetSelector)
`duration`	number	No	Default

*Either targetSelector or both x and y are required.

Support

Mobile Apps

App Lifecycle (Mobile)

`get_app_state`

Hämtar appens aktuella tillstånd.

Parameters

Parameter	Type	Mandatory	Description
`bundleId`	string	Yes	App identifier (bundle ID for iOS, package name for Android)

Returns

App state: not installed, not running, running in background (suspended), running in background, or running in foreground.

Support

Mobile Apps

Context Switching (Hybrid Apps)

`get_contexts`

Listar alla tillgängliga kontexter (native och webview).

Parameters

None

Returns

Array of context names (e.g., ["NATIVE_APP", "WEBVIEW_com.example.app"]).

Support

Mobile Hybrid Apps

`get_current_context`

Hämtar aktuell aktiv kontext.

Parameters

None

Returns

Current context name (e.g., NATIVE_APP or WEBVIEW_*).

Support

Mobile Hybrid Apps

`switch_context`

Växlar mellan native- och webview-kontexter.

Parameters

Parameter	Type	Mandatory	Description
`context`	string	Yes	Context name or index (1-based) from `get_contexts`

Example

Switch to the WEBVIEW_com.example.app context

Support

Mobile Hybrid Apps

Device Control (Mobile)

`rotate_device`

Roterar enheten till en specifik orientering.

Parameters

Parameter	Type	Mandatory	Description
`orientation`	string	Yes	`PORTRAIT` or `LANDSCAPE`

Support

Mobile Apps

`hide_keyboard`

Döljer skärmtangentbordet.

Parameters

None

Support

Mobile Apps

`get_geolocation`

Hämtar aktuella GPS-koordinater.

Parameters

None

Returns

Object with latitude, longitude, and altitude.

Support

Mobile Apps

`set_geolocation`

Ställer in enhetens GPS-koordinater.

Parameters

Parameter	Type	Mandatory	Description
`latitude`	number	Yes	Latitude coordinate (-90 to 90)
`longitude`	number	Yes	Longitude coordinate (-180 to 180)
`altitude`	number	No	Altitude in meters

Example

Set geolocation to San Francisco (37.7749, -122.4194)

Support

Mobile Apps

Script Execution

`execute_script`

Kör JavaScript i webbläsaren eller mobilkommandon via Appium.

Parameters

Parameter	Type	Mandatory	Description
`script`	string	Yes	JavaScript code (browser) or mobile command (e.g., `mobile: pressKey`)
`args`	array	No	Arguments for the script

Browser Examples

// Get page title
execute_script({ script: "return document.title" })

// Get scroll position
execute_script({ script: "return window.scrollY" })

// Click element by selector
execute_script({ script: "arguments[0].click()", args: ["#myButton"] })

Mobile (Appium) Examples

// Press back key (Android)
execute_script({ script: "mobile: pressKey", args: [{ keycode: 4 }] })

// Activate app
execute_script({ script: "mobile: activateApp", args: [{ appId: "com.example" }] })

// Terminate app
execute_script({ script: "mobile: terminateApp", args: [{ appId: "com.example" }] })

// Deep link
execute_script({ script: "mobile: deepLink", args: [{ url: "myapp://screen", package: "com.example" }] })

// Shell command (Android)
execute_script({ script: "mobile: shell", args: [{ command: "dumpsys", args: ["battery"] }] })

Common Android Key Codes

Key	Code
BACK	4
HOME	3
ENTER	66
MENU	82
SEARCH	84

More Mobile Commands

For a complete list of available Appium mobile commands, see:

XCUITest Mobile Commands (iOS)
UiAutomator2 Mobile Commands (Android)

Support

Desktop Browsers
Mobile Apps (via Appium mobile commands)

Session Management​

start_browser​

Parameters​

Example​

Support​

start_app_session​

Parameters​

Example​

Support​

close_session​

Parameters​

Notes​

Support​

Navigation​

navigate​

Parameters​

Example​

Support​

Element Interaction​

click_element​

Parameters​

Notes​

Example​

Support​

set_value​

Parameters​

Notes​

Example​

Support​

Page Analysis​

get_visible_elements​

Parameters​

Returns​

Notes​

Example​

Support​

get_accessibility​

Parameters​

Returns​

Notes​

Support​

Screenshots​

take_screenshot​

Parameters​

Returns​

Notes​

Support​

Scrolling​

scroll​

Parameters​

Notes​

Support​

Cookie Management​

get_cookies​

Parameters​

Returns​

Support​

set_cookie​

Parameters​

Support​

delete_cookies​

Parameters​

Support​

Touch Gestures (Mobile)​

tap_element​

Parameters​

Support​

swipe​

Parameters​

Notes​

Example​

Support​

drag_and_drop​

Parameters​

Support​

App Lifecycle (Mobile)​

get_app_state​

Parameters​

Returns​

Support​

Session Management

`start_browser`

Parameters

Example

Support

`start_app_session`

Parameters

Example

Support

`close_session`

Parameters

Notes

Support

Navigation

`navigate`

Parameters

Example

Support

Element Interaction

`click_element`

Parameters

Notes

Example

Support

`set_value`

Parameters

Notes

Example

Support

Page Analysis

`get_visible_elements`

Parameters

Returns

Notes

Example

Support

`get_accessibility`

Parameters

Returns

Notes

Support

Screenshots

`take_screenshot`

Parameters

Returns

Notes

Support

Scrolling

`scroll`

Parameters

Notes

Support

Cookie Management

`get_cookies`

Parameters

Returns

Support

`set_cookie`

Parameters

Support

`delete_cookies`

Parameters

Support

Touch Gestures (Mobile)

`tap_element`

Parameters

Support

`swipe`

Parameters

Notes

Example

Support

`drag_and_drop`

Parameters

Support

App Lifecycle (Mobile)

`get_app_state`

Parameters

Returns

Support