Vega WebView Cookie管理器

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

Cookie管理器可用于以下用途：

在Cookie存储区中为URL添加序列化Cookie，该序列化Cookie附加到传出请求的Cookie请求标头上。
清除Cookie存储区中的所有Cookie。

一个Cookie对象可以有以下字段：

字段	类型	是否必需？（是/否）	描述
`name`	字符串	是	`name`是指该对的名称。
`value`	字符串	是	“value”是指该对的Cookie值。如果Cookie的值为空，则会被拒绝。这会导致无效操作。如果存在任何其他值，则值字段将保留为空值。
`path`	字符串	否	path属性的值为此Cookie指定了源服务器上的URL子集。如果未给出指定路径，则假定路径是设置Cookie的统一资源标识符 (URI)。
`domain`	字符串	否	domain属性的值指定Cookie对哪个域有效。如果未提供指定域，则其子域将无法访问该域。
`version`	字符串	否	标识Cookie的状态管理规范的版本。默认值是一个空字符串。
`expires`	字符串	否	以HTTP日期时间戳的形式表示Cookie的最大生命周期。应为ISO8601字符串。如果未提供过期字符串，则该Cookie将被视为会话Cookie，会一直持续到用户关闭WebView会话。
`secure`	布尔值	否	禁止JavaScript访问Cookie。如果未设置，则默认值为`false`。
`httpOnly`	布尔值	否	表示当使用HTTP架构发出请求时，已将Cookie发送到服务器。如果未设置，则默认值为`false`。

已复制到剪贴板。

export interface Cookie {
  name: string;
  value: string;
  path?: string;
  domain?: string;
  version?: string;
  expires?: string;
  secure?: boolean;
  httpOnly?: boolean;
}

已复制到剪贴板。

CookieManager.set(url:string, Cookie:object)

示例如下：

已复制到剪贴板。

import { CookieManager } from "@amazon-devices/webview";

CookieManager.set('https://YOUR_URL_HERE.com', {
  name: 'Test-Cookie',
  value: 'Test-Cookie-Value',
  path: '/',
  version: '1',
  expires: '2024-01-01T12:30:00.00-05:00',
}).then((status) => {
  console.log('CookieManager.set =>', status);
});

已复制到剪贴板。

CookieManager.clearAll()

示例如下：

已复制到剪贴板。

import { CookieManager } from "@amazon-devices/webview";

CookieManager.clearAll().then((status) => {
    console.log('CookieManager.clearAll =>', status);
});

说明：

set() 方法为URL设置单个Cookie。
对于任何同名的现有Cookie，主机和路径将被替换。Domain值设置Cookie的主机，如此Set-Cookie文档中所述。
如果设置过期的Cookie，则会被忽略。
WebView实例共享Cookie存储区。它不能在不同的应用之间共享。同一个应用中的多个WebView实例共享一个通用引擎，其中包括Cookie存储区。
该应用的React Native层此时无法读取Cookie存储区。

Last updated: 2025年9月30日

Vega WebView Cookie管理器

Cookie管理器详细信息

在Cookie存储区中添加URL Cookie

清除Cookie存储区中的所有Cookie

相关主题