@vacantthinker/firefox-addon-framework-easy 2026.604.1641 → 2026.604.1745

package/README.md

@@ -34,7 +34,7 @@ export async function browserDownloadByDownlink(
 ```javascript
 export async function browserNotificationCreate(
     content,
-    title = browserRuntimeManifestName()
+    title = browserRuntimeManifestName(),
 ) {  }
 
 ```
@@ -44,7 +44,7 @@ export async function browserNotificationCreate(
 export function browserRuntimeReload() {  }
 
 export async function browserRuntimeSetUninstallURL(
-    url = 'https://addons.mozilla.org/en-US/firefox/user/17783213/',
+    url = '',
 ) {  }
 
 export function browserRuntimeOnUpdateAvailable(doWhat = null) {  }
@@ -69,6 +69,8 @@ export function browserRuntimeOnMessageCommon() {  }
 ```javascript
 export async function browserTabSendMessage(tabId, message) {  }
 
+export function browserTabWaitReloadThenSendMessageToContentJs(message) {  }
+
 export async function browserTabCreateToDownload(message) {  }
 
 export async function browserTabCreateNearSendMessageToContentJs(message) {  }
@@ -163,7 +165,6 @@ export async function serviceDownloadByDownlink(message) {  }
 export async function servicePostJson(
     serverUrl,
     message,
-    handleError,
 ) {  }
 
 export async function serviceSendDataToLocalAria2(message) {  }

package/package.json

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

package/src/BaseORM.js

@@ -1,9 +1,4 @@
-import {
-  stoOpCheck,
-  stoOpGet,
-  stoOpRem,
-  stoOpSet,
-} from './opStorage.js';
+import {stoOpCheck, stoOpGet, stoOpRem, stoOpSet} from './opStorage.js';
 
 /**
  * Abstract base class BaseORM (similar to Java's Abstract Class).
@@ -23,10 +18,11 @@ export class BaseORM {
    */
   constructor(prefix, id, defaultValue = {}) {
     if (new.target === BaseORM) {
-      throw new TypeError("Cannot construct BaseORM instances directly (Abstract Class).");
+      throw new TypeError(
+          'Cannot construct BaseORM instances directly (Abstract Class).');
     }
     if (!prefix || !id) {
-      throw new Error("Both prefix and id must be specified.");
+      throw new Error('Both prefix and id must be specified.');
     }
 
     // Save the raw id to the private field

package/src/DomainORM.js

@@ -2,11 +2,10 @@ import {BaseORM} from './BaseORM.js';
 
 export class DomainORM extends BaseORM {
   constructor(domain) {
-    super(`domainKey`, domain, {
-
-    });
+    super(`domainKey`, domain, {});
   }
-  logKey(){
+
+  logKey() {
     console.info(this.id); // domainKey 123sdfsdf
   }
 }

package/src/browserDownload.js

@@ -8,7 +8,7 @@
 export async function browserDownloadByDownlink(
     {
       downlink,
-      filename= null,
+      filename = null,
     }) {
 
   let url = downlink;

package/src/browserNotification.js

@@ -8,20 +8,15 @@ import {browserRuntimeManifestName} from './browserRuntime.js';
  */
 export async function browserNotificationCreate(
     content,
-    title = browserRuntimeManifestName()
+    title = browserRuntimeManifestName(),
 ) {
 
   const tag = 'browserNotificationCreate';
-  try {
-    let notificationId = `${tag}cake-noti`;
-    console.info(tag, `content=${content}`, `title=${title}`);
-    await browser.notifications.create(notificationId, {
-      type: 'basic',
-      title,
-      message: `${content}`,
-    });
-    return notificationId;
-  } catch (e) {
-    console.error(tag, e);
-  }
+  let notificationId = `${tag}cake-noti`;
+  await browser.notifications.create(notificationId, {
+    type: 'basic',
+    title,
+    message: `${content}`,
+  });
+  return notificationId;
 }

package/src/browserRuntime.js

@@ -1,6 +1,3 @@
-import {tabOpCreateActiveFalse} from './opTab.js';
-import {browserNotificationCreate} from './browserNotification.js';
-
 export function browserRuntimeReload() {
   browser.runtime.reload();
 }
@@ -10,7 +7,7 @@ export function browserRuntimeReload() {
  * @param url{string}
  */
 export async function browserRuntimeSetUninstallURL(
-    url = 'https://addons.mozilla.org/en-US/firefox/user/17783213/',
+    url = '',
 ) {
   await browser.runtime.setUninstallURL(url);
 }
@@ -24,21 +21,6 @@ export function browserRuntimeOnUpdateAvailable(doWhat = null) {
     if (doWhat) {
       await doWhat(details);
     }
-    else {
-      try {
-        let id = await browserNotificationCreate(
-            'There is a new version!',
-        );
-        browser.notifications.onClicked.addListener(async (notificationId) => {
-          if (notificationId === id) {
-            let url = 'https://addons.mozilla.org/en-US/firefox/user/17783213/';
-            await tabOpCreateActiveFalse({url});
-          }
-        });
-      } catch (e) {
-        console.error(e);
-      }
-    }
   });
 }
 

package/src/browserRuntimeOnMessageCommon.js

@@ -25,7 +25,7 @@ export function browserRuntimeOnMessageCommon() {
           console.log('act', act, 'message', message);
         }
         else if (act === 'actRemoveTab') {
-          tabOpRemove(message.tabId)
+          tabOpRemove(message.tabId);
         }
         else if (act === 'actDownloadFile') {
           serviceDownloadByDownlink(message);

package/src/browserTab.js

@@ -7,6 +7,18 @@ export async function browserTabSendMessage(tabId, message) {
   await browser.tabs.sendMessage(tabId, message);
 }
 
+export function browserTabWaitReloadThenSendMessageToContentJs(message) {
+  let tabId = message.tabId;
+  browser.tabs.onUpdated.addListener(
+      async function lis(tabId, changeInfo) {
+        if (changeInfo.status === 'complete') {
+          browser.tabs.onUpdated.removeListener(lis);
+          await browserTabSendMessage(tabId, message);
+        }
+      }
+      , {tabId, properties: ['status']});
+}
+
 /**
  * must has,  url
  * @param message{{
@@ -33,13 +45,12 @@ export async function browserTabCreateToDownload(message) {
         if (changeInfo.status === 'complete') {
           browser.tabs.onUpdated.removeListener(lis);
           // todo code here
-          await tabOpRemove(tabId)
+          await tabOpRemove(tabId);
         }
       }
       , {tabId, properties: ['status']});
 }
 
-
 /**
  * must has, tabId, url
  * @param message{{

package/src/generate.js

@@ -29,6 +29,10 @@ export function generateHtmlByUserSettings(
 
     // --- CONDITION 1: CHECKBOX & RADIO ---
     if (type === 'checkbox' || type === 'radio') {
+      /**
+       *
+       * @type {string[]}
+       */
       const options = storageValue.options || [];
 
       options.map((option) => {
@@ -63,8 +67,6 @@ export function generateHtmlByUserSettings(
             }
 
             const valueNew = Array.from(set);
-            console.info(
-                `k=${storageKey} option=${option} eleInput.checked=${eleInput.checked} valueNew=${valueNew}`);
             await stoOpSet(storageKey, valueNew);
 
             // Dynamic visibility update
@@ -86,7 +88,6 @@ export function generateHtmlByUserSettings(
 
           eleLabel.onclick = function() {
             stoOpSet(storageKey, option).then(() => {
-              console.info(`k=${storageKey} option=${option}`);
               if (typeof radioItemClickCallback === 'function') {
                 radioItemClickCallback(storageKey, option);
               }
@@ -120,7 +121,6 @@ export function generateHtmlByUserSettings(
         eleButton.addEventListener('click', async () => {
           currentStatus = !currentStatus; // Toggle state
           eleButton.textContent = String(currentStatus);
-          console.info(`k=${storageKey} toggled to=${currentStatus}`);
           await stoOpSet(storageKey, currentStatus);
 
           // Dynamic visibility update
@@ -152,7 +152,6 @@ export function generateHtmlByUserSettings(
         const rawValue = eleInput.value;
         const finalizedValue = type === 'number' ? Number(rawValue) : rawValue;
 
-        console.info(`k=${storageKey} value changed to=${finalizedValue}`);
         await stoOpSet(storageKey, finalizedValue);
 
         // Dynamic visibility update

package/src/opStorage.js

@@ -4,16 +4,11 @@
  * @returns {Promise<boolean>}
  */
 export async function stoOpCheck(k) {
-  try {
-    let key = k.toString();
+  let key = k.toString();
 
-    let objGet = await browser.storage.local.get(key);
-    let b = objGet.hasOwnProperty(key);
-    console.info(`key=${key} exists ${b}`);
-    return b;
-  } catch (e) {
-    return false;
-  }
+  let objGet = await browser.storage.local.get(key);
+  let b = objGet.hasOwnProperty(key);
+  return b;
 }
 
 /**
@@ -22,15 +17,10 @@ export async function stoOpCheck(k) {
  * @returns {Promise<any|null>}
  */
 export async function stoOpGet(k) {
-  try {
-    let key = k.toString();
-    let objGet = await browser.storage.local.get(key);
-    let v = objGet[key];
-    console.info(`key=${k} value=\n`, v);
-    return v;
-  } catch (e) {
-    return null;
-  }
+  let key = k.toString();
+  let objGet = await browser.storage.local.get(key);
+  let v = objGet[key];
+  return v;
 }
 
 /**
@@ -38,12 +28,7 @@ export async function stoOpGet(k) {
  * @returns {Promise<{[p: string]: any}|null>}
  */
 export async function stoOpGetAll() {
-  try {
-    return await browser.storage.local.get();
-  } catch (e) {
-    console.error(e);
-    return null;
-  }
+  return await browser.storage.local.get();
 }
 
 /**
@@ -52,14 +37,9 @@ export async function stoOpGetAll() {
  * @returns {Promise<string[]|null>}
  */
 export async function stoOpQueryStartWith(k) {
-  try {
-    let objAll = await browser.storage.local.get();
-    let keys = Object.keys(objAll);
-    return keys.filter(value => value.startsWith(k.toString()));
-  } catch (e) {
-    console.error(e);
-    return null;
-  }
+  let objAll = await browser.storage.local.get();
+  let keys = Object.keys(objAll);
+  return keys.filter(value => value.startsWith(k.toString()));
 }
 
 /**
@@ -82,11 +62,8 @@ export async function stoOpSet(k, v) {
  * @returns {Promise<void>}
  */
 export async function stoOpRem(k) {
-  try {
-    let key = k.toString();
-    await browser.storage.local.remove(key);
-  } catch (e) {
-  }
+  let key = k.toString();
+  await browser.storage.local.remove(key);
 }
 
 /**

package/src/opTab.js

@@ -30,13 +30,12 @@ export async function tabOpCreateNear(properties) {
   delete properties.tabId;
   Object.assign(properties, {
     index: tabPrev.index + 1, openerTabId: tabPrev.id,
-  })
+  });
 
   let tab = await tabOpCreate(properties);
   return tabOpEnhance(tab);
 }
 
-
 /**
  * {active: false, muted: true}
  * @param properties{browser.tabs._CreateCreateProperties}
@@ -121,11 +120,7 @@ export async function tabOpReload(tabId) {
  * @returns {Promise<void>}
  */
 export async function tabOpRemove(tabId) {
-  try {
     await browser.tabs.remove(tabId);
-  } catch (e) {
-    console.error(e);
-  }
 }
 
 /**
@@ -134,11 +129,7 @@ export async function tabOpRemove(tabId) {
  * @returns {Promise<void>}
  */
 export async function tabOpHide(tabId) {
-  try {
-    await browser.tabs.hide(tabId);
-  } catch (e) {
-    console.error(e);
-  }
+  await browser.tabs.hide(tabId);
 }
 
 /**

package/src/serviceCommon.js

@@ -15,7 +15,7 @@ export async function serviceDownloadByDownlink(message) {
     await browserDownloadByDownlink(message);
     await browserNotificationCreate(`downloading! ${filename}`);
   } catch (e) {
-    await browserNotificationCreate(`reason=${e}`)
+    await browserNotificationCreate(`reason=${e}`);
     await browserDownloadByDownlink({downlink});
   }
 

package/src/serviceFetch.js

@@ -1,35 +1,24 @@
-import {browserNotificationCreate} from './browserNotification.js';
-
 /**
  *
  * @param serverUrl{string}
  * @param message{{}}
- * @param handleError{function}
  * @returns {Promise<Response>}
  */
 export async function servicePostJson(
     serverUrl,
     message,
-    handleError,
 ) {
 
-  try {
-    let body = JSON.stringify(message);
-    const fetchResponse = await fetch(serverUrl, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-      body: body,
-    });
-
-    console.info('fetchResponse');
-    console.info(fetchResponse);
-    return fetchResponse;
-  } catch (e) {
-    handleError(e);
-  }
+  let body = JSON.stringify(message);
+  const fetchResponse = await fetch(serverUrl, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: body,
+  });
 
+  return fetchResponse;
 }
 
 /**
@@ -63,22 +52,14 @@ export async function serviceSendDataToLocalAria2(message) {
     params,
   };
 
-  try {
-    const response = await fetch(`http://localhost:${port}/jsonrpc`, {
-      method: 'POST',
-      headers: {
-        Accept: 'application/json',
-        'Content-Type': 'application/json;charset=UTF-8',
-      },
-      body: JSON.stringify(data),
-    });
-    console.info(`response=\n`, response);
-
-    return response;
-  } catch (e) {
-    await browserNotificationCreate(e)
-    console.error(e);
-    return null;
-  }
+  const response = await fetch(`http://localhost:${port}/jsonrpc`, {
+    method: 'POST',
+    headers: {
+      Accept: 'application/json',
+      'Content-Type': 'application/json;charset=UTF-8',
+    },
+    body: JSON.stringify(data),
+  });
 
