@vacantthinker/firefox-addon-framework-easy 2026.530.1431 → 2026.602.1003

package/README.md

@@ -25,7 +25,8 @@ export class BaseORM {  }
 
 ### 📄 File: `src/browserDownload.js`
 ```javascript
-export async function browserDownloadByDownlink({  }
+export async function browserDownloadByDownlink(
+    {  }
 
 ```
 
@@ -58,6 +59,14 @@ export function browserRuntimeManifestName() {  }
 
 ```
 
+### 📄 File: `src/browserTab.js`
+```javascript
+export async function browserTabCreateNearSendMessageToContentJs(message) {  }
+
+export function browserTabWaitReloadThenRemoveIt({  }
+
+```
+
 ### 📄 File: `src/generate.js`
 ```javascript
 export function generateHtmlByUserSettings(
@@ -129,17 +138,6 @@ export async function tabOpRemoveCssCode(tabId, code) {  }
 
 ### 📄 File: `src/serviceCommon.js`
 ```javascript
-export async function serviceTakeScreenshot(
-    {  }
-
-export async function serviceElementPicker(message) {  }
-
-export async function serviceGetFullPageRectData(message) {  }
-
-export async function serviceFindAllMagnetLink(message) {  }
-
-export async function serviceDealWithMagnetLink(message) {  }
-
 ```
 
 ### 📄 File: `src/serviceFetch.js`
@@ -174,6 +172,21 @@ export function serviceRemoveIllegalWord(value) {  }
 
 ```
 
+### 📄 File: `src/serviceOpJavascript.js`
+```javascript
+export async function serviceTakeScreenshot(
+    {  }
+
+export async function serviceElementPicker(message) {  }
+
+export async function serviceGetFullPageRectData(message) {  }
+
+export async function serviceFindAllMagnetLink(message) {  }
+
+export async function serviceDealWithMagnetLink(message) {  }
+
+```
+
 ### 📄 File: `src/servicePureVideolink.js`
 ```javascript
 export function servicePureVideolinkYTB(videolinkOrigin) {  }

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/browserTab.js'
 export * from './src/generate.js'
 export * from './src/opStorage.js'
 export * from './src/opTab.js'
@@ -9,6 +10,7 @@ export * from './src/serviceCommon.js'
 export * from './src/serviceFetch.js'
 export * from './src/serviceGet.js'
 export * from './src/serviceOpContent.js'
+export * from './src/serviceOpJavascript.js'
 export * from './src/servicePureVideolink.js'
 export * from './src/serviceUpdateTabStyle.js'
 export * from './src/serviceUserSettings.js'

package/package.json

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

package/src/browserDownload.js

@@ -5,7 +5,12 @@
  * @param param0.filename{string}
  * @returns {Promise<void>}
  */
-export async function browserDownloadByDownlink({ downlink, filename }) {
+export async function browserDownloadByDownlink(
+    {
+      downlink,
+      filename,
+    }) {
+
   let url = downlink;
   await browser.downloads.download({url, filename});
 }

package/src/browserTab.js

@@ -0,0 +1,60 @@
+// @ts-check
+
+import {browserNotificationCreate} from './browserNotification.js';
+import {tabOpCreateNear, tabOpRemove} from './opTab.js';
+
+async function browserTabSendMessage(tabId, message) {
+  await browser.tabs.sendMessage(tabId, message);
+}
+
+/**
+ *
+ * @param message{{
+ *      tabId:number,
+ *      title:string,
+ *      url:string,
+ *      focusNewTab:boolean,
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function browserTabCreateNearSendMessageToContentJs(message) {
+  let {title, url} = message;
+  await browserNotificationCreate(`new tab! ${title}`);
+
+  let {focusNewTab} = message;
+  let properties = {
+    url, tabId: message.tabId,
+    active: focusNewTab,
+  };
+
+  let {tabId} = await tabOpCreateNear(properties);
+  browser.tabs.onUpdated.addListener(
+      async function lis(tabId, changeInfo) {
+        if (changeInfo.status === 'complete') {
+          browser.tabs.onUpdated.removeListener(lis);
+          // todo code here
+          await browserTabSendMessage(
+              tabId, Object.assign({}, message, {tabId}));
+        }
+      }
+      , {tabId, properties: ['status']});
+
+}
+
+/**
+ *
+ * @param param0
+ * @param param0.tabId{number}
+ */
+export function browserTabWaitReloadThenRemoveIt({tabId}) {
+  browser.tabs.onUpdated.addListener(
+      async function lis(tabId, changeInfo) {
+        if (changeInfo.status === 'complete') {
+          browser.tabs.onUpdated.removeListener(lis);
+          // todo code here
+          await tabOpRemove(tabId);
+        }
+      }
+      , {tabId, properties: ['status']});
+
+}

package/src/serviceCommon.js

@@ -1,349 +0,0 @@
-import {serviceGetCurrentDateYYYYMMDDHHMMSS} from './serviceGet.js';
-import {
-  serviceCopyContentToClipboard,
-  serviceRemoveIllegalWord,
-  serviceSaveContentToLocal,
-} from './serviceOpContent.js';
-import {browserNotificationCreate} from './browserNotification.js';
-
-/**
- *
- * @param param0
- * @param param0.tabId {number}
- * @param param0.filename {string}
- * @param param0.rect {{
- *                x,
- *                y,
- *                width,
- *                height,
- * }}
- * @returns {Promise<void>}
- */
-export async function serviceTakeScreenshot(
-    {
-      tabId,
-      filename,
-      rect,
-    }) {
-
-  const tag = 'actTakeScreenshot()';
-  console.info(tag, `rect=\n`, rect);
-  let dataURI = await browser.tabs.captureTab(tabId, {
-    rect: rect,
-  });
-  let assign = Object.assign(
-      {},
-      {dataURI, filename},
-  );
-  await browser.scripting.executeScript({
-    target: {tabId},
-    args: [assign],
-    func: function(message) {
-      if (message) {
-        let {dataURI, filename} = message;
-
-        imageDataToLocalFile({dataURI, filename});
-
-        function imageDataToLocalFile({dataURI, filename}) {
-          let a = document.createElement('a');
-          a.href = dataURI;
-          a.download = filename;
-          a.click();
-        }
-
-        // todo end if(message)
-      }
-    },
-  });
-
-}
-
-/**
- * middle ware, output => {rect, uniqueSelector,}
- * @param message{{
- *      tabId:number,
- *      act:string
- * }}
- * @returns {Promise<void>}
- */
-export async function serviceElementPicker(message) {
-  let {tabId} = message;
-  await browser.scripting.executeScript({
-    target: {tabId},
-    args: [message],
-    func: async function(message) {
-      if (!message) return;
-      console.log('picker.js initialized', message);
-
-      // 1. Create a dedicated "Always On Top" highlighter overlay
-      const overlayId = 'extension-element-highlighter-overlay';
-      let overlay = document.getElementById(overlayId);
-
-      if (!overlay) {
-        overlay = document.createElement('div');
-        overlay.id = overlayId;
-        // !important and max z-index guarantees it will never be hidden by site CSS
-        overlay.style.cssText = `
-          position: fixed !important;
-          top: 0 !important;
-          left: 0 !important;
-          width: 0 !important;
-          height: 0 !important;
-          background-color: rgba(255, 0, 85, 0.2) !important;
-          outline: 2px dashed #ff0055 !important;
-          outline-offset: -2px !important;
-          z-index: 2147483647 !important;
-          pointer-events: none !important;
-          transition: all 0.05s ease-out !important;
-          display: none !important;
-        `;
-        // Appending to documentElement (<html>) avoids <body> layout restrictions
-        document.documentElement.appendChild(overlay);
-      }
-
-      function getUniqueSelector(el) {
-        if (!(el instanceof Element)) return '';
-        const path = [];
-        while (el.nodeType === Node.ELEMENT_NODE) {
-          let selector = el.nodeName.toLowerCase();
-          if (el.id) {
-            selector += '#' + el.id;
-            path.unshift(selector);
-            break;
-          }
-          else {
-            let sib = el, nth = 1;
-            while (sib = sib.previousElementSibling) {
-              if (sib.nodeName.toLowerCase() === selector) nth++;
-            }
-            if (nth !== 1) selector += `:nth-of-type(${nth})`;
-          }
-          path.unshift(selector);
-          el = el.parentNode;
-        }
-        return path.join(' > ');
-      }
-
-      function handleMouseOver(e) {
-        const target = e.target;
-
-        // Safety check to ensure we don't try to highlight our own UI
-        if (target.id === overlayId) return;
-
-        // Get exact coordinates of the hovered element
-        const clientRect = target.getBoundingClientRect();
-
-        // Move the floating overlay exactly over the target
-        overlay.style.setProperty('display', 'block', 'important');
-        overlay.style.setProperty('top', `${clientRect.top}px`, 'important');
-        overlay.style.setProperty('left', `${clientRect.left}px`, 'important');
-        overlay.style.setProperty('width', `${clientRect.width}px`,
-            'important');
-        overlay.style.setProperty('height', `${clientRect.height}px`,
-            'important');
-
-        // Change mouse cursor to indicate picking mode
-        document.body.style.setProperty('cursor', 'crosshair', 'important');
-      }
-
-      async function handleElementClick(e) {
-        e.preventDefault();
-        e.stopPropagation();
-
-        const target = e.target;
-
-        // Clean up the picker completely
-        stopPickingMode();
-
-        // Calculate screenshot coordinates
-        let clientRect = target.getBoundingClientRect();
-        let rect = {
-          height: clientRect.height,
-          width: clientRect.width,
-          x: clientRect.left + window.scrollX,
-          y: clientRect.top + window.scrollY,
-        };
-
-        // Assuming 'target' is your clicked element (e.g., from e.target)
-        let messageTakeScreenshot = Object.assign(
-            {}, // Start with a fresh, empty object
-            message, // Put the original message first so it doesn't overwrite your new data
-            {rect},
-            {
-              // The guaranteed unique CSS path (e.g., "div#wrap > ul > li:nth-of-type(2)")
-              uniqueSelector: getUniqueSelector(target),
-            },
-        );
-
-        await browser.runtime.sendMessage(messageTakeScreenshot);
-      }
-
-      function startPickingMode() {
-        document.addEventListener('mouseover', handleMouseOver, true);
-        document.addEventListener('click', handleElementClick, true);
-      }
-
-      function stopPickingMode() {
-        document.removeEventListener('mouseover', handleMouseOver, true);
-        document.removeEventListener('click', handleElementClick, true);
-
-        // Restore normal mouse cursor
-        document.body.style.removeProperty('cursor');
-
-        // Remove the overlay from the DOM entirely
-        if (overlay) {
-          overlay.remove();
-        }
-      }
-
-      // Initialize the picker mode
-      startPickingMode();
-    },
-  });
-}
-
-/**
- * middle ware, output: {rect}
- *
- * @param message{{
- *      tabId:number,
- *      act:string
- * }}
- * @returns {Promise<void>}
- */
-export async function serviceGetFullPageRectData(message) {
-  let {tabId} = message;
-
-  await browser.scripting.executeScript({
-    target: {tabId},
-    args: [message],
-    func: (message) => {
-
-      let x = 0, y = 0;
-      let width = document.documentElement.scrollWidth;
-      let height = document.documentElement.scrollHeight;
-      let rect = {
-        x, y, width, height,
-      };
-      browser.runtime.sendMessage(Object.assign(
-          {},
-          message,
-          {rect},
-      ));
-      // todo end if (message)
-    },
-  });
-}
-
-/**
- * middle ware, output: Object.assign({}, message, {data})
- *
- * serviceFindAllMagnetLink({
- *   tabId, title, act, ...
- * })
- *
- * @param message{{
- *    tabId:number,
- *    title:string,
- *    act: string,
- * }}
- */
-export async function serviceFindAllMagnetLink(message) {
-  let {tabId} = message;
-  const assign = Object.assign({}, message);
-
-  await browser.scripting.executeScript({
-    target: {tabId},
-    args: [assign],
-    func: async (message) => {
-      if (message) {
-        function findAllMagnetLinks() {
-          const magnets = new Set(); // Prevents duplicates
-
-          // --- Type 1: Find inside ANY element's attributes ---
-          const attributeSelector = '*[href*="magnet:"], *[data-url*="magnet:"], *[data-magnet*="magnet:"], *[data-href*="magnet:"]';
-          const attrElements = document.querySelectorAll(attributeSelector);
-
-          attrElements.forEach(el => {
-            // Check every attribute of the element to find the one holding the magnet string
-            for (let attr of el.attributes) {
-              if (attr.value.includes('magnet:?xt=')) {
-                magnets.add(attr.value.trim());
-              }
-            }
-          });
-
-          // --- Type 2: Find inside raw text (for <div>, <span>, <td>, etc.) ---
-          // We target elements that don't have children to avoid grabbing huge parent container blocks
-          const allElements = document.querySelectorAll(
-              'div, span, td, p, a, button');
-          allElements.forEach(el => {
-            if (el.children.length === 0) { // Deepest element
-              const text = el.textContent.trim();
-              if (text.includes('magnet:?xt=')) {
-                // Extract just the magnet link using Regex in case there is surrounding text
-                const match = text.match(/magnet:\?xt=[^\s"'<>]+/);
-                if (match) {
-                  magnets.add(match[0]);
-                }
-              }
-            }
-          });
-
-          return Array.from(magnets);
-        }
-
-        await browser.runtime.sendMessage(Object.assign(
-            {},
-            message,
-            {
-              data: findAllMagnetLinks(),
-            },
-        ));
-
-        // todo end if(message)
-      }
-    },
-  });
-}
-
-/**
- *
- * @param message{{
- *   title:string,
- *   data: [string],
- *   handleOption: 'clipboard'|'txt'|'clipboardAndTxt'
- * }}
- * @returns {Promise<void>}
- */
-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',
-      titleCleaned,
-      serviceGetCurrentDateYYYYMMDDHHMMSS()].join(' ');
-
-    if (handleOption === 'clipboard') {
-      await serviceCopyContentToClipboard(content);
-    }
-    else if (handleOption === 'txt') {
-      serviceSaveContentToLocal(content, filename);
-    }
-    else if (handleOption === 'clipboardAndTxt') {
-      await serviceCopyContentToClipboard(content);
-      serviceSaveContentToLocal(content, filename);
-    }
-  }
-  else {
-    // todo notification => magnet link not found!
-    await browserNotificationCreate('magnet link not found!');
-  }
-}

package/src/serviceOpContent.js

@@ -65,28 +65,31 @@ export async function serviceGenerateMkvToolNixScript({vid, title}) {
 }
 
 /**
- * Ultimate sanitization function: Filters all Chinese/English punctuation, full-width symbols, and illegal characters.
- * (100% prevents download errors and copy-paste character corruption)
- * @param {string} value - The original video title
- * @returns {string} - A clean, safe plaintext/alphanumeric filename
+ * 终极清理函数：过滤所有中英文标点、全角符号、以及非法/不可见字符。
+ * （100% 预防下载报错和复制粘贴导致的乱码）
+ * @param {string} value - 原始视频标题
+ * @returns {string} - 干净、安全的纯文本/字母数字文件名
  */
 export function serviceRemoveIllegalWord(value) {
   if (!value) return '';
 
-  // 1. Get the first line and trim whitespace from both ends
+  // 1. 获取第一行并去除两端空格
   let name = value.trim().split(/\r?\n/).shift();
 
-  // 2. Use Unicode properties to remove all punctuation (\p{P}) and all symbols/geometry (\p{S})
-  // This natively crushes Chinese full-width punctuation, em dashes (—), Emojis, math symbols, and special brackets.
-  // Note: The 'u' flag is mandatory to enable Unicode mode in the regex.
+  // 2. 使用 Unicode 属性移除所有危险字符：
+  // \p{P} = 所有标点符号
+  // \p{S} = 所有符号（Emoji、数学符号、货币符号）
+  // \p{C} = 所有控制/格式化/代理字符（完美修复不可见的 U+202A/U+202C 导致崩溃的 Bug！）
   name = name.replace(/[\p{P}\p{S}\p{C}]/gu, ' ');
 
-  // 3. Additional defense: Filter out hidden control characters that Firefox/OS are extremely sensitive to (0-31 and 127-159)
-  name = name.replace(/[\x00-\x1F\x7F-\x9F]/g, ' ');
+  // 3. Firefox WebExtension 严格拦截的特殊字符。
+  // （大部分已经被 \p{P} 和 \p{S} 处理，但显式移除可以确保彻底杜绝边缘报错）
+  name = name.replace(/[~"#%&*:<>?/\\{|}]/g, ' ');
 
-  // 4. Clean up Emojis and any remaining surrogate pairs
-  name = name.replace(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, ' ');
+  // 4. 将连续的空格（包括全角/Unicode空格）合并为一个标准空格
+  name = name.replace(/[\s\u3000]+/g, ' ').trim();
 
-  // 5. Merge consecutive spaces (including Chinese full-width spaces) into a single standard space
-  return name.replace(/[\s\u3000]+/g, ' ').trim();
+  // 5. Firefox 下载 API 会因为文件名以点（.）或连字符（-）开头/结尾而报错
+  // 再次修剪以确保绝对安全
+  return name.replace(/^[-.]+|[-.]+$/g, '');
 }

package/src/serviceOpJavascript.js

@@ -0,0 +1,349 @@
+import {serviceGetCurrentDateYYYYMMDDHHMMSS} from './serviceGet.js';
+import {
+  serviceCopyContentToClipboard,
+  serviceRemoveIllegalWord,
+  serviceSaveContentToLocal,
+} from './serviceOpContent.js';
+import {browserNotificationCreate} from './browserNotification.js';
+
+/**
+ *
+ * @param param0
+ * @param param0.tabId {number}
+ * @param param0.filename {string}
+ * @param param0.rect {{
+ *                x,
+ *                y,
+ *                width,
+ *                height,
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function serviceTakeScreenshot(
+    {
+      tabId,
+      filename,
+      rect,
+    }) {
+
+  const tag = 'actTakeScreenshot()';
+  console.info(tag, `rect=\n`, rect);
+  let dataURI = await browser.tabs.captureTab(tabId, {
+    rect: rect,
+  });
+  let assign = Object.assign(
+      {},
+      {dataURI, filename},
+  );
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [assign],
+    func: function(message) {
+      if (message) {
+        let {dataURI, filename} = message;
+
+        imageDataToLocalFile({dataURI, filename});
+
+        function imageDataToLocalFile({dataURI, filename}) {
+          let a = document.createElement('a');
+          a.href = dataURI;
+          a.download = filename;
+          a.click();
+        }
+
+        // todo end if(message)
+      }
+    },
+  });
+
+}
+
+/**
+ * middle ware, output => {rect, uniqueSelector,}
+ * @param message{{
+ *      tabId:number,
+ *      act:string
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function serviceElementPicker(message) {
+  let {tabId} = message;
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [message],
+    func: async function(message) {
+      if (!message) return;
+      console.log('picker.js initialized', message);
+
+      // 1. Create a dedicated "Always On Top" highlighter overlay
+      const overlayId = 'extension-element-highlighter-overlay';
+      let overlay = document.getElementById(overlayId);
+
+      if (!overlay) {
+        overlay = document.createElement('div');
+        overlay.id = overlayId;
+        // !important and max z-index guarantees it will never be hidden by site CSS
+        overlay.style.cssText = `
+          position: fixed !important;
+          top: 0 !important;
+          left: 0 !important;
+          width: 0 !important;
+          height: 0 !important;
+          background-color: rgba(255, 0, 85, 0.2) !important;
+          outline: 2px dashed #ff0055 !important;
+          outline-offset: -2px !important;
+          z-index: 2147483647 !important;
+          pointer-events: none !important;
+          transition: all 0.05s ease-out !important;
+          display: none !important;
+        `;
+        // Appending to documentElement (<html>) avoids <body> layout restrictions
+        document.documentElement.appendChild(overlay);
+      }
+
+      function getUniqueSelector(el) {
+        if (!(el instanceof Element)) return '';
+        const path = [];
+        while (el.nodeType === Node.ELEMENT_NODE) {
+          let selector = el.nodeName.toLowerCase();
+          if (el.id) {
+            selector += '#' + el.id;
+            path.unshift(selector);
+            break;
+          }
+          else {
+            let sib = el, nth = 1;
+            while (sib = sib.previousElementSibling) {
+              if (sib.nodeName.toLowerCase() === selector) nth++;
+            }
+            if (nth !== 1) selector += `:nth-of-type(${nth})`;
+          }
+          path.unshift(selector);
+          el = el.parentNode;
+        }
+        return path.join(' > ');
+      }
+
+      function handleMouseOver(e) {
+        const target = e.target;
+
+        // Safety check to ensure we don't try to highlight our own UI
+        if (target.id === overlayId) return;
+
+        // Get exact coordinates of the hovered element
+        const clientRect = target.getBoundingClientRect();
+
+        // Move the floating overlay exactly over the target
+        overlay.style.setProperty('display', 'block', 'important');
+        overlay.style.setProperty('top', `${clientRect.top}px`, 'important');
+        overlay.style.setProperty('left', `${clientRect.left}px`, 'important');
+        overlay.style.setProperty('width', `${clientRect.width}px`,
+            'important');
+        overlay.style.setProperty('height', `${clientRect.height}px`,
+            'important');
+
+        // Change mouse cursor to indicate picking mode
+        document.body.style.setProperty('cursor', 'crosshair', 'important');
+      }
+
+      async function handleElementClick(e) {
+        e.preventDefault();
+        e.stopPropagation();
+
+        const target = e.target;
+
+        // Clean up the picker completely
+        stopPickingMode();
+
+        // Calculate screenshot coordinates
+        let clientRect = target.getBoundingClientRect();
+        let rect = {
+          height: clientRect.height,
+          width: clientRect.width,
+          x: clientRect.left + window.scrollX,
+          y: clientRect.top + window.scrollY,
+        };
+
+        // Assuming 'target' is your clicked element (e.g., from e.target)
+        let messageTakeScreenshot = Object.assign(
+            {}, // Start with a fresh, empty object
+            message, // Put the original message first so it doesn't overwrite your new data
+            {rect},
+            {
+              // The guaranteed unique CSS path (e.g., "div#wrap > ul > li:nth-of-type(2)")
+              uniqueSelector: getUniqueSelector(target),
+            },
+        );
+
+        await browser.runtime.sendMessage(messageTakeScreenshot);
+      }
+
+      function startPickingMode() {
+        document.addEventListener('mouseover', handleMouseOver, true);
+        document.addEventListener('click', handleElementClick, true);
+      }
+
+      function stopPickingMode() {
+        document.removeEventListener('mouseover', handleMouseOver, true);
+        document.removeEventListener('click', handleElementClick, true);
+
+        // Restore normal mouse cursor
+        document.body.style.removeProperty('cursor');
+
+        // Remove the overlay from the DOM entirely
+        if (overlay) {
+          overlay.remove();
+        }
+      }
+
+      // Initialize the picker mode
+      startPickingMode();
+    },
+  });
+}
+
+/**
+ * middle ware, output: {rect}
+ *
+ * @param message{{
+ *      tabId:number,
+ *      act:string
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function serviceGetFullPageRectData(message) {
+  let {tabId} = message;
+
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [message],
+    func: (message) => {
+
+      let x = 0, y = 0;
+      let width = document.documentElement.scrollWidth;
+      let height = document.documentElement.scrollHeight;
+      let rect = {
+        x, y, width, height,
+      };
+      browser.runtime.sendMessage(Object.assign(
+          {},
+          message,
+          {rect},
+      ));
+      // todo end if (message)
+    },
+  });
+}
+
+/**
+ * middle ware, output: Object.assign({}, message, {data})
+ *
+ * serviceFindAllMagnetLink({
+ *   tabId, title, act, ...
+ * })
+ *
+ * @param message{{
+ *    tabId:number,
+ *    title:string,
+ *    act: string,
+ * }}
+ */
+export async function serviceFindAllMagnetLink(message) {
+  let {tabId} = message;
+  const assign = Object.assign({}, message);
+
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [assign],
+    func: async (message) => {
+      if (message) {
+        function findAllMagnetLinks() {
+          const magnets = new Set(); // Prevents duplicates
+
+          // --- Type 1: Find inside ANY element's attributes ---
+          const attributeSelector = '*[href*="magnet:"], *[data-url*="magnet:"], *[data-magnet*="magnet:"], *[data-href*="magnet:"]';
+          const attrElements = document.querySelectorAll(attributeSelector);
+
+          attrElements.forEach(el => {
+            // Check every attribute of the element to find the one holding the magnet string
+            for (let attr of el.attributes) {
+              if (attr.value.includes('magnet:?xt=')) {
+                magnets.add(attr.value.trim());
+              }
+            }
+          });
+
+          // --- Type 2: Find inside raw text (for <div>, <span>, <td>, etc.) ---
+          // We target elements that don't have children to avoid grabbing huge parent container blocks
+          const allElements = document.querySelectorAll(
+              'div, span, td, p, a, button');
+          allElements.forEach(el => {
+            if (el.children.length === 0) { // Deepest element
+              const text = el.textContent.trim();
+              if (text.includes('magnet:?xt=')) {
+                // Extract just the magnet link using Regex in case there is surrounding text
+                const match = text.match(/magnet:\?xt=[^\s"'<>]+/);
+                if (match) {
+                  magnets.add(match[0]);
+                }
+              }
+            }
+          });
+
+          return Array.from(magnets);
+        }
+
+        await browser.runtime.sendMessage(Object.assign(
+            {},
+            message,
+            {
+              data: findAllMagnetLinks(),
+            },
+        ));
+
+        // todo end if(message)
+      }
+    },
+  });
+}
+
+/**
+ *
+ * @param message{{
+ *   title:string,
+ *   data: [string],
+ *   handleOption: 'clipboard'|'txt'|'clipboardAndTxt'
+ * }}
+ * @returns {Promise<void>}
+ */
+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',
+      titleCleaned,
+      serviceGetCurrentDateYYYYMMDDHHMMSS()].join(' ');
+
+    if (handleOption === 'clipboard') {
+      await serviceCopyContentToClipboard(content);
+    }
+    else if (handleOption === 'txt') {
+      serviceSaveContentToLocal(content, filename);
+    }
+    else if (handleOption === 'clipboardAndTxt') {
+      await serviceCopyContentToClipboard(content);
+      serviceSaveContentToLocal(content, filename);
+    }
+  }
+  else {
+    // todo notification => magnet link not found!
+    await browserNotificationCreate('magnet link not found!');
+  }
+}