set()
方法在
Cookie
API sets a cookie containing the specified cookie data. This method is equivalent to issuing an HTTP
Set-Cookie
header during a request to a given URL.
The call succeeds only if you include the "cookies" API permission 在您的 manifest.json file, as well as host permissions for the given URL specified in its manifest. The given URL also needs the necessary permissions to create a cookie with the given parameters.
This is an asynchronous function that returns a
Promise
.
var setting = browser.cookies.set(
details
// object
)
details
An
对象
containing the details of the cookie you wish to set. It can have the following properties:
domain
可选
A
string
representing the domain of the cookie. If omitted, the cookie becomes a host-only cookie.
expirationDate
可选
A
编号
that represents the expiration date of the cookie as the number of seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie.
firstPartyDomain
可选
A
string
representing the first-party domain with which the cookie to will be associated. This property must be supplied if the browser has first-party isolation enabled. See
First-party isolation
.
httpOnly
可选
A
boolean
that specifies whether the cookie should be marked as HttpOnly (
true
), or not (false). If omitted, it defaults to false.
名称
可选
A
string
representing the name of the cookie. If omitted, this is empty by default.
partitionKey
可选
An
对象
表示
storage partition
to set the cookie in. Include this object to set a cookie in partitioned storage. This object contains:
topLevelSite
可选
A
string
representing the first-party URL of the top-level site storage partition containing the cookie.
path
可选
A
string
representing the path of the cookie. If omitted, this defaults to the path portion of the URL parameter.
sameSiteOptional
A
cookies.SameSiteStatus
value that indicates the SameSite state of the cookie. If omitted, it defaults to 0, 'no_restriction'.
secure
可选
A
boolean
that specifies whether the cookie should be marked as secure (
true
), or not (false). If omitted, it defaults to false.
storeId
可选
A
string
representing the ID of the cookie store in which to set the cookie. If omitted, the cookie is set in the current execution context's cookie store by default.
url
A
string
representing the request-URI to associate with the cookie. This value can affect the default domain and path values of the created cookie. If host permissions for this URL are not specified in the manifest file, the method call will fail.
value
可选
A
string
representing the value of the cookie. If omitted, this is empty by default.
A
Promise
that will be fulfilled with a
cookies.Cookie
object containing details about the cookie that's been set. If the call fails for any reason, the promise will be rejected with an error message.
BCD tables only load in the browser
This example sets a cookie for the document hosted by the currently active tab:
var getActive = browser.tabs.query({active: true, currentWindow: true});
getActive.then(setCookie);
function setCookie(tabs) {
browser.cookies.set({
url: tabs[0].url,
name: "favorite-color",
value: "red"
});
}
注意：
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 贡献者