# 设置隐式等待超时时间 设置在查找元素时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