menus.remove()
Removes a menu item.
For compatibility with other browsers, Firefox makes this method available via the contextMenus
namespace as well as the menus
namespace.
This is an asynchronous function that returns a Promise
.
Syntax
var removing = browser.menus.remove(
menuItemId // integer or string
)
Parameters
Return value
A Promise
that will be fulfilled with no arguments if removal was successful, or rejected with an error message if removal failed (for example, because the item could not be found).
Examples
This extension adds a menu item labeled "Remove me!". If you click the item, the extension removes it.
function onRemoved() {
console.log("item removed successfully");
}
function onError() {
console.log("error removing item:" + browser.runtime.lastError);
}
browser.menus.create({
id: "remove-me",
title: "Remove me!",
contexts: ["all"]
});
browser.menus.onClicked.addListener(function(info, tab) {
if (info.menuItemId == "remove-me") {
var removing = browser.menus.remove(info.menuItemId);
removing.then(onRemoved, onError);
}
});
Example extensions
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
remove | ChromeFull supportYes
| EdgeFull support14
| FirefoxFull support55
| OperaFull supportYes
| SafariFull support14
| Firefox for AndroidNo supportNo |
Legend
- Full support
- Full support
- No support
- No support
- Uses a non-standard name.
The compatibility table on 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.
Acknowledgements
This API is based on Chromium's chrome.contextMenus
API. This documentation is derived from context_menus.json
in the Chromium code.