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
.
var createContext = browser.contextualIdentities.create(
details
// object
)
details
对象
. An object containing properties for the new contextual identity. This contains the following properties:
名称
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
string
. 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:
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:
A
Promise
that will be fulfilled with a
ContextualIdentity
that describes the new identity. If the contextual identities feature is not enabled, the promise is rejected.
BCD tables only load in the browser
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);
最后修改： , 由 MDN 贡献者