跳转到内容
WebView AllWebView All
这是 1.2.x 版本的文档,最新接口请切换至 latest。

Cookies

WebViewCookieManager 管理底层 WebView 引擎的 cookie。

final cookies = WebViewCookieManager();
await cookies.setCookie(
const WebViewCookie(
name: 'session',
value: 'abc',
domain: 'example.com',
path: '/',
),
);
final list = await cookies.getCookies(
domain: Uri.parse('https://example.com'),
);
final hadCookies = await cookies.clearCookies();
方法作用
setCookie设置 name/value/domain/path。
getCookies返回指定域名可见的 cookie。
clearCookies清空 cookie,并在平台可报告时返回清空前是否存在 cookie。

cookie 名称、domain 和 path 会做基本校验。非空 path 必须以 / 开头。

平台存储说明
AndroidAndroid WebView CookieManager支持第三方 cookie 策略。
iOS/macOSWKWebsiteDataStore.defaultDataStore按 domain matching 过滤。
WindowsWebView2 cookie manager提供扩展元数据。
LinuxWebKitGTK cookie bridge支持通用字段。
OHOSArkWeb CookieManager支持第三方 cookie 策略。
Webdocument.cookie只能访问宿主页可见 cookie。
final manager = WebViewCookieManager().platform
as WindowsWebViewCookieManager;
await manager.setWindowsCookie(
WindowsWebViewCookie(
name: 'session',
value: 'abc',
domain: 'example.com',
path: '/',
isHttpOnly: true,
isSecure: true,
sameSite: WindowsWebViewCookieSameSite.lax,
),
);

Windows 还支持按完整 cookie、name+url、name+domain+path 删除。

Android:

await (WebViewCookieManager().platform as AndroidWebViewCookieManager)
.setAcceptThirdPartyCookies(
controller.platform as AndroidWebViewController,
true,
);

OHOS:

await (WebViewCookieManager().platform as OhosWebViewCookieManager)
.setAcceptThirdPartyCookies(
controller.platform as OhosWebViewController,
true,
);

Web 实现使用 document.cookie:

  • 不能读取 HttpOnly cookie。
  • 不能管理无关域名 cookie。
  • 不能绕过 SameSite、Secure、分区和浏览器隐私策略。