browser-extension-utils 0.1.16 → 0.1.18

package/lib/index.d.ts

@@ -140,12 +140,18 @@ export function getOffsetPosition(
 // eslint-disable-next-line @typescript-eslint/ban-types
 export async function runOnce(key: string, func: Function): Promise<any>
 
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function runWhenRootExists(func: Function): void
+
 // 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
 
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function runWhenDomReady(func: Function): void
+
 export async function sleep(time: number): Promise<void>
 
 export type Cache = {

package/lib/index.js

@@ -372,6 +372,7 @@ export const parseInt10 = (number, defaultValue) => {
   return Number.isNaN(result) ? defaultValue : result
 }
 
+const rootFuncArray = []
 const headFuncArray = []
 const bodyFuncArray = []
 let headBodyObserver
@@ -386,6 +387,14 @@ const startObserveHeadBodyExists = () => {
       headBodyObserver.disconnect()
     }
 
+    if (doc.documentElement && rootFuncArray.length > 0) {
+      for (const func of rootFuncArray) {
+        func()
+      }
+
+      rootFuncArray.length = 0
+    }
+
     if (doc.head && headFuncArray.length > 0) {
       for (const func of headFuncArray) {
         func()
@@ -409,6 +418,19 @@ const startObserveHeadBodyExists = () => {
   })
 }
 
+/**
+ * Run function when document.documentElement exsits.
+ */
+export const runWhenRootExists = (func) => {
+  if (!doc.documentElement) {
+    rootFuncArray.push(func)
+    startObserveHeadBodyExists()
+    return
+  }
+
+  func()
+}
+
 /**
  * Run function when document.head exsits.
  */
@@ -435,6 +457,24 @@ export const runWhenBodyExists = (func) => {
   func()
 }
 
+/**
+ * Equals to jQuery.domready
+ */
+export const runWhenDomReady = (func) => {
+  if (doc.readyState === "interactive" || doc.readyState === "complete") {
+    return func()
+  }
+
+  const handler = () => {
+    if (doc.readyState === "interactive" || doc.readyState === "complete") {
+      func()
+      removeEventListener(doc, "readystatechange", handler)
+    }
+  }
+
+  addEventListener(doc, "readystatechange", handler)
+}
+
 export const isVisible = (element) => {
   if (typeof element.checkVisibility === "function") {
     return element.checkVisibility()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-extension-utils",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Utilities for developing browser extensions and userscripts",
   "type": "module",
   "main": "./lib/index.js",
@@ -29,8 +29,8 @@
   },
   "homepage": "https://github.com/utags/browser-extension-utils#readme",
   "devDependencies": {
-    "prettier": "^2.8.8",
-    "xo": "^0.55.0"
+    "prettier": "^3.0.2",
+    "xo": "^0.56.0"
   },
   "files": [
     "lib/",