JsonWireProtocolLukeInman-Semerau編輯了此頁面on26Feb2016·6次修訂WebDriver有線協議介紹與瀏覽器或RemoteWebDriver服務器通信的所有WebDriver實現都應使用通用的有線協議。此有線協議使用JSONoverHTTP定義RESTfulWeb服務。該協議將假設WebDriverAPI已經“扁平化”，但是期望客戶端實現將采用更加面向對象的方法，如現有JavaAPI中所示。有線協議在“命令”和“響應”的請求/響應對中實現。基本術語和概念客戶正在使用WebDriverAPI的計算機。服務器運行RemoteWebDriver的機器。該術語還可以指直接實現有線協議的特定瀏覽器，例如FirefoxDriver或IPhoneDriver。會議服務器應該每個會話維護一個瀏覽器。發送到會話的命令將定向到相應的瀏覽器。WebElementWebDriverAPI中的一個對象，表示頁面上的DOM元素。WebElementJSON對象WebElement的JSON表示，用于通過線路傳輸。該對象具有以下屬性：鍵 類型 描述元件 串 服務器分配給元素的不透明ID。此ID應在針對該元素發出的所有后續命令中使用。功能JSON對象并非所有服務器實現都支持每個WebDriver功能。因此，在描述會話支持的功能時，客戶端和服務器應使用具有下面列出的屬性的JSON對象。鍵 類型 描述browserName 串 正在使用的瀏覽器的名稱;應該是其中之一{chrome|firefox|htmlunit|internetexplorer|iphone}。版 串 瀏覽器版本，如果未知則為空字符串。平臺 串 一個鍵，指定運行瀏覽器的平臺。這個值應該是其中之一{WINDOWS|XP|VISTA|MAC|LINUX|UNIX}。當請求新會話時，客戶端可以指定ANY指示可以使用任何可用平臺。javascriptEnabled 布爾 會話是否支持在當前頁面的上下文中執行用戶提供的JavaScript。takesScreenshot 布爾 會話是否支持截取當前頁面的屏幕截圖。handlesAlerts 布爾 會話是否可以與模態彈出窗口交互，例如window.alert和window.confirm。databaseEnabled 布爾 會話是否可以交互數據庫存儲。locationContextEnabled 布爾 會話是否可以設置和查詢瀏覽器的位置上下文。applicationCacheEnabled 布爾 會話是否可以與應用程序緩存交互。browserConnectionEnabled 布爾 會話是否可以查詢瀏覽器的連接并在需要時禁用它。cssSelectorsEnabled 布爾 在搜索元素時，會話是否支持CSS選擇器。webStorageEnabled 布爾 會話是否支持與存儲對象的交互。可旋轉 布爾 會話是否可以在縱向和橫向之間旋轉當前頁面的當前布局（僅適用于移動平臺）。acceptSslCerts 布爾 會話是否應默認接受所有SSL證書。nativeEvents 布爾 會話是否能夠在模擬用戶輸入時生成本機事件。代理 代理對象 要使用的任何代理的詳細信息。如果未指定代理，則使用系統的當前或默認狀態。格式在ProxyJSONObject下指定。期望的能力客戶端發送的功能JSON對象，描述服務器創建的新會話應具備的功能。任何省略的鍵都隱含地表明相應的功能是無關緊要的。更多DesiredCapabilities。實際能力服務器返回的功能JSON對象，描述會話實際支持的功能。任何省略的鍵都隱式指示不支持相應的功能。CookieJSON對象描述Cookie的JSON對象。鍵 類型 描述名稱 串 cookie的名稱。值 串 cookie值。路徑 串 （可選）cookie路徑。1域 串 （可選）cookie可見的域。1安全 布爾 （可選）cookie是否是安全cookie。1僅Http 布爾 （可選）cookie是否為httpOnlycookie。1到期 數 （可選）當cookie過期時，自UTC時間1970年1月1日午夜起以秒為單位指定。11返回Cookie對象時，如果服務器無法提供信息，則只應省略可選字段。日志條目JSON對象描述日志條目的JSON對象。鍵 類型 描述時間戳 數 條目的時間戳。水平 串 條目的日志級別，例如“INFO”（請參閱日志級別）。信息 串 日志消息。日志級別按順序記錄日志級別，最高級別和底部最粗糙級別。水平 描述所有 所有日志消息。用于獲取日志和日志記錄配置。DEBUG 用于調試的消息。信息 包含用戶信息的消息。警告 對應于非關鍵問題的消息。嚴重 與嚴重錯誤相對應的消息。關閉 沒有日志消息。用于配置日志記錄。日志類型下表列出了常見的日志類型。其他日志類型（例如，用于性能日志記錄）也可用。日志類型 描述客戶 從客戶端登錄。司機 從webdriver登錄。瀏覽器 從瀏覽器登錄。服務器 從服務器登錄。代理JSON對象描述代理配置的JSON對象。鍵 類型 描述的proxyType 串 （必需）正在使用的代理類型。可能的值有：direct-直接連接-沒有使用代理，手動-配置手動代理設置，例如設置HTTP代理，FTP代理等，pac-從URL代理自動配置，自動檢測-代理自動檢測，可能使用WPAD，系統-使用系統設置proxyAutoconfigUrl 串 （如果proxyType==pac，則為必需，否則為Ignued）指定用于代理自動配置的URL。預期的格式示例：http：//：1234/pacfileftpProxy，httpProxy，sslProxy，socksProxy 串 （可選，如果proxyType！=manual則忽略）指定分別用于FTP，HTTP，HTTPS和SOCKS請求的代理。如果發出請求，則行為未定義，如果proxyType是手動的，則特定協議的代理未定義。預期的格式示例：:1234socksUsername 串 （可選，如果未設置proxyType！=manual且未設置socksProxy，則忽略）指定SOCKS代理用戶名。socksPassword 串 （可選，如果未設置proxyType！=manual且未設置socksProxy，則忽略）指定SOCKS代理密碼。NOPROXY 串 （可選，如果proxyType！=manual則忽略）指定代理繞過地址。格式是特定于驅動程序消息命令WebDriver命令消息應符合HTTP/1.1請求規范。盡管可以擴展服務器以響應其他內容類型，但是有線協議規定所有命令都接受內容類型application/json;charset=UTF-8。同樣，POST和PUT請求的消息體必須使用application/json;charset=UTF-8內容類型。WebDriver服務中的每個命令都將映射到特定路徑的HTTP方法。前綴為冒號（:)的路徑段表示該段是用于進一步標識基礎資源的變量。例如，考慮將任意資源映射為：GET/favorite/color/:name給定此映射，服務器應響應發送到“/favorite/color/Jack”和“/favorite/color/Jill”的GET請求，變量分別:name設置為“Jack”和“Jill”。回應命令響應應作為HTTP/1.1響應消息發送。如果遠程服務器必須返回4xx響應，則響應正文應具有text-typeoftext/plain，并且消息正文應為錯誤請求的描述性消息。對于所有其他情況，如果響應包含消息正文，則它必須具有Content-Typeofapplication/json;charset=UTF-8并且將是具有以下屬性的JSON對象：鍵 類型 描述的sessionId 串 空值狀態 數 總結命令結果的狀態代碼。非零值表示命令失敗。值 * 響應JSON值。響應狀態代碼有線協議將繼承InternetExplorerDriver使用的狀態代碼：碼 摘要 詳情0 Success 命令執行成功。6 NoSuchDriver 會話終止或未啟動7 NoSuchElement 使用給定的搜索參數無法在頁面上找到元素。8 NoSuchFrame 無法滿足切換到幀的請求，因為無法找到幀。9 UnknownCommand 找不到請求的資源，或者使用映射資源不支持的HTTP方法收到請求。10 StaleElementReference 元素命令失敗，因為引用的元素不再附加到DOM。11 ElementNotVisible 無法完成元素命令，因為該元素在頁面上不可見。12 InvalidElementState 無法完成元素命令，因為元素處于無效狀態（例如，嘗試單擊禁用的元素）。13 UnknownError 處理命令時發生未知的服務器端錯誤。15 ElementIsNotSelectable 嘗試選擇無法選擇的元素。17 JavaScriptError 執行用戶提供的JavaScript時發生錯誤。19 XPathLookupError 通過XPath搜索元素時發生錯誤。21 Timeout 操作在超時到期之前未完成。23 NoSuchWindow 無法滿足切換到其他窗口的請求，因為找不到窗口。24 InvalidCookieDomain 非法嘗試在與當前頁面不同的域下設置cookie。25 UnableToSetCookie 無法滿足設置cookie值的請求。26 UnexpectedAlertOpen 模態對話框已打開，阻止此操作27 NoAlertOpenError 當一個未打開時，嘗試在模態對話框上進行操作。28 ScriptTimeout 腳本在超時到期之前未完成。29 InvalidElementCoordinates 提供給交互操作的坐標無效。三十 IMENotAvailable IME不可用。31 IMEEngineActivationFailed 無法啟動IME引擎。32 InvalidSelector 參數是一個無效的選擇器（例如XPath/CSS）。33 SessionNotCreatedException 無法創建新會話。34 MoveTargetOutOfBounds 為移動行動提供的目標是不受限制的。客戶端應將服務器的404NotFound響應解釋為“未知命令”響應。來自服務器的未定義狀態字段的所有其他4xx和5xx響應應解釋為“未知錯誤”響應。錯誤處理有線協議指定了兩個級別的錯誤處理：無效請求和失敗命令。無效的請求所有無效請求都應導致服務器返回4xxHTTP響應。響應Content-Type應設置為text/plain，并且消息正文應該是描述性錯誤消息。無效請求的類別如下：未知的命令如果服務器收到其路徑未映射到REST服務中的資源的命令請求，則它應響應404NotFound消息。未實現的命令每個實現WebDriver有線協議的服務器都必須響應每個已定義的命令。如果尚未在服務器上實現單個命令，則服務器應響應501NotImplemented錯誤消息。請注意，這是無效請求類別中唯一未返回4xx狀態代碼的錯誤。找不到可變資源如果請求路徑映射到變量資源，但該資源不存在，則服務器應以a響應404NotFound。例如，如果IDmy-session不是服務器上的有效會話ID，并且發送命令GET/session/my-sessionHTTP/1.1，則服務器應該正常返回404。無效的命令方法如果請求路徑映射到有效資源，但該資源未響應請求方法，則服務器應以a響應405MethodNotAllowed。響應必須包含Allow標頭，其中包含所請求資源的允許方法列表。缺少命令參數如果POST/PUT命令映射到需要一組JSON參數的資源，并且響應主體不包含其中一個參數，則服務器應以a響應400BadRequest。響應正文應列出缺少的參數。命令失敗如果請求映射到有效命令并包含請求正文中的所有預期參數，但未能成功執行，則服務器應發送500內部服務器錯誤。此響應應具有Content-Type，application/json;charset=UTF-8并且響應主體應該是格式良好的JSON響應對象。響應狀態應該是已定義的狀態代碼之一，響應值應該是另一個JSON對象，其中包含失敗命令的詳細信息：鍵 類型 描述信息 串 命令失敗的描述性消息。屏幕 串 （可選）如果包含，則將當前頁面的屏幕截圖作為base64編碼的字符串。類 串 （可選）如果包含，則指定命令失敗時引發的異常的完全限定類名。堆棧跟蹤 排列 （可選）如果包含，則指定一組JSON對象，這些對象描述命令失敗時引發的異常的堆棧跟蹤。數組的zeroeth元素表示堆棧的頂部。stackTrace數組中的每個JSON對象都必須包含以下屬性：鍵 類型 描述文件名 串 包含此幀表示的行的源文件的名稱。班級名稱 串 此框架中活動的類的完全限定類名。如果無法確定類名，或者不適用于實現服務器的語言，則應將此屬性設置為空字符串。方法名 串 此框架中活動的方法的名稱，如果未知/不適用，則為空字符串。電話號碼 數 幀的原始源文件中的行號，如果未知則為0。資源映射WebDriverREST服務中的資源映射到各個URL模式。每個資源可以響應一個或多個HTTP請求方法。如果資源響應GET請求，那么它也應該響應HEAD請求。所有資源都應使用Allow標頭字段響應OPTIONS請求，標頭字段的值是資源響應的所有方法的列表。如果資源映射到包含可變路徑段名稱的URL，則應使用該路徑段進一步路由請求。可變路徑段在資源映射中由冒號前綴指示。例如，請考慮以下事項：/favorite/color/:person映射到此URL的資源應解析:person路徑段的值，以進一步確定如何響應請求。如果此資源收到請求/favorite/color/Jack，則應返回Jack最喜歡的顏色。同樣，服務器應該返回任何請求的Jill最喜歡的顏色/favorite/color/Jill。如果其中一個資源的模式包含可變路徑段，而另一個資源的模式不包含可變路徑段，則兩個資源只能映射到相同的URL模式。在這些情況下，服務器應始終將請求路由到其路徑與請求最匹配的資源。考慮以下兩個資源路徑：/session/:sessionId/element/active/session/:sessionId/element/:id給定這些映射，服務器應始終將最終路徑段處于活動狀態的請求路由到第一個資源。所有其他請求應路由到第二個。命令參考命令摘要HTTP方法 路徑 摘要得到 /狀態 查詢服務器的當前狀態。POST /會話 創建一個新會話。得到 /會話 返回當前活動會話的列表。得到 /會話/：的sessionId 檢索指定會話的功能。刪除 /會話/：的sessionId 刪除會話。POST /會話/：的sessionId/超時 配置特定類型的操作在中止之前可以執行的時間量和aPOST /會話/：的sessionId/超時/async_script 設置執行的異步腳本/session/:sessionId/execute_async在中止之前允許運行的時間（以毫秒為單位）和aPOST /會話/：的sessionId/超時/implicit_wait 設置驅動程序在搜索元素時應等待的時間。得到 /會話/：的sessionId/WINDOW_HANDLE 檢索當前窗口句柄。得到 /會話/：的sessionId/window_handles 檢索會話可用的所有窗口句柄的列表。得到 /會話/：的sessionId/URL 檢索當前頁面的URL。POST /會話/：的sessionId/URL 導航到新網址。POST /會話/：的sessionId/前進 如果可能，在瀏覽器歷史記錄中向前導航。POST /會話/：的sessionId/回 如果可能，在瀏覽器歷史記錄中向后導航。POST /會話/：的sessionId/刷新 刷新當前頁面。POST /會話/：的sessionId/執行 將一段JavaScript注入頁面，以便在當前所選幀的上下文中執行。POST /會話/：的sessionId/execute_async 將一段JavaScript注入頁面，以便在當前所選幀的上下文中執行。得到 /會話/：的sessionId/截圖 截取當前頁面的屏幕截圖。得到 /會話/：的sessionId/IME/available_engines 列出機器上所有可用的引擎。得到 /會話/：的sessionId/IME/active_engine 獲取活動IME引擎的名稱。得到 /會話/：的sessionId/IME/激活 指示此時IME輸入是否處于活動狀態（而不是它是否可用）。POST /會話/：的sessionId/IME/停用 取消激活當前活動的IME引擎。POST /會話/：的sessionId/IME/激活 使一個可用的引擎（在getAvailableEngines返回的列表中顯示）處于活動狀態。POST /會話/：的sessionId/幀 將焦點更改為頁面上的另一個幀。POST /會話/：的sessionId/幀/親 將焦點更改為父上下文。POST /會話/：的sessionId/窗口 將焦點更改為另一個窗口。刪除 /會話/：的sessionId/窗口 關閉當前窗口。POST /會話/：的sessionId/窗/：windowHandle/尺寸 更改指定窗口的大小。得到 /會話/：的sessionId/窗/：windowHandle/尺寸 獲取指定窗口的大小。POST /會話/：的sessionId/窗/：windowHandle/位置 更改指定窗口的位置。得到 /會話/：的sessionId/窗/：windowHandle/位置 獲取指定窗口的位置。POST /會話/：的sessionId/窗/：windowHandle/最大化 如果尚未最大化，則最大化指定的窗口。得到 /會話/：的sessionId/餅干 檢索當前頁面可見的所有Cookie。POST /會話/：的sessionId/餅干 設置一個cookie。刪除 /會話/：的sessionId/餅干 刪除當前頁面可見的所有Cookie。刪除 /會話/：的sessionId/餅干/：名稱 刪除具有給定名稱的cookie。得到 /會話/：的sessionId/源 獲取當前頁面源。得到 /會話/：的sessionId/標題 獲取當前頁面標題。POST /會話/：的sessionId/元件 從文檔根目錄開始在頁面上搜索元素。POST /會話/：的sessionId/元件 從文檔根目錄開始在頁面上搜索多個元素。POST /會話/：的sessionId/元件/活性 獲取當前具有焦點的頁面上的元素。得到 /會話/：的sessionId/元/：ID 描述已識別的元素。POST /會話/：的sessionId/元/：ID/元素 從標識的元素開始，在頁面上搜索元素。POST /會話/：的sessionId/元件/：ID/元素 從標識的元素開始，在頁面上搜索多個元素。POST /會話/：的sessionId/元/：ID/點擊 單擊元素。POST /會話/：的sessionId/元/：ID/提交 提交一個FORM元素。得到 /會話/：的sessionId/元/：ID/文 返回元素的可見文本。POST /會話/：的sessionId/元件/：ID/值 將一系列擊鍵發送到元素。POST /會話/：的sessionId/鍵 將一系列擊鍵發送到活動元素。得到 /會話/：的sessionId/元/：ID/名稱 查詢元素的標記名稱。POST /會話/：的sessionId/元/：ID/清除 清除aTEXTAREA或textINPUT元素的值。得到 /會話/：的sessionId/元件/：ID/選擇 確定當前是否選擇了OPTION元素或INPUT類型checkbox或元素radiobutton。得到 /會話/：的sessionId/元/：ID/啟用 確定當前是否啟用了元素。得到 /會話/：的sessionId/元/：ID/屬性/：名稱 獲取元素屬性的值。得到 /會話/：的sessionId/元/：ID/等于/：其它 測試兩個元素ID是否引用相同的DOM元素。得到 /會話/：的sessionId/元件/：ID/顯示 確定當前是否顯示元素。得到 /會話/：的sessionId/元/：ID/位置 確定元素在頁面上的位置。得到 /會話/：的sessionId/元/：ID/location_in_view 一旦滾動到視圖中，確定元素在屏幕上的位置。得到 /會話/：的sessionId/元/：ID/尺寸 確定元素的大小（以像素為單位）。得到 /會話/：的sessionId/元/：ID/CSS/：propertyName的 查詢元素的計算CSS屬性的值。得到 /會話/：的sessionId/方向 獲取當前的瀏覽器方向。POST /會話/：的sessionId/方向 設置瀏覽器方向。得到 /會話/：的sessionId/alert_text 獲取當前顯示的JavaScript的文本alert()，confirm()或prompt()對話框。POST /會話/：的sessionId/alert_text 將鍵擊發送到JavaScriptprompt()對話框。POST /會話/：的sessionId/accept_alert 接受當前顯示的警報對話框。POST /會話/：的sessionId/dismiss_alert 取消當前顯示的警報對話框。POST /會話/：的sessionId/通過MoveTo 將鼠標移動到特定元素的偏移量。POST /會話/：的sessionId/點擊 單擊任意鼠標按鈕（在最后一個moveto命令設置的坐標處）。POST /會話/：的sessionId/個buttonDown 單擊并按住鼠標左鍵（在最后一個moveto命令設置的坐標處）。POST /會話/：的sessionId/buttonup 釋放先前保持的鼠標按鈕（鼠標當前所在的位置）。POST /會話/：的sessionId/雙擊 雙擊當前鼠標坐標（由moveto設置）。POST /會話/：的sessionId/觸摸/點擊 單擊啟用觸摸的設備。POST /會話/：的sessionId/觸摸/向下 手指放在屏幕上。POST /會話/：的sessionId/觸摸/向上 手指在屏幕上。POST 會議/：的sessionId/觸摸/移動 手指在屏幕上移動。POST 會議/：的sessionId/觸摸/滾動 使用基于手指的動作事件在觸摸屏上滾動。POST 會議/：的sessionId/觸摸/滾動 使用基于手指的動作事件在觸摸屏上滾動。POST 會議/：的sessionId/觸摸/雙擊 使用手指運動事件雙擊觸摸屏。POST 會議/：的sessionId/觸摸/longclick 使用手指運動事件長按觸摸屏。POST 會議/：的sessionId/觸摸/輕彈 使用手指運動事件輕觸觸摸屏。POST 會議/：的sessionId/觸摸/輕彈 使用手指運動事件輕觸觸摸屏。得到 /會話/：的sessionId/位置 獲取當前的地理位置。POST /會話/：的sessionId/位置 設置當前的地理位置。得到 /會話/：的sessionId/LOCAL_STORAGE 獲取存儲的所有密鑰。POST /會話/：的sessionId/LOCAL_STORAGE 設置給定鍵的存儲項。刪除 /會話/：的sessionId/LOCAL_STORAGE 清除存儲空間。得到 /會話/：的sessionId/LOCAL_STORAGE/按鍵/：關鍵 獲取給定密鑰的存儲項。刪除 /會話/：的sessionId/LOCAL_STORAGE/按鍵/：關鍵 刪除給定密鑰的存儲項。得到 /會話/：的sessionId/LOCAL_STORAGE/尺寸 獲取存儲中的項目數。得到 /會話/：的sessionId/SESSION_STORAGE 獲取存儲的所有密鑰。POST /會話/：的sessionId/SESSION_STORAGE 設置給定鍵的存儲項。刪除 /會話/：的sessionId/SESSION_STORAGE 清除存儲空間。得到 /會話/：的sessionId/SESSION_STORAGE/按鍵/：關鍵 獲取給定密鑰的存儲項。刪除 /會話/：的sessionId/SESSION_STORAGE/按鍵/：關鍵 刪除給定密鑰的存儲項。得到 /會話/：的sessionId/SESSION_STORAGE/尺寸 獲取存儲中的項目數。POST /會話/：的sessionId/日志 獲取給定日志類型的日志。得到 /會話/：的sessionId/日志/類型 獲取可用的日志類型。得到 /會話/：的sessionId/application_cache/狀態 獲取html5應用程序緩存的狀態。命令細節/狀態GET/狀態查詢服務器的當前狀態。如果服務器處于活動狀態并接受命令，則應響應一般的“HTTP200OK”響應。響應主體應該是描述服務器狀態的JSON對象。所有服務器實現都應返回兩個描述服務器當前平臺的基本對象以及服務器何時構建。所有字段都是可選的;如果省略，客戶端應該假設值為uknown。此外，服務器實現可能包括此處未列出的其他字段。鍵 類型 描述建立 賓語 build.version 串 通用發行標簽（即“2.0rc3”）build.revision 串 從中構建服務器的本地源控制客戶端的修訂版build.time 串 構建服務器時的時間戳。口 賓語 os.arch 串 當前的系統架構。 串 服務器當前運行的操作系統的名稱：“windows”，“linux”等。os.version 串 操作系統版本。返回：{object}描述服務器一般狀態的對象。/會話POST/session創建一個新會話。服務器應嘗試創建與所需和所需功能最匹配的會話。所需功能的優先級高于所需功能，必須為要創建的會話設置。JSON參數：desiredCapabilities-{object}描述會話所需功能的對象。requiredCapabilities-{object}描述會話所需功能的對象（可選）。返回：{object}描述會話功能的對象。潛在錯誤：SessionNotCreatedException-如果無法設置所需的功能。/會話GET/會話返回當前活動會話的列表。每個會話將作為JSON對象列表返回，并帶有以下鍵：鍵 類型 描述ID 串 會話ID。功能 賓語 描述會話功能的對象。返回：{Array.<Object>}當前活動會話的列表。/會話/：的sessionIdGET/session/：sessionId檢索指定會話的功能。網址參數：:sessionId-將命令路由到的會話的ID。返回：{object}描述會話功能的對象。DELETE/session/：sessionId刪除會話。網址參數：:sessionId-將命令路由到的會話的ID。/會話/：的sessionId/超時POST/session/：sessionId/timeouts配置特定類型的操作在中止之前可以執行的時間量和|Timeout|錯誤返回給客戶端。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：type-{string}設置超時的操作類型。有效值包括：腳本超時的“腳本”，修改隱式等待超時的“隱式”和設置頁面加載超時的“頁面加載”。ms-{number}允許運行限時命令的時間量（以毫秒為單位）。/會話/：的sessionId/超時/async_scriptPOST/session/：sessionId/timeouts/async_script設置執行的異步腳本/session/:sessionId/execute_async在中止之前允許運行的時間（以毫秒為單位）和|Timeout|錯誤返回給客戶端。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：ms-{number}允許運行限時命令的時間量（以毫秒為單位）。/會話/：的sessionId/超時/implicit_waitPOST/session/：sessionId/timeouts/implicit_wait設置驅動程序在搜索元素時應等待的時間。當單個元素搜索，直到找到一個元素或駕駛員應查詢頁面的超時，以先到為準。搜索多個元素時，驅動程序應輪詢頁面，直到找到至少一個元素或超時到期，此時它應返回一個空列表。如果從未發送此命令，則驅動程序應默認為0ms的隱式等待。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：ms-{number}等待的時間量，以毫秒為單位。該值的下限為0。/會話/：的sessionId/WINDOW_HANDLEGET/session/：sessionId/window_handle檢索當前窗口句柄。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}當前窗口句柄。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/window_handlesGET/session/：sessionId/window_handles檢索會話可用的所有窗口句柄的列表。網址參數：:sessionId-將命令路由到的會話的ID。返回：{Array.<string>}窗口句柄列表。/會話/：的sessionId/URLGET/session/：sessionId/url檢索當前頁面的URL。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}當前的URL。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。POST/session/：sessionId/url導航到新網址。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：url-{string}要導航到的URL。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/前進POST/session/：sessionId/forward如果可能，在瀏覽器歷史記錄中向前導航。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/回POST/session/：sessionId/back如果可能，在瀏覽器歷史記錄中向后導航。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/刷新POST/session/：sessionId/refresh刷新當前頁面。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/執行POST/session/：sessionId/execute將一段JavaScript注入頁面，以便在當前所選幀的上下文中執行。假定執行的腳本是同步的，并且評估腳本的結果將返回給客戶端。該script參數定義了以函數體的形式執行的腳本。該函數返回的值將返回給客戶端。將使用提供的args數組調用該函數，并且可以arguments按指定的順序通過對象訪問這些值。參數可以是任何JSON基元，數組或JSON對象。定義WebElement引用的JSON對象將轉換為相應的DOM元素。同樣，腳本結果中的任何WebElements都將返回給客戶端WebElementJSON對象。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：script-{string}要執行的腳本。args-{Array.<*>}腳本參數。返回：{*}腳本結果。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果其中一個腳本參數是未附加到頁面DOM的WebElement。JavaScriptError-如果腳本拋出錯誤。/會話/：的sessionId/execute_asyncPOST/session/：sessionId/execute_async將一段JavaScript注入頁面，以便在當前所選幀的上下文中執行。假定執行的腳本是異步的，并且必須通過調用提供的回調來發出信號，該回調始終作為函數的最終參數提供。此回調的值將返回給客戶端。異步腳本命令可能不會跨頁面加載。如果unload在等待腳本結果時觸發事件，則應將錯誤返回給客戶端。該script參數定義了以函數體的形式執行的腳本。將使用提供的args數組調用該函數，并且可以通過以下方式訪問這些值arguments對象按指定的順序排列。最后一個參數將始終是一個回調函數，必須調用該函數來表示腳本已完成。參數可以是任何JSON基元，數組或JSON對象。定義WebElement引用的JSON對象將轉換為相應的DOM元素。同樣，腳本結果中的任何WebElements都將作為WebElementJSON對象返回給客戶端。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：script-{string}要執行的腳本。args-{Array.<*>}腳本參數。返回：{*}腳本結果。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果其中一個腳本參數是未附加到頁面DOM的WebElement。Timeout-如果在timout到期之前未調用腳本回調。超時由/session/:sessionId/timeout/async_script命令控制。JavaScriptError-如果腳本拋出錯誤或unload在等待腳本完成時觸發事件。/會話/：的sessionId/截圖GET/session/：sessionId/screenshot截取當前頁面的屏幕截圖。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}截圖為base64編碼的PNG。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/IME/available_enginesGET/session/：sessionId/ime/available_engines列出機器上所有可用的引擎。要使用引擎，它必須出現在此列表中。網址參數：:sessionId-將命令路由到的會話的ID。返回：{Array.<string>}可用引擎列表潛在錯誤：ImeNotAvailableException-如果主機不支持IME/會話/：的sessionId/IME/active_engineGET/session/：sessionId/ime/active_engine獲取活動IME引擎的名稱。名稱字符串是特定于平臺的。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}活動IME引擎的名稱。潛在錯誤：ImeNotAvailableException-如果主機不支持IME/會話/：的sessionId/IME/激活GET/session/：sessionId/ime/activated指示此時IME輸入是否處于活動狀態（而不是它是否可用）。網址參數：:sessionId-將命令路由到的會話的ID。返回：{boolean}如果IME輸入可用且當前處于活動狀態，則為true，否則為false潛在錯誤：ImeNotAvailableException-如果主機不支持IME/會話/：的sessionId/IME/停用POST/session/：sessionId/ime/deactivate取消激活當前活動的IME引擎。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：ImeNotAvailableException-如果主機不支持IME/會話/：的sessionId/IME/激活POST/session/：sessionId/ime/activate使可用的引擎（在getAvailableEngines返回的列表中顯示）處于活動狀態。在此調用之后，引擎將被添加到IME守護程序中加載的引擎列表中，并且使用sendKeys發送的輸入將由活動引擎轉換。請注意，這是一種獨立于平臺的激活IME的方法（特定于平臺的方式是使用鍵盤快捷鍵）網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：engine-{string}要激活的引擎的名稱。潛在錯誤：ImeActivationFailedException-如果引擎不可用或由于其他原因激活失敗。ImeNotAvailableException-如果主機不支持IME/會話/：的sessionId/幀POST/session/：sessionId/frame將焦點更改為頁面上的另一個幀。如果框架id是null，服務器應該切換到頁面的默認內容。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：id-{string|number|null|WebElementJSONObject}將焦點更改為的幀的標識符。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。NoSuchFrame-如果id找不到指定的幀。/會話/：的sessionId/幀/親POST/session/：sessionId/frame/parent將焦點更改為父上下文。如果當前上下文是頂級瀏覽上下文，則上下文保持不變。網址參數：:sessionId-將命令路由到的會話的ID。/會話/：的sessionId/窗口POST/session/：sessionId/window將焦點更改為另一個窗口。將焦點更改為的窗口可以由其服務器指定的窗口句柄指定，也可以由其name屬性的值指定。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：name-{string}將焦點更改為的窗口。潛在錯誤：NoSuchWindow-如果name找不到指定的窗口。DELETE/session/：sessionId/window關閉當前窗口。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉/會話/：的sessionId/窗/：windowHandle/尺寸POST/session/：sessionId/window/：windowHandle/size更改指定窗口的大小。如果：windowHandleURL參數為“current”，則將調整當前活動窗口的大小。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：width-{number}新窗口寬度。height-{number}新窗口高度。GET/session/：sessionId/window/：windowHandle/size獲取指定窗口的大小。如果：windowHandleURL參數為“current”，則返回當前活動窗口的大小。網址參數：:sessionId-將命令路由到的會話的ID。返回：{width:number,height:number}窗口的大小。潛在錯誤：NoSuchWindow-如果找不到指定的窗口。/會話/：的sessionId/窗/：windowHandle/位置POST/session/：sessionId/window/：windowHandle/position更改指定窗口的位置。如果：windowHandleURL參數為“current”，則將移動當前活動的窗口。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：x-{number}用于將窗口定位在相對于屏幕左上角的X坐標。y-{number}用于將窗口定位在相對于屏幕左上角的Y坐標。潛在錯誤：NoSuchWindow-如果找不到指定的窗口。GET/session/：sessionId/window/：windowHandle/position獲取指定窗口的位置。如果：windowHandleURL參數為“current”，則返回當前活動窗口的位置。網址參數：:sessionId-將命令路由到的會話的ID。返回：{x:number,y:number}窗口的X和Y坐標，相對于屏幕的左上角。潛在錯誤：NoSuchWindow-如果找不到指定的窗口。/會話/：的sessionId/窗/：windowHandle/最大化POST/session/：sessionId/window/：windowHandle/maximize如果尚未最大化，則最大化指定的窗口。如果：windowHandleURL參數為“current”，則當前活動窗口將最大化。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：NoSuchWindow-如果找不到指定的窗口。/會話/：的sessionId/餅干GET/session/：sessionId/cookie檢索當前頁面可見的所有Cookie。網址參數：:sessionId-將命令路由到的會話的ID。返回：{Array.<object>}Cookie列表。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。POST/session/：sessionId/cookie設置一個cookie。如果未指定cookie路徑，則應將其設置為"/"。同樣，如果省略域，則應默認為當前頁面的域。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：cookie-{object}一個JSON對象定義cookie來補充。DELETE/session/：sessionId/cookie刪除當前頁面可見的所有Cookie。網址參數：:sessionId-將命令路由到的會話的ID。潛在錯誤：InvalidCookieDomain-如果domain從當前頁面看不到cookie。NoSuchWindow-如果當前選定的窗口已關閉。UnableToSetCookie-如果嘗試在不支持cookie的頁面上設置cookie（例如，具有mime類型的頁面text/plain）。/會話/：的sessionId/餅干/：名稱DELETE/session/：sessionId/cookie/：name刪除具有給定名稱的cookie。如果當前頁面沒有可見的cookie，則此命令應為no-op。網址參數：:sessionId-將命令路由到的會話的ID。:name-要刪除的cookie的名稱。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/源GET/session/：sessionId/source獲取當前頁面源。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}當前頁面源。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/標題GET/session/：sessionId/title獲取當前頁面標題。網址參數：:sessionId-將命令路由到的會話的ID。返回：{string}當前頁面標題。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/元件POST/session/：sessionId/element從文檔根目錄開始在頁面上搜索元素。找到的元素將作為WebElementJSON對象返回。下表列出了每個服務器應支持的定位器策略。每個定位器必須返回位于DOM中的第一個匹配元素。戰略 描述班級名稱 返回其類名包含搜索值的元素;不允許使用復合類名。css選擇器 返回與CSS選擇器匹配的元素。ID 返回ID屬性與搜索值匹配的元素。名稱 返回其NAME屬性與搜索值匹配的元素。鏈接文字 返回其可見文本與搜索值匹配的錨元素。部分鏈接文本 返回一個錨元素，其可見文本與搜索值部分匹配。標簽名稱 返回標記名稱與搜索值匹配的元素。XPath的 返回與XPath表達式匹配的元素。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：using-{string}要使用的定位策略。value-{string}搜索目標。返回：{ELEMENT:string}找到的元素的WebElementJSON對象。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。NoSuchElement-如果找不到元素。XPathLookupError-如果使用XPath并且輸入表達式無效。/會話/：的sessionId/元件POST/session/：sessionId/elements從文檔根目錄開始在頁面上搜索多個元素。找到的元素將作為WebElementJSON對象返回。下表列出了每個服務器應支持的定位器策略。元素應按DOM中的順序返回。戰略 描述班級名稱 返回其類名包含搜索值的所有元素;不允許使用復合類名。css選擇器 返回與CSS選擇器匹配的所有元素。ID 返回ID屬性與搜索值匹配的所有元素。名稱 返回NAME屬性與搜索值匹配的所有元素。鏈接文字 返回其可見文本與搜索值匹配的所有錨元素。部分鏈接文本 返回其可見文本與搜索值部分匹配的所有錨元素。標簽名稱 返回標記名稱與搜索值匹配的所有元素。XPath的 返回與XPath表達式匹配的所有元素。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：using-{string}要使用的定位策略。value-{string}搜索目標。返回：{Array.<{ELEMENT:string}>}已定位元素的WebElementJSON對象列表。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。XPathLookupError-如果使用XPath并且輸入表達式無效。/會話/：的sessionId/元件/活性POST/session/：sessionId/element/active獲取當前具有焦點的頁面上的元素。該元素將作為WebElementJSON對象返回。網址參數：:sessionId-將命令路由到的會話的ID。返回：{ELEMENT:string}活動元素的WebElementJSON對象。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/元/：IDGET/session/：sessionId/element/：id描述已識別的元素。注意：此命令保留供將來使用;它的返回類型目前尚未定義。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/元素POST/session/：sessionId/element/：id/element從標識的元素開始，在頁面上搜索元素。找到的元素將作為WebElementJSON對象返回。下表列出了每個服務器應支持的定位器策略。每個定位器必須返回位于DOM中的第一個匹配元素。戰略 描述班級名稱 返回其類名包含搜索值的元素;不允許使用復合類名。css選擇器 返回與CSS選擇器匹配的元素。ID 返回ID屬性與搜索值匹配的元素。名稱 返回其NAME屬性與搜索值匹配的元素。鏈接文字 返回其可見文本與搜索值匹配的錨元素。部分鏈接文本 返回一個錨元素，其可見文本與搜索值部分匹配。標簽名稱 返回標記名稱與搜索值匹配的元素。XPath的 返回與XPath表達式匹配的元素。提供的XPath表達式必須“按原樣”應用于服務器;如果表達式不是相對于元素根，則服務器不應修改它。因此，XPath查詢可能會返回未包含在根元素的子樹中的元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。JSON參數：using-{string}要使用的定位策略。value-{string}搜索目標。返回：{ELEMENT:string}找到的元素的WebElementJSON對象。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。NoSuchElement-如果找不到元素。XPathLookupError-如果使用XPath并且輸入表達式無效。/會話/：的sessionId/元件/：ID/元素POST/session/：sessionId/element/：id/elements從標識的元素開始，在頁面上搜索多個元素。找到的元素將作為WebElementJSON對象返回。下表列出了每個服務器應支持的定位器策略。元素應按DOM中的順序返回。戰略 描述班級名稱 返回其類名包含搜索值的所有元素;不允許使用復合類名。css選擇器 返回與CSS選擇器匹配的所有元素。ID 返回ID屬性與搜索值匹配的所有元素。名稱 返回NAME屬性與搜索值匹配的所有元素。鏈接文字 返回其可見文本與搜索值匹配的所有錨元素。部分鏈接文本 返回其可見文本與搜索值部分匹配的所有錨元素。標簽名稱 返回標記名稱與搜索值匹配的所有元素。XPath的 返回與XPath表達式匹配的所有元素。提供的XPath表達式必須“按原樣”應用于服務器;如果表達式不是相對于元素根，則服務器不應修改它。因此，XPath查詢可能會返回未包含在根元素的子樹中的元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。JSON參數：using-{string}要使用的定位策略。value-{string}搜索目標。返回：{Array.<{ELEMENT:string}>}已定位元素的WebElementJSON對象列表。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。XPathLookupError-如果使用XPath并且輸入表達式無效。/會話/：的sessionId/元/：ID/點擊POST/session/：sessionId/element/：id/click單擊元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。ElementNotVisible-如果引用的元素在頁面上不可見（由CSS隱藏，具有0寬度或具有0高度）/會話/：的sessionId/元/：ID/提交POST/session/：sessionId/element/：id/submit提交一個FORM元素。submit命令也可以應用于作為元素后代的任何FORM元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/文GET/session/：sessionId/element/：id/text返回元素的可見文本。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元件/：ID/值POST/session/：sessionId/element/：id/value將一系列擊鍵發送到元素。可以指定任何UTF-8字符，但是，如果服務器不支持本機鍵事件，則應模擬標準美國鍵盤布局的鍵擊。Unicode專用區代碼點0xE000-0xF8FF用于表示可按下的非文本鍵（參見下表）。鍵 碼空值 U+E000取消 U+E001救命 U+E002后空間 U+E003標簽 U+E004明確 U+E005返回1 U+E006輸入1 U+E007轉移 U+E008控制 U+E009Alt鍵 U+E00A暫停 U+E00B逃逸 U+E00C 鍵 碼空間 U+E00D上一頁 U+E00E向下翻頁 U+E00F結束 U+E010家 U+E011左箭頭 U+E012向上箭頭 U+E013右箭頭 U+E014向下箭頭 U+E015插入 U+E016刪除 U+E017分號 U+E018等于 U+E019 鍵 碼Numpad0 U+E01ANumpad1 U+E01BNumpad2 U+E01CNumpad3 U+E01DNumpad4 U+E01ENumpad5 U+E01FNumpad6 U+E020Numpad7 U+E021Numpad8 U+E022Numpad9 U+E023 鍵 碼乘 U+E024加 U+E025分隔器 U+E026減去 U+E027十進制 U+E028劃分 U+E029 鍵 碼F1 U+E031F2 U+E032F3 U+E033F4 U+E034F5 U+E035F6 U+E036F7 U+E037F8 U+E038F9 U+E039F10 U+E03AF11 U+E03BF12 U+E03C命令/元 U+E03D1返回鍵是不一樣的回車鍵。服務器必須按如下方式處理密鑰序列：鍵盤上顯示的每個鍵不需要修飾符，將作為鍵盤發送，然后鍵入。如果服務器不支持本機事件并且必須使用JavaScript模擬鍵擊，則必須按順序生成keydown，keypress和keyup事件。只有當相應的鍵用于可打印字符時才應觸發按鍵事件。如果一個關鍵要求（“！”美國標準鍵盤上的EG）修改鍵，順序是：修改了，關鍵了，關鍵了，修改起來，其中的關鍵是理想的未經修改的鍵值（使用前面的例子，一個“1”）。修改鍵（Ctrl，Shift，Alt和Command/Meta）被假定為“粘性”;應該按住每個修飾符（例如，只有一個keydown事件），直到在序列中再次遇到修飾符，或遇到NULL（U+E000）鍵。每個密鑰序列都以隱式NULL密鑰終止。隨后，必須在序列結束時釋放所有按下的修改鍵（具有相應的鍵控事件）。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。JSON參數：value-{Array.<string>}要鍵入的鍵序列。必須提供一個數組。服務器應將數組項展平為要鍵入的單個字符串。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。ElementNotVisible-如果引用的元素在頁面上不可見（由CSS隱藏，具有0寬度或具有0高度）/會話/：的sessionId/鍵POST/session/：sessionId/keys將一系列擊鍵發送到活動元素。除了隱式終止之外，此命令類似于每個方面中的sendkeys命令：修改符不會在調用結束時釋放。相反，修改鍵的狀態保持在調用之間，因此可以在按下修改鍵的同時執行鼠標交互。網址參數：:sessionId-將命令路由到的會話的ID。JSON參數：value-{Array.<string>}要發送的密鑰序列。序列在sendkeys命令中定義。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。/會話/：的sessionId/元/：ID/名稱GET/session/：sessionId/element/：id/name查詢元素的標記名稱。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{string}元素的標記名稱，作為小寫字符串。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/清除POST/session/：sessionId/element/：id/clear清除aTEXTAREA或textINPUT元素的值。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。ElementNotVisible-如果引用的元素在頁面上不可見（由CSS隱藏，具有0寬度或具有0高度）InvalidElementState-如果引用的元素被禁用。/會話/：的sessionId/元件/：ID/選擇GET/session/：sessionId/element/：id/selected確定當前是否選擇了OPTION元素或INPUT類型checkbox或元素radiobutton。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{boolean}是否選擇了元素。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/啟用GET/session/：sessionId/element/：id/enabled確定當前是否啟用了元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{boolean}元素是否已啟用。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/屬性/：名稱GET/session/：sessionId/element/：id/attribute/：name獲取元素屬性的值。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{string|null}屬性的值，如果未在元素上設置，則為null。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/等于/：其它GET/session/：sessionId/element/：id/equals/：other測試兩個元素ID是否引用相同的DOM元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。:other-要比較的元素的ID。返回：{boolean}兩個ID是否引用相同的元素。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果元素引用:id或:other不再附加到頁面的DOM。/會話/：的sessionId/元件/：ID/顯示GET/session/：sessionId/element/：id/顯示確定當前是否顯示元素。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{boolean}是否顯示元素。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/位置GET/session/：sessionId/element/：id/location確定元素在頁面上的位置。該點(0,0)指的是頁面的左上角。元素的坐標作為帶有x和y屬性的JSON對象返回。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{x:number,y:number}頁面上元素的X和Y坐標。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/location_in_viewGET/session/：sessionId/element/：id/location_in_view一旦滾動到視圖中，確定元素在屏幕上的位置。注意：這被視為內部命令，僅應用于確定元素正確生成本機事件的位置。網址參數：:sessionId-將命令路由到的會話的ID。:id-將命令路由到的元素的ID。返回：{x:number,y:number}元素的X和Y坐標。潛在錯誤：NoSuchWindow-如果當前選定的窗口已關閉。StaleElementReference-如果引用的元素:id不再附加到頁面的DOM。/會話/：的sessionId/元/：ID/尺寸GET/session/：sessionId/element/：id/size確定元素的大小（以像素為單位）。該大小將作為帶有width和height屬性的JSON對象返回。網址參數：:sessionId-將命令路由到的會話的ID。:id-將