+  return response;
 }

package/src/serviceGet.js

@@ -6,9 +6,6 @@
 export function serviceGetDomainByUrl(url) {
   let urlWrap = new URL(url);
   let domain = urlWrap.hostname;
-  console.info('serviceGetDomainByUrl()', `domain=\n`,
-      domain);
-
   return domain;
 }
 

package/src/serviceOpJavascript.js

@@ -27,7 +27,6 @@ export async function serviceTakeScreenshot(
     }) {
 
   const tag = 'actTakeScreenshot()';
-  console.info(tag, `rect=\n`, rect);
   let dataURI = await browser.tabs.captureTab(tabId, {
     rect: rect,
   });
@@ -320,11 +319,9 @@ export async function serviceDealWithMagnetLink(message) {
 
   let {title, data, handleOption} = message;
   let titleCleaned = serviceRemoveIllegalWord(title);
-  console.info(`data.length=\n`, data.length);
 
   if (Array.isArray(data) && data.length >= 1) {
     let content = `${data.join('\n')}\n`;
-    console.info(`content=\n`, content);
 
     let filename = [
       'magnet-link',

package/src/serviceUpdateTabStyle.js

@@ -21,7 +21,6 @@ export async function serviceUpdataALLTextNodeColor(message) {
      * @returns {Promise<void>}
      */
     func: async (message) => {
-      // console.log('serviceShowPanelChangeTextStyle func(message)');
       let {color} = message;
       updateStyleColor(color);
 
@@ -51,11 +50,10 @@ export async function serviceUpdataALLTextNodeColor(message) {
         }
 
         const arr = nativeTreeWalkerFindALLElementHasNodeText();
-        // console.info(arr);
 
         if (arr.length) {
           arr.forEach(value => {
-            value.style.color = color;
+            value['style'].color = color;
           });
         }
       }
@@ -88,7 +86,6 @@ export async function serviceUpdataALLNodeBackgroundColor(message) {
      * @returns {Promise<void>}
      */
     func: async (message) => {
-      // console.log('serviceShowPanelChangeTextStyle func(message)');
       let {backgroundColor} = message;
       updateStyleBackgroundColor(backgroundColor);
 
@@ -119,11 +116,10 @@ export async function serviceUpdataALLNodeBackgroundColor(message) {
          * @type {Node[]}
          */
         const arr = nativeTreeWalker();
-        // console.info(arr);
 
         if (arr.length) {
           arr.forEach(value => {
-            value.style.backgroundColor = backgroundColor;
+            value['style'].backgroundColor = backgroundColor;
           });
         }
       }

package/src/serviceUserSettings.js

@@ -6,8 +6,8 @@ import {stoOpGet, stoOpSet} from './opStorage.js';
  * @returns {Promise<void>}
  */
 export async function serviceInitUserSettings(userSettings) {
-  const initPromises = Object.entries(userSettings).
-      map(async ([key, setting]) => {
+  const initPromises = Object.entries(userSettings)
+      .map(async ([key, setting]) => {
         const oldValue = await stoOpGet(key);
 
         // FIX: Check strictly for null or undefined.