menus.getTargetElement()

Returns the element for a given targetElementId

This method is available to all extension script contexts (content scripts, background pages and other extension pages) and returns the element for a given info.targetElementId, provided that the element still exists in the document where the method is invoked.

The method only works in the document that includes the right-clicked element and the targetElementId expires when the user opens another context menu.

Note: menus.getTargetElement only return the requested element if called in the same context as the document that contains the element, for example using content scripts (as shown in the example below).

An extension requires the "menus" permission to use this API.

Syntax

let elem = browser.menus.getTargetElement(targetElementId);

Parameters

targetElementId
The property of the menus.OnClickData object passed to the menus.onClicked handler or menus.onShown event.

Return value

The element referred to by the targetElementId parameter. If the targetElementId parameter is not valid, the method returns null.

Examples

The following example uses the getTargetElement method to get the element referred to by the info.targetElementId property and then removes it.

browser.menus.create({
  title: "Remove element",
  documentUrlPatterns: ["*://*/*"],
  contexts: ["audio", "editable", "frame", "image", "link", "page", "password", "video"],
  onclick(info, tab) {
    browser.tabs.executeScript(tab.id, {
      frameId: info.frameId,
      code: `browser.menus.getTargetElement(${info.targetElementId}).remove();`,
    });
  },
});

Example extensions

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
getTargetElementChrome No support NoEdge No support NoFirefox Full support 63Opera No support NoFirefox Android No support No

Legend

Full support  
Full support
No support  
No support

See also