#3200: run brick in top frame of window

src/background/executor.ts

@@ -74,6 +74,10 @@ export async function waitForTargetByUrl(url: string): Promise<Target> {
   return promise;
 }
 
+/**
+ * Run a brick in the window that opened the source window
+ * @param request
+ */
 export async function requestRunInOpener(
   this: MessengerMeta,
   request: RunBlock
@@ -91,6 +95,38 @@ export async function requestRunInOpener(
   return safelyRunBrick(opener, subRequest);
 }
 
+/**
+ * Run a brick in the last window that was opened from the source window
+ * @see openTab
+ */
+export async function requestRunInTarget(
+  this: MessengerMeta,
+  request: RunBlock
+): Promise<unknown> {
+  const sourceTabId = this.trace[0].tab.id;
+  const target = tabToTarget.get(sourceTabId);
+
+  if (!target) {
+    throw new BusinessError("Sender tab has no target");
+  }
+
+  const subRequest = { ...request, sourceTabId };
+  return safelyRunBrick({ tabId: target }, subRequest);
+}
+
+/**
+ * Run a brick in the topmost frame of the window/tab
+ */
+export async function requestRunInTop(
+  this: MessengerMeta,
+  request: RunBlock
+): Promise<unknown> {
+  const sourceTabId = this.trace[0].tab.id;
+
+  const subRequest = { ...request, sourceTabId };
+  return safelyRunBrick({ tabId: sourceTabId }, subRequest);
+}
+
 export async function requestRunInBroadcast(
   this: MessengerMeta,
   request: RunBlock
@@ -124,21 +160,6 @@ export async function requestRunInBroadcast(
   return [...fulfilled].map(([, value]) => value);
 }
 
-export async function requestRunInTarget(
-  this: MessengerMeta,
-  request: RunBlock
-): Promise<unknown> {
-  const sourceTabId = this.trace[0].tab.id;
-  const target = tabToTarget.get(sourceTabId);
-
-  if (!target) {
-    throw new BusinessError("Sender tab has no target");
-  }
-
-  const subRequest = { ...request, sourceTabId };
-  return safelyRunBrick({ tabId: target }, subRequest);
-}
-
 export async function openTab(
   this: MessengerMeta,
   createProperties: Tabs.CreateCreatePropertiesType

src/background/messenger/api.ts

@@ -76,6 +76,7 @@ export const requestRun = {
   onServer: getMethod("REQUEST_RUN_ON_SERVER", bg),
   inOpener: getMethod("REQUEST_RUN_IN_OPENER", bg),
   inTarget: getMethod("REQUEST_RUN_IN_TARGET", bg),
+  inTop: getMethod("REQUEST_RUN_IN_TOP", bg),
   inAll: getMethod("REQUEST_RUN_IN_ALL", bg),
 };
 

src/background/messenger/registration.ts

@@ -35,6 +35,7 @@ import {
   requestRunInTarget,
   requestRunInBroadcast,
   waitForTargetByUrl,
+  requestRunInTop,
 } from "@/background/executor";
 import * as registry from "@/registry/localRegistry";
 import { ensureContentScript } from "@/background/util";
@@ -105,6 +106,7 @@ declare global {
     REQUEST_RUN_ON_SERVER: typeof requestRunOnServer;
     REQUEST_RUN_IN_OPENER: typeof requestRunInOpener;
     REQUEST_RUN_IN_TARGET: typeof requestRunInTarget;
+    REQUEST_RUN_IN_TOP: typeof requestRunInTop;
     REQUEST_RUN_IN_ALL: typeof requestRunInBroadcast;
 
     HTTP_REQUEST: typeof serializableAxiosRequest;
@@ -174,6 +176,7 @@ export default function registerMessenger(): void {
     REQUEST_RUN_ON_SERVER: requestRunOnServer,
     REQUEST_RUN_IN_OPENER: requestRunInOpener,
     REQUEST_RUN_IN_TARGET: requestRunInTarget,
+    REQUEST_RUN_IN_TOP: requestRunInTop,
     REQUEST_RUN_IN_ALL: requestRunInBroadcast,
 
     HTTP_REQUEST: serializableAxiosRequest,

src/blocks/types.ts

@@ -79,11 +79,18 @@ export type ReaderConfig =
  * - self: the current tab
  * - opener: the tab that opened the current tab
  * - target: the last tab that the current tab opened
+ * - top: the top-most frame in the window
  * - broadcast: all tabs that PixieBrix has access to (the result is returned as an array)
  * - remote: the server (currently only support identity, get, and http bricks)
  * @see {@link BlockConfig.window}
  */
-export type BlockWindow = "self" | "opener" | "target" | "broadcast" | "remote";
+export type BlockWindow =
+  | "self"
+  | "opener"
+  | "target"
+  | "top"
+  | "broadcast"
+  | "remote";
 
 /**
  * Condition expression written in templateEngine for deciding if the step should be run.

src/pageEditor/tabs/effect/BlockConfiguration.tsx

@@ -47,6 +47,7 @@ const targetOptions: Array<Option<BlockWindow>> = [
   { label: "Current Tab (self)", value: "self" },
   { label: "Opener Tab (opener)", value: "opener" },
   { label: "Target Tab (target)", value: "target" },
+  { label: "Top-level Frame (top)", value: "top" },
   { label: "All Tabs (broadcast)", value: "broadcast" },
   { label: "Server (remote)", value: "remote" },
 ];

src/runtime/reducePipeline.ts

@@ -231,6 +231,10 @@ async function execute(
       return requestRun.inTarget(request);
     }
 
+    case "top": {
+      return requestRun.inTop(request);
+    }
+
     case "broadcast": {
       return requestRun.inAll(request);
     }