How can a content script target a frame?

[fregante]

How can a content script target a frame?

[twschiller]

There's a few different scenarios:

1. A singleton extension "component", e.g., the PixieBrix sidebar of which there will ever be at most 1 on the page
2. A persistent frame that the extension added, e.g., an inline panel that uses a frame for showing its content to isolate styles/hotkeys from the main page. In this case, there may be more than 1 frame, but they could potentially be uniquely identified by the extension id that placed the frame
3. Frames from 3rd party sites. E.g., a common case is a iframe embedded in a SaaS app via the app's marketplace. (I.e., the SaaS app is using frames to protect against malicious apps in their marketplace)

Therefore I think supporting a couple patterns could be useful:

• Allow a frame to register a unique name that it can be referenced by on the tab. This also enables scenario 2 because the contentScript would know the name of the frame ahead of time (at least in our case, it could be derived from the extension id)
• Support matching by frame URL, with the caller selecting whether multiple matches are an error or result in an array of responses being response

Related:

• pixiebrix/pixiebrix-extension#1603. This issue was created with scenario #3 in mind

[fregante]

This could happen in the user’s code, but it would mean having to implement mapping, waiting, registration events, etc… outside webext-messenger

I'm going to implement named targets. More in:

• #5 (comment)

[fregante]

Currently the messenger lets us target chrome-extension pages by URL since chrome.runtime.sendMessage will send a message to every such page:

doSomething({ page: "/iframe.html" }, ...args);

it can also target such page in a specific tab:

doSomething({ page: "/iframe.html", tabId: 123 }, ...args);

chrome.tabs.sendMessage can do something similar IIRC, but only as long as you know the tab ID:

// I think
browser.tabs.sendMessage(tabId, message, {
	allFrames: true
})

The messenger does not support this yet, but maybe we can implement it:

doSomething({ page: "https://full.page.url/iframe.html", tabId: 123 }, ...args);

With two requirements:

• it must receive a tab ID
• it must receive a full https URL so that the messenger knows whether to use chrome.runtime or chrome.tabs to send the message

Since content scripts cannot use the chrome.tabs API, the messenger would have to forward them via the background page as well.