进程:
通过Session
的cookies
属性来访问Cookies
的实例
例如:
以下事件会在Cookies
实例触发。
Event: ‘changed’
event
Eventcookie
- 变更后的 cookie 值。cause
String - The cause of the change with one of the following values:explicit
- cookie 是由消费者的操作直接更改的。expired
- cookie 在过期时自动删除。evicted
- 在GC(垃圾回收机制)过程中被回收。expired-overwrite
- 一个已过期的时间覆写了原cookie 的过期时间。
removed
Boolean -true
表示cookie 已被删掉, 否则为false
.
实例方法
以下方法可以在实例调用。
cookies.get(filter)
filter
Objecturl
String (optional) - Retrieves cookies which are associated withurl
. Empty implies retrieving cookies of all URLs.name
String (可选) - 按名称筛选 cookie。domain
String (optional) - 检索与域名或者domain
子域名匹配的cookie。path
String (可选) - 检索路径与path
匹配的 cookie。secure
Boolean (可选) - 通过其Secure 属性筛选 cookie。session
Boolean (可选) - 筛选出session 内可用或持久性 cookie。
返回 Promise<Cookie[]>
- 一个会解析成数组或者 cookie 对象的 promise。
发送请求以获取匹配 filter
的所有 cookie,并通过响应来解决承诺问题。
cookies.set(details)
返回 Promise<void>
- cookie 设置时解析的一个 promise。
cookies.remove(url, name)
url
String - 与 cookie 关联的 URL。name
String - cookie 名称。
返回 Promise<void>
- cookie 移除时解析的的一个 promise。
移除与url
和 name
匹配的 cookie。
返回 Promise<void>
- 一个在 cookie 写入时解析的 promise。
写入所有未写入磁盘的 cookie。