menus.getTargetElement()
Renvoie l'élément pour un targetElementId
donné
Cette méthode est disponible pour tous les contextes de script d'extension (scripts de contenu, pages de fond et autres pages d'extension) et retourne l'élément pour un info.targetElementId
donnée, à condition que l'élément existe toujours dans le document où la méthode est appelée.
La méthode ne fonctionne que dans le document qui inclut l'élément cliqué avec le bouton droit de la souris et la méthode targetElementId
expire lorsque l'utilisateur ouvre un autre menu contextuel.
Note : menus.getTargetElement
ne retourne l'élément demandé que s'il est appelé dans le même contexte que le document qui contient l'élément, par exemple en utilisant des scripts de contenu (comme dans l'exemple ci-dessous).
Une extension nécessite la permission "menus" pour utiliser cette API
Syntaxe
let elem = browser.menus.getTargetElement(targetElementId);
Paramètres
targetElementId
-
La propriété de l'objet
passé au gestionnairemenus.OnClickData
ou à l'événementmenus.onClicked
.menus.onShown
Valeur retournée
L'élément auquel se réfère le paramètre targetElementId
. Si le paramètre targetElementId
n'est pas valide, La méthode retourne null
.
Exemples
L'exemple suivant utilise la méthode getTargetElement
pour obtenir l'élément auquel se réfère la propriété info.targetElementId
puis le supprime.
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
Compatibilité des navigateurs
BCD tables only load in the browser