[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) # 设置 Cookie 添加 cookie (仅是 Web context) [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ## 用法示例 ```java // Java driver.manage().addCookie(new Cookie("foo", "bar")); ``` ```python # Python self.driver.add_cookie({name: 'foo', value: 'bar'}) ``` ```javascript // Javascript // webdriver.io example driver.setCookies([{ name: 'myCookie', value: 'some content' }]); // wd example let cookies = await driver.setCookie({name: 'foo', value: 'bar'}); ``` ```ruby # Ruby # ruby_lib example manage.add_cookie(:name => 'foo', :value => 'bar') # ruby_lib_core example @driver.manage.add_cookie(:name => 'foo', :value => 'bar') ``` ```php # PHP // TODO PHP sample ``` ```csharp // C# driver.Manage().Cookies.AddCookie(new Cookie("foo", "bar")); ``` [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ## 支持 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.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/storage/set-cookie.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/remote/RemoteWebDriver.RemoteWebDriverOptions.html#addCookie-org.openqa.selenium.Cookie-) | |[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.add_cookie) | |[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#L1971) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.selenium.dev](https://www.selenium.dev/documentation/en/support_packages/working_with_cookies/#add-cookie) | |[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/RemoteCookieJar.cs) | [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ## HTTP API 规范 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ### 路径 `POST /session/:sessionId/cookie` [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.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/storage/set-cookie.yml) ### JSON 参数 |名称|类型|描述| |----|----|-----------| | cookie | `object` | 将要添加的 cookie | [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ### 响应 null [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/web/storage/set-cookie.yml) ## 参考 * [W3C Specification](https://www.w3.org/TR/webdriver/#dfn-delete-cookie) * [JSONWP Specification](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidcookie)