cookies.set()

details

An object containing the details of the cookie you wish to set. It can have the following properties:

domain Optional

A string representing the domain of the cookie. If omitted, the cookie becomes a host-only cookie.

expirationDate Optional

A number 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 Optional

A string representing the first-party domain with which the cookie will be associated. This property must be supplied if the browser has first-party isolation enabled. See First-party isolation.

httpOnly Optional

A boolean that specifies whether the cookie should be marked as HttpOnly (true), or not (false). If omitted, it defaults to false.

name Optional

A string representing the name of the cookie. If omitted, this is empty by default.

partitionKey Optional

An object representing the storage partition to set the cookie in. Include this object to set a cookie in partitioned storage. This object contains:

topLevelSite Optional

A string representing the first-party URL of the top-level site storage partition containing the cookie.

path Optional

A string representing the path of the cookie. If omitted, this defaults to the path portion of the URL parameter.

sameSite Optional

A cookies.SameSiteStatus value that indicates the SameSite state of the cookie. If omitted, it defaults to 0, 'no_restriction'.

secure Optional

A boolean that specifies whether the cookie should be marked as secure (true), or not (false). If omitted, it defaults to false.

storeId Optional

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 Optional

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.

This example sets a cookie for the document hosted by the currently active tab:

let 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"
  });
}

• cookie-bg-picker