Vega WebView Cookieマネージャー

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

WebView Cookieマネージャーは次の場合に役立ちます。

URLに対するシリアル化されたCookieをCookieストアに追加する。これは、発信リクエストのCookieリクエストヘッダーに関連付けられます。
CookieストアからすべてのCookieを消去する。

Cookieオブジェクトには次のフィールドがあります。

フィールド	型	必須／任意（○/×）	説明
`name`	string	○	`name`は、ペアの名前を表します。
`value`	string	○	valueは、ペアの値を表します。値が空のCookieは拒否され、何も実行されません。ほかの値が存在する場合、valueフィールドは空の値として維持されます。
`path`	string	×	path属性の値は、このCookieのオリジンサーバー上のURLのサブセットを表します。pathの指定がない場合、このCookieを設定したUniform Resource Identifier（URI）を指定したものと見なされます。
`domain`	string	×	domain属性の値は、Cookieが有効なドメインを表します。domainの指定がない場合、ドメインにそのサブドメインからアクセスすることはできなくなります。
`version`	string	×	Cookieの状態管理仕様のバージョンを識別します。デフォルト値は空の文字列です。
`expires`	string	×	Cookieの最大有効期間をHTTP日付タイムスタンプとして指定します。ISO8601形式の文字列で指定する必要があります。有効期限文字列が指定されていない場合、CookieはセッションCookieとして扱われ、ユーザーがWebViewセッションを閉じるまで保持されます。
`secure`	boolean	×	JavaScriptがCookieにアクセスできないようにします。このフィールドを設定しない場合、デフォルトで`false`が適用されます。
`httpOnly`	boolean	×	リクエストが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://ここにURLを入力.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を1つだけ設定します。
同じ名前のCookieが既にある場合、そのホストとパスが置き換えられます。このSet-Cookieドキュメントで説明されているように、domain値はCookieのホストを設定します。
期限切れのCookieの設定は無視されます。
CookieストアはWebViewインスタンス間で共有されます。異なるアプリ間で共有されることはありません。同じアプリ内の複数のWebViewインスタンスでは、Cookieストアを含む共通のエンジンが共有されます。
現在のところ、アプリのReact NativeレイヤーでCookieストアを読み取ることはできません。

Last updated: 2025年9月30日

Vega WebView Cookieマネージャー

WebView Cookieマネージャーの詳細

CookieストアにURL Cookieを追加

CookieストアのすべてのCookieを消去

関連トピック