python switch to frame_Switch to Frame

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

# 切换Frame

将焦点更改为页面上的另一个frame (仅是 Web context)

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

## 用法示例

```java

// Java

driver.switchTo().frame(3);

```

```python

# Python

self.driver.switch_to.frame(3)

```

```javascript

// Javascript

// webdriver.io example

driver.switchToFrame(3);

// wd example

await driver.frame(3);

```

```ruby

# Ruby

# ruby_lib example

switch_to.frame(3)

# ruby_lib_core example

@driver.switch_to.frame(3)

```

```php

# PHP

// TODO PHP sample

```

```csharp

// C#

driver.SwitchTo().Frame(3);

```

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

## 描述

如果frame的id为null， 服务器应切换到页面的默认内容。

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

## 支持

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### Appium Server

|平台|Driver|平台版本|Appium版本|Driver版本|

|--------|----------------|------|--------------|--------------|

| iOS | [XCUITest](../../drivers/ios-xcuitest.md) | None | None | None |

| | [UIAutomation](../../drivers/ios-uiautomation.md) | None | None | None |

| Android | [UiAutomator2](../../drivers/android-uiautomator2.md) | None | None | None |

| | [Espresso](../../drivers/android-espresso.md) | None | None | None |

| | [UiAutomator](../../drivers/android-uiautomator.md) | None | None | None |

| Mac | [Mac](../../drivers/mac.md) | None | None | None |

| Windows | [Windows](../../drivers/windows.md) | None | None | None |

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### Appium Clients

|语言|支持版本|文档|

|--------|-------|-------------|

|[Java](https://github.com/appium/java-client/releases/latest)| All | [seleniumhq.github.io](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/WebDriver.TargetLocator.html#frame-int-) |

|[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.switch_to_frame) |

|[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#L332) |

|[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.rubydoc.info](https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Remote/W3C/Bridge:switch_to_frame) |

|[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/Remote/RemoteTargetLocator.cs) |

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

## HTTP API 规范

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### 路径

`POST /session/:session_id/frame`

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### URL 参数

|名称|描述|

|----|-----------|

|session_id|将指令发往的会话(session)的ID|

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### JSON 参数

|名称|类型|描述|

|----|----|-----------|

| id | `string|数字|null|WebElement JSON Object` | Identifier for the frame to change focus to. |

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

### 响应

null

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/frame/switch.yml)

## 参考

* [W3C Specification](https://www.w3.org/TR/webdriver/#dfn-switch-to-frame)

* [JSONWP Specification](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidurl)