menus.ContextType
The different contexts a menu item can appear in.
The different contexts a menu item can appear in.
Type
Values of this type are strings. The item is displayed when the given context applies. Possible values are:
all- : Specifying 'all' is equivalent to the combination of all other contexts except for 'bookmark', 'tab' and 'tools_menu'.
action- : Applies when the user context-clicks your browser action in a Manifest V3 extension. The maximum number of items that can be added to the top-level browser action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.
audio- : Applies when the user context-clicks an audio element.
bookmark-
: Applies when the user context-clicks a bookmark item in the bookmarks toolbar, bookmarks menu, bookmarks sidebar (Ctrl+B) and the Library window (Ctrl+Shift+B). The latter two are supported as of Firefox 66. Requires the "bookmarks" API permission in the manifest.
-
browser_action - : Applies when the user context-clicks your browser action in a Manifest V2 extension. The maximum number of items that can be added to the top-level browser action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.
editable- : Applies when the user context-clicks an editable element, like a textarea.
frame- : Applies when the user context-clicks in a nested iframe.
image- : Applies when the user context-clicks an image.
link- : Applies when the user context-clicks on a link.
page- : Applies when the user context-clicks in the page, but none of the other page contexts apply (for example, the click is not on an image or a nested iframe or a link).
page_action- : Applies when the user context-clicks your page action. The maximum number of items that can be added to the top-level page action context menu is menus.ACTION_MENU_TOP_LEVEL_LIMIT, but you can add any number of items to submenus.
password- : Applies when the user context-clicks on a password input element.
selection- : Applies when part of the page is selected.
tab-
: Applies when the user context-clicks on a tab (specifically, this refers to the tab-strip or other user interface element enabling the user to switch from one browser tab to another, not to the page itself).
Clicking the menu item on a tab grants the
activeTabpermission for the tab clicked, even if that isn't the active tab. -
tools_menu - : The item is added to the browser's tools menu.
video- : Applies when the user context-clicks a video element.
Note that "launcher" is not supported.
Browser compatibility
[!NOTE] This API is based on Chromium's
chrome.contextMenusAPI. This documentation is derived fromcontext_menus.jsonin the Chromium code.