Function initializeFrame

packages/extension/src/frame/controller.ts:86–157

({
  root,
  target,
  sendParentMessage,
  onEmbeddingEnabled,
}: {
  root: HTMLDivElement;
  target: URL;
  sendParentMessage: SendParentMessage;
  onEmbeddingEnabled: () => void;
})

};

export const initializeFrame = async ({
  root,
  target,
  sendParentMessage,
  onEmbeddingEnabled,
}: {
  root: HTMLDivElement;
  target: URL;
  sendParentMessage: SendParentMessage;
  onEmbeddingEnabled: () => void;
}): Promise<void> => {
  const hasPermissions = await hasFrameEmbeddingPermissions();

  if (!hasPermissions) {
    const onRequestPermission = async (): Promise<PermissionRequestOutcome> => {
      try {
        const granted = await requestFrameEmbeddingPermissions();

        if (!granted) {
          sendParentMessage(extensionSiteEmbedFrameEvent.Error, {
            reason: 'permission-denied',
            target: target.href,
          });
          return 'dismissed';
        }

        sendParentMessage(extensionSiteEmbedFrameEvent.ReloadRequested, {
          target: target.href,
        });

        // After the optional permission prompt resolves, the fresh extension
        // context is much more reliable for enabling the DNR session rule.
        globalThis.setTimeout(() => {
          browser.runtime.reload();
        }, 100);

        return 'granted';
      } catch {
        sendParentMessage(extensionSiteEmbedFrameEvent.Error, {
          reason: 'permission-request-failed',
          target: target.href,
        });
        return 'failed';
      }
    };

    const onOptOut = () => {
      sendParentMessage(extensionSiteEmbedFrameEvent.OptOutRequested, {
        target: target.href,
      });
    };

    renderPermissionPrompt({
      root,
      onRequestPermission,
      onOptOut,
    });