Creates a new contextual identity. Once created, the user will be able to create new tabs belonging to this contextual identity, just as they can with the built-in identities.
This is an asynchronous function that returns a Promise
.
Syntax
var createContext = browser.contextualIdentities.create( details // object )
Parameters
details
-
object
. An object containing properties for the new contextual identity. This contains the following properties:name
-
string
. The name of the new identity. This will be displayed in the browser's UI, enabling them to open a new tab belonging to the identity. It will also be displayed in the URL bar for tabs belonging to this identity. color
-
. The color associated with the new identity. This will be used to highlight tabs belonging to this identity. You can supply any of the following values here:string
- "blue"
- "turquoise"
- "green"
- "yellow"
- "orange"
- "red"
- "pink"
- "purple"
icon
-
string
. The name of an icon to display in the URL bar for tabs belonging to this 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 new identity.
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Chrome | Edge | Firefox | Firefox for Android | Opera | |
---|---|---|---|---|---|
Basic support | No | No | 53 | 53 | No |
Examples
This example creates a new contextual identity and logs its cookie store ID:
function onCreated(context) { console.log(`New identity's ID: ${context.cookieStoreId}.`); } function onError(e) { console.error(e); } browser.contextualIdentities.create({ name: "my-thing", color: "purple", icon: "briefcase" }).then(onCreated, onError);