Appium-Get All Contexts(获取所有上下文)

本是古典何须时尚 2022-11-19 04:20 208阅读 0赞

### Get All Contexts ###

*   *   *   *   *  Example Usage
                 *  Description
                 *  Support
                 *   *  Appium Server
                     *  Appium Clients
                 *  HTTP API Specifications
                 *   *  Endpoint
                     *  URL Parameters
                     *  JSON Parameters
                     *  Response

Get all the contexts available to automate //获取所有可用于自动化的上下文

##### Example Usage #####

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">Set contextNames = driver.getContextHandles();</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">contexts = driver.contexts</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>let contexts = driver.getContexts();<br><br>// wd example<br>let contexts = await driver.contexts();</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># ruby_lib example<br>context = available_contexts<br><br># ruby_lib_core example<br>context = @driver.available_contexts</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">List AllContexts = new List();<br> foreach (var context in (driver.Contexts))<br>{ <br>AllContexts.Add(context);<br>}</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left">$contexts = $driver-&gt;contexts();</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

Retrieve all the contexts available to be automated. This will include, at least, the native context. There can also be zero or more web view contexts. For information on the format of the context names, see the get context documentation. mobile command `mobile: getContexts` is available on iOS (XCUITest) and Android (UIAutomator2 and Espresso) to get more detailed contexts. For information on contexts, see Appium’s hybrid automation docs.

/\* 检索所有可用于自动化的上下文。这至少包括本机上下文。也可以有零个或多个web视图上下文。有关上下文名称格式的信息，请参阅get context文档。mobile command mobile:getContexts可以在iOS（xguitest）和Android（UIAutomator2和Espresso）上获得更详细的上下文。有关上下文的信息，请参阅Appium的混合自动化文档 \*/

##### Support #####

###### Appium Server ######

<table> 
 <thead> 
  <tr> 
   <th>Platform</th> 
   <th>Driver</th> 
   <th>Platform Versions</th> 
   <th>Appium Version</th> 
   <th>Driver Version</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>iOS</td> 
   <td>XCUITest</td> 
   <td>9.3+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UIAutomation</td> 
   <td>8.0 to 9.3</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Android</td> 
   <td>Espresso</td> 
   <td>?+</td> 
   <td>1.9.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator2</td> 
   <td>?+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator</td> 
   <td>4.3+</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Mac</td> 
   <td>Mac</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
  <tr> 
   <td>Windows</td> 
   <td>Windows</td> 
   <td>None</td> 
   <td>None</td> 
   <td>None</td> 
  </tr> 
 </tbody> 
</table>

###### Appium Clients ######

<table> 
 <thead> 
  <tr> 
   <th>Language</th> 
   <th>Support</th> 
   <th>Documentation</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td>All</td> 
   <td>seleniumhq.github.io</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td>All</td> 
   <td>selenium-python.readthedocs.io</td> 
  </tr> 
  <tr> 
   <td>Javascript (WebdriverIO)</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Javascript (WD)</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td>All</td> 
   <td>www.rubydoc.info</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
 </tbody> 
</table>

##### HTTP API Specifications #####

###### Endpoint ######

`GET /session/:session_id/contexts`

###### URL Parameters ######

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>session_id</td> 
   <td>ID of the session to route the command to</td> 
  </tr> 
 </tbody> 
</table>

###### JSON Parameters ######

None

###### Response ######

Array of the names of all available contexts (`Array<String>`) //所有可用上下文的名称数组（Array）