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
object passed to themenus.OnClickData
handler ormenus.onClicked
event.menus.onShown
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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getTargetElement |
No |
No |
63 |
? |
No |
No |
? |
? |
No |
? |
? |
? |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus/getTargetElement