List icon 目录

从 7.17 到 7.18

Cookies

删除 Cookie

v7.17

当您删除一个 Cookie 时,CookieStore.delete(Cookie) 方法会返回一个 boolean 值,用于指示给定的 Cookie 是否已被成功删除。

Java
Kotlin
if (!cookieStore.delete(cookie)) {
    // 错误:cookie 未被删除。
}
if (!cookieStore.delete(cookie)) {
    // 错误:cookie 未被删除。
}

v7.18

在此版本中,我们简化了这一功能。现在,CookieStore.delete(Cookie) 方法返回 void。如果 Cookie 未被删除,因为它无效或不存在,该方法将不执行任何操作:

Java
Kotlin
cookieStore.delete(cookie);
cookieStore.delete(cookie)

设置 Cookie

v7.17

要设置一个 Cookie,您可以使用 CookieStore.put(String url, Cookie cookie) 方法。该方法需要两个参数:Cookie 和 URL。如果给定的 URL 和 Cookie 的域名不同,Cookie 将不会被设置,并且该方法会返回 false。因此,请确保给定的 URL 和 Cookie 的域名是相同的。

Java
Kotlin
Cookie cookie = Cookie.newBuilder()
        .name("cookieName")
        .value("cookieValue")
        .domain(".google.com")
        .secure(true)
        .path("/")
        .build();
if (!cookieStore.put("https://www.google.com", cookie)) {
    // 错误:cookie 未被设置。
}
Cookie cookie = Cookie.newBuilder()
        .name("cookieName")
        .value("cookieValue")
        .domain(".google.com")
        .secure(true)
        .path("/")
        .build()
if (!cookieStore.put("https://www.google.com", cookie)) {
    // 错误:cookie 未被设置。
}

v7.18

我们发现 Chromium 仅使用 URL 参数来验证给定的 Cookie 并检查其域名。我们决定简化这个 API。现在,您不需要传递 URL 参数,并确保 URL 和 Cookie 的域名相同。现在,您可以通过以下方式设置 Cookie:

Java
Kotlin
cookieStore.set(Cookie.newBuilder(".google.com")
        .name("cookieName")
        .value("cookieValue")
        .secure(true)
        .path("/")
        .build());
cookieStore.set(Cookie.newBuilder(".google.com")
        .name("cookieName")
        .value("cookieValue")
        .secure(true)
        .path("/")
        .build())

如果给定的 cookie 无效且无法设置,该方法将抛出 java.lang.IllegalArgumentException 异常。