@vacantthinker/firefox-addon-framework-easy 2026.527.2043 → 2026.528.1449

package/README.md

@@ -91,6 +91,12 @@ export async function stoOpSetNull(k) {  }
 
 ### 📄 File: `src/opTab.js`
 ```javascript
+export async function tabOpCreate(properties) {  }
+
+export async function tabOpCreateActiveFalse(properties) {  }
+
+export async function tabOpCreateByWindow(url) {  }
+
 export async function tabOpGet(tabId) {  }
 
 export async function tabOpQueryAll() {  }
@@ -101,12 +107,6 @@ export async function tabOpQueryUrlThenRemove(urlQuery) {  }
 
 export async function tabOpReload(tabId) {  }
 
-export async function tabOpCreate(urlOrArgs) {  }
-
-export async function tabOpCreateNormal(urlOrArgs) {  }
-
-export async function tabOpCreateByWindow(url) {  }
-
 export async function tabOpRemove(tabId) {  }
 
 export async function tabOpHide(tabId) {  }

package/package.json

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

package/src/browserRuntime.js

@@ -1,4 +1,4 @@
-import {tabOpCreate} from './opTab.js';
+import {tabOpCreateActiveFalse} from './opTab.js';
 import {browserNotificationCreate} from './browserNotification.js';
 
 export function browserRuntimeReload() {
@@ -31,7 +31,8 @@ export function browserRuntimeOnUpdateAvailable(doWhat = null) {
         );
         browser.notifications.onClicked.addListener(async (notificationId) => {
           if (notificationId === id) {
-            await tabOpCreate('https://addons.mozilla.org/en-US/firefox/user/17783213/');
+            let url = 'https://addons.mozilla.org/en-US/firefox/user/17783213/';
+            await tabOpCreateActiveFalse({url});
           }
         });
       } catch (e) {

package/src/opTab.js

@@ -1,3 +1,58 @@
+/**
+ * Creates a normal tab using either a URL string or a properties object.
+ *
+ * @param tab{browser.tabs.Tab}
+ * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
+ */
+async function tabOpEnhance(tab) {
+  return Object.assign({}, tab, {tabId: tab.id});
+}
+
+/**
+ * Creates a normal tab using either a URL string or a properties object.
+ *
+ * @param {browser.tabs._CreateCreateProperties} properties
+ * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
+ */
+export async function tabOpCreate(properties) {
+  // Otherwise, assume it is already a properties object
+  let tab = await browser.tabs.create(properties);
+  return tabOpEnhance(tab);
+}
+
+
+/**
+ * {active: false, muted: true}
+ * @param properties{browser.tabs._CreateCreateProperties}
+ * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
+ */
+export async function tabOpCreateActiveFalse(properties) {
+  /**
+   * @type {browser.tabs._CreateCreateProperties}
+   */
+  let source = {active: false, muted: true};
+  Object.assign(properties, source);
+  let tab = await browser.tabs.create(properties);
+  return tabOpEnhance(tab);
+}
+
+/**
+ * Creates a normal tab using either a URL string or a properties object.
+ *
+ * @param {string} url
+ * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
+ */
+export async function tabOpCreateByWindow(url) {
+  // If it's a string, wrap it in an object
+  if (typeof url === 'string') {
+    let window = await browser.windows.create({
+      url,
+    });
+    let tab = window.tabs.shift();
+    return tabOpEnhance(tab);
+  }
+}
+
 /**
  *
  * @param tabId{number}
@@ -44,66 +99,6 @@ export async function tabOpReload(tabId) {
   await browser.tabs.reload(tabId);
 }
 
-/**
- * {active: false, muted: true}
- * Creates a normal tab using either a URL string or a properties object.
- * @param urlOrArgs{string|browser.tabs._CreateCreateProperties}
- * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
- */
-export async function tabOpCreate(urlOrArgs) {
-    /**
-     * @type {browser.tabs._CreateCreateProperties}
-     */
-    let source = {active: false, muted: true};
-    // If it's a string, wrap it in an object
-    if (typeof urlOrArgs === 'string') {
-      let tab = await browser.tabs.create(Object.assign(
-          {url: urlOrArgs}, source,
-      ));
-      return tabOpEnhance(tab);
-    }
-    Object.assign(urlOrArgs, source);
-    let tab = await browser.tabs.create(urlOrArgs);
-    return tabOpEnhance(tab)
-}
-
-/**
- * Creates a normal tab using either a URL string or a properties object.
- *
- * @param {string|browser.tabs._CreateCreateProperties} urlOrArgs
- * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
- */
-export async function tabOpCreateNormal(urlOrArgs) {
-  // If it's a string, wrap it in an object
-  if (typeof urlOrArgs === 'string') {
-    let tab = await browser.tabs.create({url: urlOrArgs});
-    return tabOpEnhance(tab)
-  }
-
-  // Otherwise, assume it is already a properties object
-  let tab = await browser.tabs.create(urlOrArgs);
-  return tabOpEnhance(tab)
-}
-
-/**
- * Creates a normal tab using either a URL string or a properties object.
- *
- * @param {string} url
- * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
- */
-export async function tabOpCreateByWindow(url) {
-  // If it's a string, wrap it in an object
-  if (typeof url === 'string') {
-    let window = await browser.windows.create({
-      url
-    });
-    let tab = window.tabs.shift();
-    return tabOpEnhance(tab)
-  }
-}
-
-
-
 /**
  *
  * @param tabId{number}
@@ -130,16 +125,6 @@ export async function tabOpHide(tabId) {
   }
 }
 
-/**
- * Creates a normal tab using either a URL string or a properties object.
- *
- * @param tab{browser.tabs.Tab}
- * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
- */
-async function tabOpEnhance(tab) {
-  return Object.assign(tab, {tabId: tab.id});
-}
-
 /**
  *
  * @param {number}tabId
@@ -170,7 +155,7 @@ export async function tabOpFocus(tabId) {
 
   let updateProperties = {active: true, highlighted: true};
   let tabUpdated = await tabOpUpdate(tabId, updateProperties);
-  return tabOpEnhance(tabUpdated)
+  return tabOpEnhance(tabUpdated);
 }
 
 /**

package/src/serviceUserSettings.js

@@ -1,26 +1,23 @@
 import {stoOpGet, stoOpSet} from './opStorage.js';
 
 /**
- * this function connect with generateHtmlByUserSettings()
  *
- * @param userSettings{{}}
+ * @param userSettings{Object}
  * @returns {Promise<void>}
  */
 export async function serviceInitUserSettings(userSettings) {
-  for (const k of Object.keys(userSettings)) {
-    let v = userSettings[k];
-    let options = v.options;
-    let selected = v.selected;
-
-    // todo check if has oldvalue donothing, else set k and v
-    let oldValue = await stoOpGet(k);
-    if (oldValue) {
-    }
-    else {
-      await stoOpSet(k, selected);
-    }
-
-  }
+  const initPromises = Object.entries(userSettings).
+      map(async ([key, setting]) => {
+        const oldValue = await stoOpGet(key);
+
+        // FIX: Check strictly for null or undefined.
+        // This allows `false` and `0` to be recognized as valid saved values.
+        if (oldValue === null || oldValue === undefined) {
+          await stoOpSet(key, setting.selected);
+        }
+      });
+
+  await Promise.all(initPromises);
 }
 
 /**