1<!doctype html> 2<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current docs-doc-page docs-doc-id-api" data-has-hydrated="false"> 3<head> 4<meta charset="UTF-8"> 5<meta name="generator" content="Docusaurus v3.9.2"> 6<title data-rh="true">Introduction | WebdriverIO</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" property="og:image" content="https://webdriver.io/img/logo-webdriver-io.png"><meta data-rh="true" name="twitter:image" content="https://webdriver.io/img/logo-webdriver-io.png"><meta data-rh="true" property="og:url" content="https://webdriver.io/docs/api"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" property="og:locale:alternate" content="ar"><meta data-rh="true" property="og:locale:alternate" content="de"><meta data-rh="true" property="og:locale:alternate" content="es"><meta data-rh="true" property="og:locale:alternate" content="fr"><meta data-rh="true" property="og:locale:alternate" content="hi"><meta data-rh="true" property="og:locale:alternate" content="it"><meta data-rh="true" property="og:locale:alternate" content="ko"><meta data-rh="true" property="og:locale:alternate" content="pl"><meta data-rh="true" property="og:locale:alternate" content="pt"><meta data-rh="true" property="og:locale:alternate" content="ru"><meta data-rh="true" property="og:locale:alternate" content="sv"><meta data-rh="true" property="og:locale:alternate" content="ta"><meta data-rh="true" property="og:locale:alternate" content="uk"><meta data-rh="true" property="og:locale:alternate" content="vi"><meta data-rh="true" property="og:locale:alternate" content="zh"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="twitter:card" content="summary"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Introduction | WebdriverIO"><meta data-rh="true" name="description" content="Welcome to the WebdriverIO API docs. These pages contain reference materials for all implemented protocol bindings and convenience commands. Protocol commands, including WebDriver, WebDriver Bidi or mobile commands like Appium are commands that are directly send to the underlying driver backend. Convenience commands provided by the browser, element or mock object offer higher level interactivity."><meta data-rh="true" property="og:description" content="Welcome to the WebdriverIO API docs. These pages contain reference materials for all implemented protocol bindings and convenience commands. Protocol commands, including WebDriver, WebDriver Bidi or mobile commands like Appium are commands that are directly send to the underlying driver backend. Convenience commands provided by the browser, element or mock object offer higher level interactivity."><link data-rh="true" rel="icon" href="/img/favicon.png"><link data-rh="true" rel="canonical" href="https://webdriver.io/docs/api"><link data-rh="true" rel="alternate" href="https://webdriver.io/docs/api" hreflang="en"><link data-rh="true" rel="alternate" href="https://webdriver.io/ar/docs/api" hreflang="ar"><link data-rh="true" rel="alternate" href="https://webdriver.io/de/docs/api" hreflang="de"><link data-rh="true" rel="alternate" href="https://webdriver.io/es/docs/api" hreflang="es"><link data-rh="true" rel="alternate" href="https://webdriver.io/fr/docs/api" hreflang="fr"><link data-rh="true" rel="alternate" href="https://webdriver.io/hi/docs/api" hreflang="hi"><link data-rh="true" rel="alternate" href="https://webdriver.io/it/docs/api" hreflang="it"><link data-rh="true" rel="alternate" href="https://webdriver.io/ko/docs/api" hreflang="ko"><link data-rh="true" rel="alternate" href="https://webdriver.io/pl/docs/api" hreflang="pl"><link data-rh="true" rel="alternate" href="https://webdriver.io/pt/docs/api" hreflang="pt"><link data-rh="true" rel="alternate" href="https://webdriver.io/ru/docs/api" hreflang="ru"><link data-rh="true" rel="alternate" href="https://webdriver.io/sv/docs/api" hreflang="sv"><link data-rh="true" rel="alternate" href="https://webdriver.io/ta/docs/api" hreflang="ta"><link data-rh="true" rel="alternate" href="https://webdriver.io/uk/docs/api" hreflang="uk"><link data-rh="true" rel="alternate" href="https://webdriver.io/vi/docs/api" hreflang="vi"><link data-rh="true" rel="alternate" href="https://webdriver.io/zh/docs/api" hreflang="zh"><link data-rh="true" rel="alternate" href="https://webdriver.io/docs/api" hreflang="x-default">
6<link data-rh="true" rel="preconnect" href="https://3G5CUKDJDE-dsn.algolia.net" crossorigin="anonymous">
6<script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Introduction","item":"https://webdriver.io/docs/api"}]}</script>
6<link rel="alternate" type="application/rss+xml" href="/blog/rss.xml" title="WebdriverIO RSS Feed"> 7<link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" title="WebdriverIO Atom Feed"> 8 9<link rel="preconnect" href="https://www.google-analytics.com">
10<script>window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-47063382-1","auto"),ga("set","anonymizeIp",!0),ga("send","pageview")</script>
vendor: 1 bytes, line 10
10
11<script async src="https://www.google-analytics.com/analytics.js"></script>
11 12 13 14 15<link rel="search" type="application/opensearchdescription+xml" title="WebdriverIO" href="/opensearch.xml"> 16 17 18 19<link rel="icon" href="/img/logo-webdriver-io.png"> 20<link rel="manifest" href="/manifest.json"> 21<meta name="theme-color" content="rgb(234, 90, 7)"> 22<meta name="apple-mobile-web-app-capable" content="yes"> 23<meta name="apple-mobile-web-app-status-bar-style" content="#000"> 24<link rel="apple-touch-icon" href="/img/logo-webdriver-io.png"> 25<link rel="mask-icon" href="/img/logo-webdriver-io.svg" color="rgb(234, 90, 7)"> 26<meta name="msapplication-TileImage" content="/img/logo-webdriver-io.png"> 27<meta name="msapplication-TileColor" content="#000"> 28 29 30 31<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;700&display=block"> 32<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;700&display=block">
33<script src="https://buttons.github.io/buttons.js"></script>
vendor: 1 bytes, line 33
33
34<script src="/js/ribbons.js"></script>
34<link rel="stylesheet" href="/assets/css/styles.e1927623.css">
35<script src="/assets/js/runtime~main.1cf33942.js" defer="defer"></script>
vendor: 1 bytes, line 35
35
36<script src="/assets/js/main.748f0387.js" defer="defer"></script>
36 37</head> 38<body class="navigation-with-keyboard"> 39<svg style="display: none;"><defs> 40<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol> 41</defs></svg>
42<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const n=new URLSearchParams(window.location.search).entries();for(var[t,e]of n)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}(),document.documentElement.setAttribute("data-announcement-bar-initially-dismissed",function(){try{return"true"===localStorage.getItem("docusaurus.announcement.dismiss")}catch(t){}return!1}())</script>
42<div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_rrU8" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><div class="theme-announcement-bar announcementBar_zxs0" role="banner"><div class="announcementBarPlaceholder_szcJ"></div><div class="content_VPCh announcementBarContent_NGMT">ðºð¦ We stand with the people of Ukraine. We encourage compassion, and hope for peace. ðºð¦<br>Please support humanitarian efforts for the Ukraine crisis through the <a target="_blank" rel="noopener noreferrer" href="https://www.icrc.org/en/donate/ukraine">International Committee of the Red Cross</a>! #StandWithUkraine</div><button type="button" aria-label="Close" class="clean-btn close closeButton_ixzz announcementBarClose_wYOc"><svg viewBox="0 0 15 15" width="14" height="14"><g stroke="currentColor" stroke-width="3.1"><path d="M.75.75l13.5 13.5M14.25.75L.75 14.25"></path></g></svg></button></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB3aWR0aD0iNjRweCIgaGVpZ2h0PSI2NHB4IiB2aWV3Qm94PSIwIDAgNjQgNjQiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CiAgICA8dGl0bGU+TG9nbyBSZWd1bGFyPC90aXRsZT4KICAgIDxnIGlkPSJMb2dvLVJlZ3VsYXIiIHN0cm9rZT0ibm9uZSIgc3Ryb2tlLXdpZHRoPSIxIiBmaWxsPSJub25lIiBmaWxsLXJ1bGU9ImV2ZW5vZGQiPgogICAgICAgIDxyZWN0IGlkPSJSZWN0YW5nbGUiIGZpbGw9IiNFQTU5MDYiIHg9IjAiIHk9IjAiIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgcng9IjUiPjwvcmVjdD4KICAgICAgICA8cGF0aCBkPSJNOCwxNiBMOCw0OCBMNiw0OCBMNiwxNiBMOCwxNiBaIE00MywxNiBDNTEuODM2NTU2LDE2IDU5LDIzLjE2MzQ0NCA1OSwzMiBDNTksNDAuODM2NTU2IDUxLjgzNjU1Niw0OCA0Myw0OCBDMzQuMTYzNDQ0LDQ4IDI3LDQwLjgzNjU1NiAyNywzMiBDMjcsMjMuMTYzNDQ0IDM0LjE2MzQ0NCwxNiA0MywxNiBaIE0yNywxNiBMMTQuMTA2LDQ3Ljk5OTIwNzggTDExLjk5OSw0Ny45OTkyMDc4IEwyNC44OTQsMTYgTDI3LDE2IFogTTQzLDE4IEMzNS4yNjgwMTM1LDE4IDI5LDI0LjI2ODAxMzUgMjksMzIgQzI5LDM5LjczMTk4NjUgMzUuMjY4MDEzNSw0NiA0Myw0NiBDNTAuNzMxOTg2NSw0NiA1NywzOS43MzE5ODY1IDU3LDMyIEM1NywyNC4yNjgwMTM1IDUwLjczMTk4NjUsMTggNDMsMTggWiIgaWQ9IkNvbWJpbmVkLVNoYXBlIiBmaWxsPSIjRkZGRkZGIj48L3BhdGg+CiAgICA8L2c+Cjwvc3ZnPg==" alt="WebdriverIO" class="themedComponent_TDLl themedComponent--light_DFAV"><img src="data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB3aWR0aD0iNjRweCIgaGVpZ2h0PSI2NHB4IiB2aWV3Qm94PSIwIDAgNjQgNjQiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CiAgICA8dGl0bGU+TG9nbyBSZWd1bGFyPC90aXRsZT4KICAgIDxnIGlkPSJMb2dvLVJlZ3VsYXIiIHN0cm9rZT0ibm9uZSIgc3Ryb2tlLXdpZHRoPSIxIiBmaWxsPSJub25lIiBmaWxsLXJ1bGU9ImV2ZW5vZGQiPgogICAgICAgIDxyZWN0IGlkPSJSZWN0YW5nbGUiIGZpbGw9IiNFQTU5MDYiIHg9IjAiIHk9IjAiIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgcng9IjUiPjwvcmVjdD4KICAgICAgICA8cGF0aCBkPSJNOCwxNiBMOCw0OCBMNiw0OCBMNiwxNiBMOCwxNiBaIE00MywxNiBDNTEuODM2NTU2LDE2IDU5LDIzLjE2MzQ0NCA1OSwzMiBDNTksNDAuODM2NTU2IDUxLjgzNjU1Niw0OCA0Myw0OCBDMzQuMTYzNDQ0LDQ4IDI3LDQwLjgzNjU1NiAyNywzMiBDMjcsMjMuMTYzNDQ0IDM0LjE2MzQ0NCwxNiA0MywxNiBaIE0yNywxNiBMMTQuMTA2LDQ3Ljk5OTIwNzggTDExLjk5OSw0Ny45OTkyMDc4IEwyNC44OTQsMTYgTDI3LDE2IFogTTQzLDE4IEMzNS4yNjgwMTM1LDE4IDI5LDI0LjI2ODAxMzUgMjksMzIgQzI5LDM5LjczMTk4NjUgMzUuMjY4MDEzNSw0NiA0Myw0NiBDNTAuNzMxOTg2NSw0NiA1NywzOS43MzE5ODY1IDU3LDMyIEM1NywyNC4yNjgwMTM1IDUwLjczMTk4NjUsMTggNDMsMTggWiIgaWQ9IkNvbWJpbmVkLVNoYXBlIiBmaWxsPSIjRkZGRkZGIj48L3BhdGg+CiAgICA8L2c+Cjwvc3ZnPg==" alt="WebdriverIO" class="themedComponent_TDLl themedComponent--dark_kZl4"></div></a><a class="navbar__item navbar__link" href="/docs/gettingstarted">Docs</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/docs/api">API</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" href="/docs/contribute">
42Contribute</a><a class="navbar__item navbar__link" href="/community/support">Community</a><a class="navbar__item navbar__link" href="/docs/sponsor">Sponsor</a></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">v9</a><ul class="dropdown__menu"><li><a href="https://webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v9<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li><a href="https://v8.webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v8<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li><a href="https://v7.webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v7<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li><a href="https://v6.webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v6<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li><a href="https://v5.webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v5<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li><a href="http://v4.webdriver.io" target="_blank" rel="noopener noreferrer" class="dropdown__link dropdown-version-item">v4<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_YExK"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/ar/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="ar">اÙعربÙØ©</a></li><li><a href="/de/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="de">Deutsch</a></li><li><a href="/es/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="es">Español</a></li><li><a href="/fr/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="fr">Français</a></li><li><a href="/hi/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="hi">हिनà¥à¤¦à¥</a></li><li><a href="/it/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="it">Italiano</a></li><li><a href="/ko/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="ko">íêµì´</a></li><li><a href="/pl/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="pl">Polski</a></li><li><a href="/pt/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="pt">Português</a></li><li><a href="/ru/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="ru">Ð ÑÑÑкий</a></li><li><a href="/sv/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="sv">Svenska</a></li><li><a href="/ta/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="ta">தமிழà¯</a></li><li><a href="/uk/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="uk">УкÑаÑнÑÑка</a></li><li><a href="/vi/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="vi">Tiếng Viá»t</a></li><li><a href="/zh/docs/api" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh">ä¸æ</a></li><li class=""><hr style="margin: 0.3rem 0;"></li><li><a href="https://github.com/webdriverio/i18n#supported-languages" target="_blank" rel="noopener noreferrer" class="dropdown__link">Add your language<svg width="12" height="12" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><a href="https://github.com/webdriverio/webdriverio" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-github-link" aria-label="GitHub repository"></a><a href="https://x.com/webdriverio" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-twitter-link" aria-label="@webdriverio on ð"></a><a href="https://youtube.com/@webdriverio" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-youtube-link" aria-label="@webdriverio on YouTube"></a><a href="https://discord.webdriver.io/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-discord-link" aria-label="Support Chat on Discord"></a><div class="toggle_DMK0 colorModeToggle_EmEJ"><button class="clean-btn toggleButton_cgGF toggleButtonDisabled_BMh6" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_dK3j lightToggleIcon_oXDl">
42<path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_dK3j darkToggleIcon_TPJS"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" class="toggleIcon_dK3j systemToggleIcon_m8Yx"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Ram2"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search (Command+K)"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_qsob"><div class="docsWrapper_tZ24"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_ioUu" type="button"></button><div class="docRoot_aP7m"><aside class="theme-doc-sidebar-container docSidebarContainer_hWoP"><div class="sidebarViewport_DAlU"><div class="sidebar__Kyh"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_AC_x menuWithAnnouncementBar_qAfi"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" href="/docs/api"><span title="Introduction" class="linkLabel_QbzJ">Introduction</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/protocols"><span title="Protocols" class="categoryLinkLabel_Lp4b">Protocols</span></a><button aria-label="Expand sidebar category 'Protocols'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/browser"><span title="browser" class="categoryLinkLabel_Lp4b">browser</span></a><button aria-label="Expand sidebar category 'browser'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/element"><span title="element" class="categoryLinkLabel_Lp4b">element</span></a><button aria-label="Expand sidebar category 'element'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/mobile"><span title="mobile" class="categoryLinkLabel_Lp4b">mobile</span></a><button aria-label="Expand sidebar category 'mobile'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/mock"><span title="mock" class="categoryLinkLabel_Lp4b">mock</span></a><button aria-label="Expand sidebar category 'mock'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/dialog"><span title="dialog" class="categoryLinkLabel_Lp4b">dialog</span></a><button aria-label="Expand sidebar category 'dialog'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_SWMM menu__link menu__link--sublist" href="/docs/api/clock"><span title="clock" class="categoryLinkLabel_Lp4b">clock</span></a><button aria-label="Expand sidebar category 'clock'" aria-expanded="false" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/api/expect-webdriverio"><span title="Expect" class="linkLabel_QbzJ">Expect</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/api/globals"><span title="Globals" class="linkLabel_QbzJ">Globals</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/api/environment"><span title="Environment Variables" class="linkLabel_QbzJ">Environment Variables</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/docs/api/modules"><span title="Modules" class="linkLabel_QbzJ">Modules</span></a></li></ul></nav></div></div></aside><main class="docMainContainer_PL_x"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VYqs"><div class="docItemContainer_eX6x"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_q9hb" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon__nX2"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Introduction</span></li></ul></nav><div class="tocCollapsible_MbWw theme-doc-toc-mobile tocMobile_lRJI"><button type="button" class="clean-btn tocCollapsibleButton_kL7n">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Introduction</h1></header><p>Welcome to the WebdriverIO API docs. These pages contain reference materials for all implemented protocol bindings and convenience commands. Protocol commands, including <a class="" href="/docs/api/webdriver">WebDriver</a>, <a class="" href="/docs/api/webdriverBidi">WebDriver Bidi</a> or mobile commands like <a href="http://appium.io" target="_blank" rel="noopener noreferrer" class="">Appium</a> are commands that are directly send to the underlying driver backend. Convenience commands provided by the <a class="" href="/docs/api/browser"><code>browser</code></a>, <a class="" href="/docs/api/element"><code>element</code></a> or <a class="" href="/docs/api/mock"><code>mock</code></a> object offer higher level interactivity.</p> 43<div class="theme-admonition theme-admonition-info admonition_WfZ_ alert alert--info"><div class="admonitionHeading_qibW"><span class="admonitionIcon_nAYM"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>info</div><div class="admonitionContent_d0_1"><p>These are the docs for the latest version (<strong>>=8.x</strong>) of WebdriverIO. If you are still using an older version, please visit the <a class="" href="/versions">old documentation websites</a>!</p></div></div> 44<h2 class="anchor anchorTargetStickyNavbar_tva9" id="contribute">
44Contribute<a href="#contribute" class="hash-link" aria-label="Direct link to Contribute" title="Direct link to Contribute" translate="no">â</a></h2> 45<p>If you feel like you have a good example for a command, don't hesitate to open a PR and submit it. Just click on the orange link on the bottom left with the label <em>âEdit this pageâ</em>. Make sure you understand the way we write these docs by checking the <a href="https://github.com/webdriverio/webdriverio/blob/main/CONTRIBUTING.md" target="_blank" rel="noopener noreferrer" class="">Contributing</a> section.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_MLUi"><a href="https://github.com/webdriverio/webdriverio/edit/main/website/docs/API.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_mtqG" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_lPmR"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--next" href="/docs/api/protocols"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Protocol Commands</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_Hj2R thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#contribute" class="table-of-contents__link toc-highlight">Contribute</a></li></ul></div></div></div></div></main></div></div></div><div id="ms-floating-button" class="ms-fixed ms-bottom-4 ms-right-8 ms-z-[100] ms-flex ms-flex-col ms-items-end hover:ms-cursor-pointer"><div class="ms-relative ms-mb-4"><div style="background-color:#EA5906" class="ms-absolute -ms-bottom-1 ms-right-6 -ms-z-10 ms-h-4 ms-w-4 ms-rotate-45"></div><div style="background-color:#EA5906" class="ms-z-10 ms-flex ms-items-center ms-justify-center ms-rounded-lg ms-px-3 ms-py-2"><p style="color:#ffffff;margin:0" class="ms-text-sm">Welcome! How can I help?</p></div></div><div style="background-color:#EA5906" class="ms-flex ms-h-16 ms-w-16 ms-flex-col ms-items-center ms-justify-center ms-self-end ms-rounded-full ms-p-2 ms-transition"><div class="ms-rotate-0 ms-flex ms-h-full ms-w-full ms-transform ms-cursor-pointer ms-items-center ms-justify-center ms-rounded-full ms-transition-all ms-delay-75 ms-duration-100 ms-ease-in-out"><img src="/img/materials/robot-white.svg" alt="WebdriverIO AI Copilot" width="40px"></div></div><div></div></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs/gettingstarted">Getting Started</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/api">API Reference</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/contribute/">Contribute</a></li><li class="footer__item"><a class="footer__link-item" href="/community/support">Help</a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/webdriver-io" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://discord.webdriver.io" target="_blank" rel="noopener noreferrer" class="footer__link-item">Support Chat<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://seleniumhq.slack.com/join/shared_invite/zt-f7jwg1n7-RVw4v4sMA7Zjufira_~EVw#/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Slack<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://x.com/webdriverio" target="_blank" rel="noopener noreferrer" class="footer__link-item">ð<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div>
45<div class="theme-layout-footer-column col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/blog">Blog</a></li><li class="footer__item"><a class="footer__link-item" href="/docs/sponsor">Sponsor</a></li><li class="footer__item"><a href="https://shop.webdriver.io" target="_blank" rel="noopener noreferrer" class="footer__link-item">Swag Store<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li><li class="footer__item"><a href="https://youtube.com/@webdriverio" target="_blank" rel="noopener noreferrer" class="footer__link-item">YouTube<svg width="13.5" height="13.5" aria-label="(opens in new tab)" class="iconExternalLink_mZyn"><use href="#theme-svg-external-link"></use></svg></a></li></ul></div><div class="theme-layout-footer-column col footer__col"><div class="footer__title">Sponsored by</div><ul class="footer__items clean-list"><li class="footer__item"> 46 <a href="https://www.browserstack.com/automation-webdriverio" target="_blank" rel="noreferrer noopener" aria-label="Premium Sponsor BrowserStack"> 47 <img src="/img/sponsors/browserstack_white.svg" alt="BrowserStack"> 48 </a></li><li class="footer__item"> 49 <a href="https://momentic.ai/" target="_blank" rel="noreferrer noopener" aria-label="Premium Sponsor Momentic"> 50 <img src="/img/sponsors/momentic_white.svg" alt="Momentic"> 51 </a></li></ul></div></div><div class="footer__bottom text--center"><div class="margin-bottom--sm"><a href="https://openjsf.org/" rel="noopener noreferrer" class="footerLogoLink_eTwg"><img src="https://raw.githubusercontent.com/openjs-foundation/artwork/main/openjs_foundation/openjs_foundation-logo-horizontal-color-dark_background.svg" alt="OpenJS Foundation Logo" class="footer__logo themedComponent_TDLl themedComponent--light_DFAV"><img src="https://raw.githubusercontent.com/openjs-foundation/artwork/main/openjs_foundation/openjs_foundation-logo-horizontal-color-dark_background.svg" alt="OpenJS Foundation Logo" class="footer__logo themedComponent_TDLl themedComponent--dark_kZl4"></a></div><div class="footer__copyright"> 52 <p> 53 Copyright 2026 <a href="https://openjsf.org">OpenJS Foundation</a> and WebdriverIO contributors. All rights reserved. The <a href="https://openjsf.org">OpenJS Foundation</a> has registered trademarks and uses trademarks. For a list of trademarks of the <a href="https://openjsf.org">OpenJS Foundation</a>, please see our <a href="https://trademark-policy.openjsf.org/">Trademark Policy</a> and <a href="https://trademark-list.openjsf.org/">Trademark List</a>. Trademarks and logos not indicated on the <a href="https://trademark-list.openjsf.org">list of OpenJS Foundation trademarks</a> are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them. 54 </p> 55 <p> 56 <a href="https://openjsf.org/">The OpenJS Foundation</a> | <a href="https://terms-of-use.openjsf.org/">Terms of Use</a> | <a href="https://privacy-policy.openjsf.org/">Privacy Policy</a> | <a href="https://bylaws.openjsf.org/">Bylaws</a> | <a href="https://code-of-conduct.openjsf.org/">Code of Conduct</a> | <a href="https://trademark-policy.openjsf.org/">Trademark Policy</a> | <a href="https://trademark-list.openjsf.org/">Trademark List</a> | <a href="https://www.linuxfoundation.org/cookies/">Cookie Policy</a> 57 </p> 58 </div></div></div></footer></div> 59</body> 60</html>
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.