webdriverio/mcp

Параметры

• selectorstringобязательный

  Value for the selector, in the form of css selector or xpath ("button.my-class" or "//button[@class='my-class']" or "button=Exact text with spaces" or "a*=Link containing text")

• scrollToViewboolean

  Whether to scroll the element into view before clicking

• timeoutnumber

  Maximum time to wait for element in milliseconds

Параметры

• detachboolean

  If true, disconnect without terminating (preserves app state). Default: false

Параметры

• namestring

  Optional cookie name to delete a specific cookie. If not provided, deletes all cookies

Параметры

• sourceSelectorstringобязательный

  Source element selector to drag

• targetSelectorstring

  Target element selector to drop onto

• xnumber

  Target X offset (if no targetSelector)

• ynumber

  Target Y offset (if no targetSelector)

• durationnumber

  Drag duration in milliseconds

Параметры

• devicestring

  Device preset name (e.g. "iPhone 15", "Pixel 7"). Omit to list available presets. Pass "reset" to restore desktop defaults.

Параметры

• scriptstringобязательный

  JavaScript code (browser) or mobile command string like "mobile: pressKey" (Appium)

• argsarray

  Arguments to pass to the script. For browser: element selectors or values. For mobile commands: command-specific parameters as objects.

Параметры

• limitnumber

  Maximum number of nodes to return (0 = no limit)

• offsetnumber

  Number of nodes to skip for pagination

• rolesstring[]

  Filter by ARIA roles, e.g. ["button", "link", "heading"]

Параметры

• bundleIdstringобязательный

  App bundle ID (iOS) or package name (Android), e.g. "com.example.app"

Параметры

Без параметров.

Параметры

• namestring

  Cookie name to retrieve a specific cookie. If omitted, returns all cookies.

Параметры

• inViewportOnlyboolean

  Only return elements visible in the current viewport (default: false).

• includeContainersboolean

  Include container elements like divs and sections (default: false)

• includeBoundsboolean

  Include element bounding box coordinates (default: false)

• limitnumber

  Maximum number of elements to return (0 = no limit)

• offsetnumber

  Number of elements to skip (for pagination)

Параметры

Без параметров.

Параметры

Без параметров.

Параметры

Без параметров.

Параметры

• portnumber

  Remote debugging port (default: 9222)

• modeenum

  newInstance: open alongside existing Chrome | freshSession: clean profile

  newInstancefreshSession
• copyProfileFilesboolean

  Copy your Default Chrome profile (cookies, logins) into the debug session.

Параметры

• providerenumобязательный

  Cloud provider

  browserstacksaucelabstestmutestingbotdigitalai
• sortByenum

  Sort order for results

  app_nameuploaded_at
• organizationWideboolean

  (BrowserStack only) List apps uploaded by all users in the organization. Defaults to false (own uploads only).

• limitinteger

  Maximum number of apps to return (only applies when organizationWide is true, default 20)

• regionenum

  Sauce Labs region (default: eu-central-1)

  us-west-1eu-central-1apac-southeast-1

Параметры

• urlstringобязательный

  The URL to navigate to

Параметры

• extensionDataanyобязательный

  W3C BiDi webExtension.ExtensionData: unpacked directory path, archive path, or base64 archive.

• pathstringобязательный

  Path inside the extension package, such as options.html or popup.html. Leading slashes are ignored.

Параметры

• orientationenumобязательный

  Device orientation

  PORTRAITLANDSCAPE

Параметры

• directionenumобязательный

  Scroll direction

  updown
• pixelsnumber

  Number of pixels to scroll

Параметры

• namestringобязательный

  Cookie name

• valuestringобязательный

  Cookie value

• domainstring

  Cookie domain (defaults to current domain)

• pathstring

  Cookie path (defaults to "/")

• expirynumber

  Expiry date as Unix timestamp in seconds

• httpOnlyboolean

  HttpOnly flag

• secureboolean

  Secure flag

• sameSiteenum

  SameSite attribute

  strictlaxnone

Параметры

• latitudenumberобязательный

  Latitude coordinate

• longitudenumberобязательный

  Longitude coordinate

• altitudenumber

  Altitude in meters (optional)

Параметры

• selectorstringобязательный

  Value for the selector, in the form of css selector or xpath ("button.my-class" or "//button[@class='my-class']")

• valuestringобязательный

  Text to enter into the element

• scrollToViewboolean

  Whether to scroll the element into view before typing

• timeoutnumber

  Maximum time to wait for element in milliseconds

Параметры

• providerenum

  Session provider (default: local). Use "external" to connect to an externally managed W3C WebDriver endpoint. "digitalai" requires DIGITALAI_CLOUD_URL + DIGITALAI_ACCESS_KEY env vars.

  localbrowserstacksaucelabstestmutestingbotdigitalaiexternal
• platformenumобязательный

  Session platform type

  browseriosandroid
• browserenum

  Browser to launch (required for browser platform)

  chromefirefoxedgesafari
• browserVersionstring

  Browser version (cloud providers only, default: latest)

• osstring

  Operating system for cloud provider browser sessions (e.g. "Windows", "Mac", "macOS", "Linux"). BrowserStack: sets bstack:options.os separately. TestMu/Sauce Labs/TestingBot: combined with osVersion into W3C platformName. Digital.ai: combined with osVersion into the digitalai:osName capability (e.g. "Mac OS Sequoia", "Windows 10") — required for the grid to match a node. Browser platform only.

• osVersionstring

  OS version for cloud provider browser sessions (e.g. "11", "15", "Monterey"). BrowserStack: sets bstack:options.osVersion separately. TestMu/Sauce Labs/TestingBot: combined with os into W3C platformName. Digital.ai: combined with os into digitalai:osName. Browser platform only.

• appstring

  App URL (bs://... for BrowserStack, storage:filename= for Sauce Labs, lt://... for TestMu, tb://... for TestingBot, cloud:<package-or-bundle> for Digital.ai mobile sessions)

• reportingobject

  Cloud provider reporting labels (project, build, session)

• headlessboolean

  Run browser in headless mode (default: true)

• windowWidthnumber

  Browser window width

• windowHeightnumber

  Browser window height

• deviceNamestring

  Mobile device/emulator/simulator name (required for ios/android)

• deviceQuerystring

  Digital.ai device selection query for dynamic allocation, e.g. "@os='android' and @version='14' and @name='.*Pixel.*'". Only used with provider: "digitalai" mobile sessions; if omitted, one is built from deviceName/platformVersion.

• platformVersionstring

  OS version for mobile sessions (e.g., "17.0", "14"). Mobile (ios/android) only.

• appPathstring

  Path to app file (.app/.apk/.ipa)

• automationNameenum

  Automation driver

  XCUITestUiAutomator2
• autoGrantPermissionsboolean

  Auto-grant app permissions (default: true)

• autoAcceptAlertsboolean

  Auto-accept alerts (default: true)

• autoDismissAlertsboolean

  Auto-dismiss alerts (default: false)

• appWaitActivitystring

  Activity to wait for on Android launch

• udidstring

  Unique Device Identifier for iOS real device

• noResetboolean

  Preserve app data between sessions

• fullResetboolean

  Uninstall app before/after session

• newCommandTimeoutnumber

  Appium command timeout in seconds

• traceboolean

  Enable trace recording — produces a Playwright-compatible zip saved to .trace/ on close_session, playable at player.vibium.dev.

• attachboolean

  Attach to existing Chrome instead of launching

• attachConfigobject

  Chrome remote debugging connection (attach mode only, defaults: port 9222, host localhost)

• webdriverConfigobject

  Existing W3C WebDriver endpoint connection (provider: "external" only). Defaults to 127.0.0.1:4445/.

• appiumConfigobject

  Appium server connection (local provider only)

• regionenum

  Sauce Labs region (default: eu-central-1). Only used with provider: "saucelabs".

  us-west-1eu-central-1apac-southeast-1
• tunnelany

  Enable local tunnel routing (cloud providers only, default: false). true = auto-start tunnel before session and stop on close. "external" = tunnel already running externally.

• tunnelNamestring

  Tunnel identifier name. With tunnel: "external" this must match the running tunnel. With tunnel: true a unique name is auto-generated if not provided.

• browserstackLocalany

  Deprecated: use "tunnel" instead. Enable BrowserStack Local tunnel routing.

• saucelabsLocalany

  Deprecated: use "tunnel" instead. Enable Sauce Connect tunnel routing.

• testmuLocalany

  Deprecated: use "tunnel" instead. Enable TestMu Tunnel routing.

• navigationUrlstring

  URL to navigate to after starting

• capabilitiesobject

  Additional capabilities to merge

Параметры

• directionenumобязательный

  Swipe direction

  updownleftright
• durationnumber

  Swipe duration in milliseconds (default: 500)

• percentnumber

  Percentage of screen to swipe (0-1, default: 0.5 for up/down, 0.95 for left/right)

Параметры

• contextstringобязательный

  Context name to switch to (e.g., "NATIVE_APP", "WEBVIEW_com.example.app", or use index from wdio://session/current/contexts resource)

Параметры

• selectorstring

  CSS/XPath selector for the iframe element. Omit to switch back to the top-level frame.

Параметры

• handlestring

  Window handle to switch to

• indexinteger

  0-based tab index to switch to

Параметры

• selectorstring

  Element selector (CSS, XPath, accessibility ID, or UiAutomator)

• xnumber

  X coordinate for screen tap (if no selector provided)

• ynumber

  Y coordinate for screen tap (if no selector provided)

Параметры

• providerenumобязательный

  Cloud provider

  browserstacksaucelabstestmutestingbotdigitalai
• pathstringобязательный

  Absolute path to the .apk or .ipa file

• customIdstring

  Optional custom ID for the app (used to reference it later)

• regionenum

  Sauce Labs region (default: eu-central-1)

  us-west-1eu-central-1apac-southeast-1