@vacantthinker/firefox-addon-framework-easy 2026.604.640 → 2026.604.1634

package/README.md

@@ -59,8 +59,16 @@ export function browserRuntimeManifestName() {  }
 
 ```
 
+### 📄 File: `src/browserRuntimeOnMessageCommon.js`
+```javascript
+export function browserRuntimeOnMessageCommon() {  }
+
+```
+
 ### 📄 File: `src/browserTab.js`
 ```javascript
+export async function browserTabSendMessage(tabId, message) {  }
+
 export async function browserTabCreateToDownload(message) {  }
 
 export async function browserTabCreateNearSendMessageToContentJs(message) {  }
@@ -146,6 +154,8 @@ export async function tabOpRemoveCssCode(tabId, code) {  }
 
 ### 📄 File: `src/serviceCommon.js`
 ```javascript
+export async function serviceDownloadByDownlink(message) {  }
+
 ```
 
 ### 📄 File: `src/serviceFetch.js`

package/index.js

@@ -2,6 +2,7 @@ export * from './src/BaseORM.js'
 export * from './src/browserDownload.js'
 export * from './src/browserNotification.js'
 export * from './src/browserRuntime.js'
+export * from './src/browserRuntimeOnMessageCommon.js'
 export * from './src/browserTab.js'
 export * from './src/DomainORM.js'
 export * from './src/generate.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0604.0640",
+  "version": "2026.0604.1634",
   "description": "",
   "main": "index.js",
   "publishConfig": {

package/src/BaseORM.js

@@ -1,7 +1,6 @@
 import {
   stoOpCheck,
   stoOpGet,
-  stoOpQueryStartWith,
   stoOpRem,
   stoOpSet,
 } from './opStorage.js';

package/src/browserDownload.js

@@ -2,13 +2,13 @@
  *
  * @param param0
  * @param param0.downlink{string}
- * @param param0.filename{string}
+ * @param param0.filename{string|null|undefined}
  * @returns {Promise<void>}
  */
 export async function browserDownloadByDownlink(
     {
       downlink,
-      filename,
+      filename= null,
     }) {
 
   let url = downlink;

package/src/browserRuntimeOnMessageCommon.js

@@ -0,0 +1,39 @@
+import {tabOpRemove} from './opTab.js';
+import {serviceDownloadByDownlink} from './serviceCommon.js';
+import {browserTabSendMessage} from './browserTab.js';
+
+/**
+ * offer common act <=> function, eg: actRemoveTab, actLog
+ */
+export function browserRuntimeOnMessageCommon() {
+  browser.runtime.onMessage.addListener(
+      (message, sender) => {
+        message['tab'] = sender.tab;
+        message['tabId'] = sender.tab?.id;
+
+        let keyAct = 'act';
+        /**
+         * @type{
+         *   |'actLog'
+         *   |'actRemoveTab'
+         *   |'actDownloadFile'
+         *   |'actSendMessageToTab'
+         * }
+         */
+        let act = message[keyAct];
+        delete message[keyAct];
+        if (act === 'actLog') {
+          console.log('act', act, 'message', message);
+        }
+        else if (act === 'actRemoveTab') {
+          tabOpRemove(message.tabId)
+        }
+        else if (act === 'actDownloadFile') {
+          serviceDownloadByDownlink(message);
+        }
+        else if (act === 'actSendMessageToTab') {
+          browserTabSendMessage(message.tabId, message);
+        }
+      });
+
+}

package/src/browserTab.js

@@ -3,7 +3,7 @@
 import {browserNotificationCreate} from './browserNotification.js';
 import {tabOpCreateNear, tabOpRemove} from './opTab.js';
 
-async function browserTabSendMessage(tabId, message) {
+export async function browserTabSendMessage(tabId, message) {
   await browser.tabs.sendMessage(tabId, message);
 }
 

package/src/serviceCommon.js

@@ -0,0 +1,22 @@
+import {browserDownloadByDownlink} from './browserDownload.js';
+import {browserNotificationCreate} from './browserNotification.js';
+
+/**
+ * service, download by downlink, if success, notification the filename
+ *
+ * if failed, nootification the reason, then try download only use downlink
+ * @param message
+ * @returns {Promise<void>}
+ */
+export async function serviceDownloadByDownlink(message) {
+  let {filename, downlink} = message;
+
+  try {
+    await browserDownloadByDownlink(message);
+    await browserNotificationCreate(`downloading! ${filename}`);
+  } catch (e) {
+    await browserNotificationCreate(`reason=${e}`)
+    await browserDownloadByDownlink({downlink});
+  }
+
+}