# 設置隱式等待超時時間 設置在查找元素時driver必須等待的時間量 ## 使用樣例 ```java // Java driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS); ``` ```python # Python self.driver.implicitly_wait(5) # waits 5 seconds ``` ```javascript // Javascript // webdriver.io example driver.setImplicitTimeout(5000) // wd example await driver.setImplicitWaitTimeout(5000); ``` ```ruby # Ruby # ruby_lib example manage.timeouts.implicit_wait = 5 # Ruby translates it to seconds # ruby_lib_core example @driver.manage.timeouts.implicit_wait = 5 # Ruby translates it to seconds ``` ```php # PHP // TODO PHP sample ``` ```csharp // C# driver.Manage().Timeouts().ImplicitWait = TimeSpan.FromSeconds(30); ``` ## 描述 當查找單個元素時，driver應該輪詢頁面，直到找到某個元素或超時為止，以先發生的為準。當查找多個元素時，driver應該輪詢頁面，直到至少找到一個元素或者超時過期，這時它應該返回一個空列表。 如果從未發送此命令，驅動程序應默認為隱式等待時間為0毫秒。 ## 支持 ### Appium Server | 平臺 | Driver | 平臺版本 | Appium版本 | Driver版本 | |--------|----------------|------|--------------|--------------| | iOS | [XCUITest](../../drivers/ios-xcuitest.md) | 9.3+ | 1.6.0+ | All | | | [UIAutomation](../../drivers/ios-uiautomation.md) | 8.0 to 9.3 | All | All | | Android | [Espresso](../../drivers/android-espresso.md) | ?+ | 1.9.0+ | All | | | [UiAutomator2](../../drivers/android-uiautomator2.md) | ?+ | 1.6.0+ | All | | | [UiAutomator](../../drivers/android-uiautomator.md) | 4.3+ | All | All | | Mac | [Mac](../../drivers/mac.md) | ?+ | 1.6.4+ | All | | Windows | [Windows](../../drivers/windows.md) | 10+ | 1.6.0+ | All | ### Appium 客戶端 | 語言 | 支持版本 | 文檔 | |--------|-------|-------------| |[Java](https://github.com/appium/java-client/releases/latest)| All | [seleniumhq.github.io](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/remote/RemoteWebDriver.RemoteWebDriverOptions.RemoteTimeouts.html#implicitlyWait-long-java.util.concurrent.TimeUnit-) | |[Python](https://github.com/appium/python-client/releases/latest)| All | [selenium-python.readthedocs.io](http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.implicitly_wait) | |[Javascript (WebdriverIO)](http://webdriver.io/index.html)| All | | |[Javascript (WD)](https://github.com/admc/wd/releases/latest)| All | [github.com](https://github.com/admc/wd/blob/master/lib/commands.js#L681) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.rubydoc.info](https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Timeouts:implicit_wait=) | |[PHP](https://github.com/appium/php-client/releases/latest)| All | [github.com](https://github.com/appium/php-client/) | |[C#](https://github.com/appium/appium-dotnet-driver/releases/latest)| All | [github.com](https://github.com/SeleniumHQ/selenium/blob/master/dotnet/src/webdriver/ITimeouts.cs) | ## HTTP API 規范 ### 終端 `POST /session/:session_id/timeouts/implicit_wait` ### URL 參數 | 名稱 | 描述 | |----|-----------| |session_id|將指令發往的會話（session）的ID| ### JSON 參數 | 名稱 | 類型 | 描述 | |----|----|-----------| | ms | `number` | 運行有時間限制的命令的時間量（毫秒） | ### 響應 null ## 參考 * [W3C Specification](https://www.w3.org/TR/webdriver/#dfn-get-timeouts) * [JSONWP Specification](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidtimeoutsimplicit_wait) 本文由 [KangarooChen](https://github.com/KangarooChen) 翻譯，Last english version: a11f693bbe2bcf2e47fa6a40872a7580ab45d6bb, 6 Jun 2020