getAll()
方法在
Cookie
API retrieves all cookies from a single cookie store that match the given information.
This is an asynchronous function that returns a
Promise
.
var getting = browser.cookies.getAll(
details
// object
)
details
An
对象
containing details that can be used to match cookies to be retrieved. Included properties are as follows (see
Cookie type
for more information on these):
domain
可选
A
string
representing a domain that cookies must be associated with (they can be associated either with this exact domain or one of its subdomains).
firstPartyDomain
可选
A
string
representing the first-party domain with which the cookie to retrieve is associated.
This property must be supplied if the browser has first-party isolation enabled. You can however pass
null
in this situation. If you do this, then cookies with any value for
firstPartyDomain
, as well as cookies which do not have
firstPartyDomain
set at all, will be included in the results. See
First-party isolation
.
名称
可选
A
string
representing a name that the cookies should have.
partitionKey
可选
An
对象
defining which
storage partitions
to return cookies from:
topLevelSite
, returns all cookies from partitioned and unpartitioned storage.
topLevelSite
specified, returns cookies from the specified partition storage.
This object contains:
topLevelSite
可选
A
string
representing the first-party URL of the top-level site storage partition containing the cookies.
path
可选
A
string
representing a path — the cookies' path must be identical to this one.
secure
可选
A
boolean
— filters cookies by their
secure
property, allowing you to filter secure cookies vs. non-secure cookies..
session
可选
A
boolean
— filters the cookies by their
session
property, allowing you to filter session cookies vs. persistent cookies.
storeId
可选
A
string
representing the cookie store to retrieve cookies from. If omitted, the current execution context's cookie store will be used.
url
可选
A
string
representing a URL that the retrieved cookies must be associated with.
A
Promise
that will be fulfilled with an array of
objects that match the properties given in the
cookies.Cookie
details
parameter. Only unexpired cookies are returned. The cookies returned will be sorted by path length, longest to shortest. If multiple cookies have the same path length, those with the earliest creation time will be first.
BCD tables only load in the browser
In the following snippet, we are making a call to get all of the cookies the browser currently has stored that have a name of "favorite-color". When the result is returned, we are printing the value of each result to the console.
function logCookies(cookies) {
for (let cookie of cookies) {
console.log(cookie.value);
}
}
var gettingAll = browser.cookies.getAll({
name: "favorite-color"
});
gettingAll.then(logCookies);
注意：
This API is based on Chromium's
chrome.cookies
API. This documentation is derived from
cookies.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改： , 由 MDN 贡献者