webext-messenger 0.28.0 → 0.29.0

package/distribution/receiver.js

@@ -1,5 +1,5 @@
 import { serializeError } from "serialize-error";
-import { getContextName } from "webext-detect-page";
+import { getContextName } from "webext-detect";
 import { messenger } from "./sender.js";
 import { isObject, MessengerError, __webextMessenger } from "./shared.js";
 import { log } from "./logging.js";

package/distribution/sender.js

@@ -1,5 +1,5 @@
 import pRetry from "p-retry";
-import { isBackground } from "webext-detect-page";
+import { isBackground } from "webext-detect";
 import { deserializeError } from "serialize-error";
 import { isObject, MessengerError, __webextMessenger } from "./shared.js";
 import { log } from "./logging.js";
@@ -113,7 +113,10 @@ async function manageMessage(type, target, seq, retry, sendMessage) {
             log.debug(type, seq, "will retry. Attempt", error.attemptNumber);
         },
     }).catch((error) => {
-        if (error?.message === _errorNonExistingTarget) {
+        if (error &&
+            typeof error === "object" &&
+            "message" in error &&
+            error?.message === _errorNonExistingTarget) {
             throw new MessengerError(`The target ${JSON.stringify(target)} for ${type} was not found`);
         }
         events.dispatchEvent(new CustomEvent("attempts-exhausted", {

package/distribution/targetLogic.js

@@ -1,4 +1,4 @@
-import { isBackground, isContentScript } from "webext-detect-page";
+import { isBackground, isContentScript } from "webext-detect";
 export function compareTargets(to, thisTarget) {
     for (const [key, value] of Object.entries(to)) {
         if (thisTarget[key] === value) {

package/distribution/targetLogic.test.js

@@ -1,7 +1,7 @@
 import { assert, describe, test, vi } from "vitest";
 import { getActionForMessage } from "./targetLogic.js";
-import { isContentScript, isBackground } from "webext-detect-page";
-vi.mock("webext-detect-page");
+import { isContentScript, isBackground } from "webext-detect";
+vi.mock("webext-detect");
 const tab = {
     id: 1,
     url: "http://example.com",

package/distribution/thisTarget.js

@@ -1,4 +1,4 @@
-import { getContextName, isBackground, isExtensionContext, } from "webext-detect-page";
+import { getContextName, isBackground, isExtensionContext, isOffscreenDocument, } from "webext-detect";
 import { messenger } from "./sender.js";
 import { registerMethods } from "./receiver.js";
 import { MessengerError, once } from "./shared.js";
@@ -26,9 +26,12 @@ import { pEvent } from "p-event";
 // Soft warning: Race conditions are possible.
 // This CANNOT be awaited because waiting for it means "I will handle the message."
 // If a message is received before this is ready, it will just have to be ignored.
-export const thisTarget = isBackground()
-    ? { page: "background" }
-    : {
+export const thisTarget = (() => {
+    if (isBackground())
+        return { page: "background" };
+    if (isOffscreenDocument())
+        return { page: "offscreen" };
+    return {
         get page() {
             // Extension pages have relative URLs to simplify comparison
             const origin = location.protocol.startsWith("http")
@@ -38,9 +41,10 @@ export const thisTarget = isBackground()
             return origin + location.pathname + location.search;
         },
     };
+})();
 let tabDataStatus = 
-// The background page doesn't have a tab
-isBackground() ? "not-needed" : "needed";
+// Exclude contexts that don't have a tab associated to them
+isBackground() || isOffscreenDocument() ? "not-needed" : "needed";
 export function getTabDataStatus() {
     return tabDataStatus;
 }
@@ -51,7 +55,7 @@ const storeTabData = once(async () => {
     // If the page is prerendering, wait for the change to be able to get the tab data so the frameId is correct
     // https://developer.mozilla.org/en-US/docs/Web/API/Document/prerenderingchange_event
     if ("prerendering" in document && Boolean(document.prerendering)) {
-        await pEvent(document, 'prerenderingchange');
+        await pEvent(document, "prerenderingchange");
     }
     try {
         tabDataStatus = "pending";
@@ -73,8 +77,7 @@ export async function getThisFrame() {
     if (typeof tabId !== "number" || typeof frameId !== "number") {
         let moreInfo = "(error retrieving context information)";
         try {
-            moreInfo = `(context: ${getContextName()}, url: ${globalThis.location
-                ?.href})`;
+            moreInfo = `(context: ${getContextName()}, url: ${globalThis.location?.href})`;
         }
         catch { }
         throw new TypeError(`This target is not in a frame ${moreInfo}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webext-messenger",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Browser Extension component messaging framework",
   "keywords": [],
   "repository": "pixiebrix/webext-messenger",
@@ -29,31 +29,32 @@
     "p-event": "^6.0.1",
     "p-retry": "^6.2.0",
     "serialize-error": "^11.0.3",
-    "type-fest": "^4.18.3",
-    "webext-detect-page": "^5.0.1"
+    "type-fest": "^4.26.1",
+    "webext-detect": "^5.3.1",
+    "webext-events": "^3.1.1"
   },
   "@parcel/resolver-default": {
     "packageExports": true
   },
   "devDependencies": {
     "@parcel/config-webextension": "^2.11.0",
-    "@sindresorhus/tsconfig": "^5.0.0",
-    "@types/chrome": "^0.0.268",
+    "@sindresorhus/tsconfig": "^6.0.0",
+    "@types/chrome": "^0.0.279",
     "@types/tape": "^5.6.4",
-    "@types/webextension-polyfill": "^0.10.7",
+    "@types/webextension-polyfill": "^0.12.1",
     "buffer": "^6.0.3",
     "eslint": "^8.57.0",
-    "eslint-config-pixiebrix": "^0.39.0",
+    "eslint-config-pixiebrix": "^0.40.1",
     "events": "^3.3.0",
     "npm-run-all": "^4.1.5",
     "parcel": "^2.11.0",
     "path-browserify": "^1.0.1",
     "process": "^0.11.10",
     "stream-browserify": "^3.0.0",
-    "tape": "^5.7.5",
-    "typescript": "^5.4.5",
-    "vitest": "^1.6.0",
-    "webext-content-scripts": "^2.6.1",
+    "tape": "^5.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.4",
+    "webext-content-scripts": "^2.7.0",
     "webextension-polyfill": "^0.12.0"
   },
   "targets": {
@@ -73,7 +74,8 @@
     "run": {
       "startUrl": [
         "https://fregante.github.io/pixiebrix-testing-ground/Will-call-background-methods",
-        "https://fregante.github.io/pixiebrix-testing-ground/Will-call-other-CS-via-background"
+        "https://fregante.github.io/pixiebrix-testing-ground/Will-call-other-CS-via-background",
+        "https://fregante.github.io/pixiebrix-testing-ground/Will-call-offscreen-methods"
       ]
     }
   }

package/readme.md

@@ -19,7 +19,6 @@ import messenger from "webext-messenger";
 
 - [Initial considerations for this library](https://github.com/pixiebrix/webext-messenger/issues/1)
 
-
 ## npm publishing
 
 Collaborators can publish a new version of what's on main [via "workflow_dispatch"](https://github.blog/changelog/2020-07-06-github-actions-manual-triggers-with-workflow_dispatch/) under [Actions » Publish](https://github.com/pixiebrix/webext-messenger/actions/workflows/npm-publish.yml)