contextualIdentities.update()

Updates properties of a contextual identity, given its cookie store ID.

This is an asynchronous function that returns a Promise.

Syntax

var createContext = browser.contextualIdentities.update(
  cookieStoreId,           // string
  details                  // object
)

Parameters

cookieStoreId

string. The ID of this contextual identity's cookie store. Because contextual identities each have their own cookie store, this serves as an identifier for the contextual identity itself.

details

object. An object containing new values for the properties that you wish to change. This may contain any of the following properties:

name Optional

string. A new name for the identity. This will be displayed in the browser's UI, enabling them to open a new tab in the identity. It will also be displayed in the URL bar for tabs belonging to this identity.

color Optional

string. A new color for the identity. This will be used to highlight tabs belonging to this identity. You can supply any of the following values here:

  • "blue"
  • "turquoise"
  • "green"
  • "yellow"
  • "orange"
  • "red"
  • "pink"
  • "purple" 
icon Optional

string. A new icon for the identity. You can supply any of the following values here:

  • "fingerprint"
  • "briefcase"
  • "dollar"
  • "cart"
  • "circle"

Return value

A Promise that will be fulfilled with a ContextualIdentity that describes the updated identity. If the identity could not be found or the contextual identities feature is not enabled, the promise is rejected.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Notes Before version 57, this method resolves its promise with null if the given identity was not found.
Opera No support NoFirefox Android Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Notes Before version 57, this method resolves its promise with null if the given identity was not found.

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

Examples

This example updates the contextual identity whose ID is "firefox-container-1" to have a new name, color, and icon:

function onUpdated(context) {
  console.log(`New identity's name: ${context.name}.`);
}

function onError(e) {
  console.error(e);
}

browser.contextualIdentities.update(
  "firefox-container-1", {
    name: "my-thing",
    color: "purple",
    icon: "briefcase"
  }).then(onUpdated, onError);

Document Tags and Contributors

Contributors to this page: wbamberg
Last updated by: wbamberg,