menus.ContextType
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. -
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.contextMenus API. This documentation is derived from context_menus.json in the Chromium code.