Vega WebView Cookieマネージャー

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

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

Cookieの保存状態

WebViewによるCookieの管理では、一時的なセッションCookieはアクティブメモリに保持され、高速アクセスが可能になります。一方、永続的なCookieはアプリのプライベートストレージディレクトリに安全に保存されます。永続的なCookieとは、特定の有効期限のあるCookieです。開発者は、リモートデバッグを有効にし、接続されたデバイスでChrome DevToolsの [アプリケーション] パネルを使用することで、この保存状態を調べたり操作したりできます。このインターフェイスは、現在のオリジン（ページのスキーム、ドメイン、ポート）のアクティブなCookieをすべて表示する手段を提供します。ここでは、値を直接編集したり、データを手動で消去したり、HttpOnly、Secure、SameSiteなどの重要なセキュリティ属性が正しく適用されているかどうかを確認したりできます。 Cookieが期待どおりに動作しない原因についてトラブルシューティングを行うには、DevToolsの [ネットワーク] パネルに切り替えて、ネットワークリクエストで交換されるCookieヘッダーとSet-Cookieヘッダーをモニタリングします。これにより、拒否されたCookie、構文エラー、クロスサイトポリシー違反を特定できます。

WebView 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	×	CookieをHTTPS接続に制限して安全に保ちます。
`httpOnly`	boolean	×	JavaScriptが`document.cookie`を通じてCookieにアクセスすることを防ぎます。

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

CookieストアにURL Cookieを追加

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);
});

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

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を無視します。
CookieストアはWebViewインスタンス間で共有されます。異なるアプリ間でCookieストアが共有されることはありません。同じアプリ内の複数のWebViewインスタンスでは、Cookieストアを含む共通のエンジンが共有されます。
現時点では、アプリのReact NativeレイヤーでCookieストアを読み取ることはできません。

​Cookieの保存状態

​WebView Cookieマネージャーの詳細

​CookieストアにURL Cookieを追加

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

​関連トピック

Cookieの保存状態

WebView Cookieマネージャーの詳細

CookieストアにURL Cookieを追加

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

関連トピック