browser-extension-utils 0.1.9 → 0.1.10

package/lib/index.d.ts

@@ -111,7 +111,7 @@ export function noStyleSpace(text: string): string
 
 export function createSetStyle(styleText: string): SetStyle
 
-export function isUrl(text: string): boolean
+export function isUrl(text: string | undefined): boolean
 
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function throttle(func: Function, interval: number): Function
@@ -138,6 +138,9 @@ export function getOffsetPosition(
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function runOnce(key: string, func: Function): any
 
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function runWhenHeadExists(func: Function): void
+
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function runWhenBodyExists(func: Function): void
 

package/lib/index.js

@@ -348,14 +348,63 @@ export const parseInt10 = (number, defaultValue) => {
   return Number.isNaN(result) ? defaultValue : result
 }
 
+const headFuncArray = []
+const bodyFuncArray = []
+let headBodyObserver
+
+const startObserveHeadBodyExists = () => {
+  if (headBodyObserver) {
+    return
+  }
+
+  headBodyObserver = new MutationObserver(() => {
+    if (doc.head && doc.body) {
+      headBodyObserver.disconnect()
+    }
+
+    if (doc.head && headFuncArray.length > 0) {
+      for (const func of headFuncArray) {
+        func()
+      }
+
+      headFuncArray.length = 0
+    }
+
+    if (doc.body && bodyFuncArray.length > 0) {
+      for (const func of bodyFuncArray) {
+        func()
+      }
+
+      bodyFuncArray.length = 0
+    }
+  })
+
+  headBodyObserver.observe(doc, {
+    childList: true,
+    subtree: true,
+  })
+}
+
 /**
- * Run function when document.body exsits. The function may be executed before DOMContentLoaded.
+ * Run function when document.head exsits.
+ */
+export const runWhenHeadExists = (func) => {
+  if (!doc.head) {
+    headFuncArray.push(func)
+    startObserveHeadBodyExists()
+    return
+  }
+
+  func()
+}
+
+/**
+ * Run function when document.body exsits. The function executed before DOMContentLoaded.
  */
 export const runWhenBodyExists = (func) => {
   if (!doc.body) {
-    setTimeout(() => {
-      runWhenBodyExists(func)
-    }, 10)
+    bodyFuncArray.push(func)
+    startObserveHeadBodyExists()
     return
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-extension-utils",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Utilities for developing browser extensions and userscripts",
   "type": "module",
   "main": "./lib/index.js",
@@ -48,6 +48,7 @@
       "GM_addElement",
       "GM_addStyle",
       "GM_registerMenuCommand",
+      "MutationObserver",
       "history",
       "window",
       "top",