({
root,
target,
sendParentMessage,
onEmbeddingEnabled,
}: {
root: HTMLDivElement;
target: URL;
sendParentMessage: SendParentMessage;
onEmbeddingEnabled: () => void;
})
| 18 | type PermissionRequestOutcome = 'granted' | 'dismissed' | 'failed'; |
| 19 | |
| 20 | const prepareEmbedding = async ({ |
| 21 | root, |
| 22 | target, |
| 23 | sendParentMessage, |
| 24 | onEmbeddingEnabled, |
| 25 | }: { |
| 26 | root: HTMLDivElement; |
| 27 | target: URL; |
| 28 | sendParentMessage: SendParentMessage; |
| 29 | onEmbeddingEnabled: () => void; |
| 30 | }): Promise<boolean> => { |
| 31 | sendParentMessage(extensionSiteEmbedFrameEvent.PermissionsReady, { |
| 32 | target: target.href, |
| 33 | }); |
| 34 | |
| 35 | // The visible site iframe only mounts after the tab-scoped rule is live. |
| 36 | // That avoids a flash of the browser's built-in frame-blocked error page. |
| 37 | renderMessage( |
| 38 | root, |
| 39 | 'Preparing embedded browsing', |
| 40 | 'Configuring this tab so the requested site can be embedded safely.', |
| 41 | ); |
| 42 | |
| 43 | const result = await enableFrameEmbeddingViaBackground(); |
| 44 | if (!result.enabled) { |
| 45 | sendParentMessage(extensionSiteEmbedFrameEvent.Error, { |
| 46 | reason: 'enable-frame-embedding-failed', |
| 47 | target: target.href, |
| 48 | error: result.error ?? 'Unknown frame embedding error', |
| 49 | }); |
| 50 | return false; |
| 51 | } |
| 52 | |
| 53 | // The webapp keeps this frame mounted invisibly after success so it can |
| 54 | // tear the tab-scoped rule down when the page unloads or a new target starts. |
| 55 | onEmbeddingEnabled(); |
| 56 | sendParentMessage(extensionSiteEmbedFrameEvent.EmbeddingReady, { |
| 57 | target: target.href, |
| 58 | }); |
| 59 | return true; |
| 60 | }; |
| 61 | |
| 62 | export const createFrameCleanupController = () => { |
| 63 | let shouldDisableEmbeddingOnCleanup = false; |
no test coverage detected