mazey 1.4.25 → 1.4.29

package/README.md

@@ -62,6 +62,20 @@ loadCSS({
   );
 ```
 
+判断页面是否加载完成（兼容浏览器 `load` 事件已经触发过的情况）
+
+```
+import { loadCSS } from 'mazey';
+
+windowLoaded({ timeout: 30 })
+  .then(res => {
+    console.log(`加载完成：${res}`); // 加载完成：load
+  })
+  .catch(err => {
+    console.log(`加载超时或失败：${err}`);
+  });
+```
+
 ### 存储数据
 
 Storage
@@ -190,6 +204,18 @@ import { isSafePWAEnv } from 'mazey';
 isSafePWAEnv(); // true
 ```
 
+### 函数
+
+防抖
+
+```
+import { debounce } from 'mazey';
+
+const foo = debounce(() => {
+  console.log('执行 1 秒内再次执行无反应');
+}, 1000, { leading: true })
+```
+
 [更多接口>>](https://mazey.cn/docs/mazey/modules/_index_.html)
 
 ## Develop

package/lib/index.cjs.js

@@ -3901,6 +3901,7 @@ function loadCSS(_a) {
  * @param {String} id -- DOM ID
  * @param {Function} callback -- 加载后回调函数
  * @param {Number} timeout -- 超时时长
+ * @param {Boolean} isDefer -- 是否添加 defer 标签
  * @return {Promise<Boolean>} -- true 成功
  */
 
@@ -3913,7 +3914,9 @@ function loadScript(_a) {
       _e = _b.callback,
       callback = _e === void 0 ? function () {} : _e,
       _f = _b.timeout,
-      timeout = _f === void 0 ? 5000 : _f;
+      timeout = _f === void 0 ? 5000 : _f,
+      _g = _b.isDefer,
+      isDefer = _g === void 0 ? false : _g;
 
   var success = null;
   var fail = null;
@@ -3922,6 +3925,10 @@ function loadScript(_a) {
   var firstScript = document.getElementsByTagName('script')[0];
   script.type = 'text/javascript';
 
+  if (isDefer) {
+    script.defer = 'defer';
+  }
+
   if (id) {
     script.id = id;
   }
@@ -4590,6 +4597,44 @@ function cutCHSString(str, len, hasDot) {
     return newStr;
   }
 }
+/**
+ * @method windowLoaded
+ * @description 页面加载完成
+ * @param {number} timeout 超时时间 / 单位：秒
+ * @return {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
+*/
+
+function windowLoaded(_a) {
+  var _b = (_a === void 0 ? {} : _a).timeout,
+      timeout = _b === void 0 ? 90 : _b;
+
+  var loaded = function loaded() {
+    return undefined;
+  };
+
+  var loadFail = function loadFail() {
+    return undefined;
+  };
+
+  var status = new Promise(function (resolve, reject) {
+    loaded = resolve;
+    loadFail = reject;
+  });
+
+  if (document.readyState === 'complete') {
+    loaded('complete');
+  } else {
+    window.addEventListener('load', function () {
+      return loaded('load');
+    });
+  } // 超过 timeout 秒后加载失败
+
+
+  setTimeout(function () {
+    return loadFail('timeout');
+  }, timeout * 1000);
+  return status;
+}
 
 exports.addClass = addClass;
 exports.calLongestCommonSubsequence = calLongestCommonSubsequence;
@@ -4637,3 +4682,4 @@ exports.setSessionStorage = setSessionStorage;
 exports.throttle = throttle;
 exports.trim = trim$1;
 exports.updateQueryStringParameter = updateQueryStringParameter;
+exports.windowLoaded = windowLoaded;

package/lib/index.d.ts

@@ -238,14 +238,16 @@ export declare function loadCSS({ url, id }?: {
  * @param {String} id -- DOM ID
  * @param {Function} callback -- 加载后回调函数
  * @param {Number} timeout -- 超时时长
+ * @param {Boolean} isDefer -- 是否添加 defer 标签
  * @return {Promise<Boolean>} -- true 成功
  */
-export declare function loadScript({ url, id, callback, timeout }?: {
+export declare function loadScript({ url, id, callback, timeout, isDefer }?: {
     url?: string | undefined;
     id?: string | undefined;
     callback?: (() => void) | undefined;
     timeout?: number | undefined;
-}): Promise<unknown>;
+    isDefer?: boolean | undefined;
+}): any;
 /**
  * @method mNow
  * @description 获取时间戳
@@ -305,4 +307,13 @@ export declare function clearHtml(string?: string): string;
  * @returns {String} 返回截取后的字符串
  */
 export declare function cutCHSString(str?: string, len?: number, hasDot?: boolean): string;
+/**
+ * @method windowLoaded
+ * @description 页面加载完成
+ * @param {number} timeout 超时时间 / 单位：秒
+ * @return {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
+*/
+export declare function windowLoaded({ timeout }?: {
+    timeout?: number | undefined;
+}): Promise<string>;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"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"}

package/lib/index.esm.js

@@ -3897,6 +3897,7 @@ function loadCSS(_a) {
  * @param {String} id -- DOM ID
  * @param {Function} callback -- 加载后回调函数
  * @param {Number} timeout -- 超时时长
+ * @param {Boolean} isDefer -- 是否添加 defer 标签
  * @return {Promise<Boolean>} -- true 成功
  */
 
@@ -3909,7 +3910,9 @@ function loadScript(_a) {
       _e = _b.callback,
       callback = _e === void 0 ? function () {} : _e,
       _f = _b.timeout,
-      timeout = _f === void 0 ? 5000 : _f;
+      timeout = _f === void 0 ? 5000 : _f,
+      _g = _b.isDefer,
+      isDefer = _g === void 0 ? false : _g;
 
   var success = null;
   var fail = null;
@@ -3918,6 +3921,10 @@ function loadScript(_a) {
   var firstScript = document.getElementsByTagName('script')[0];
   script.type = 'text/javascript';
 
+  if (isDefer) {
+    script.defer = 'defer';
+  }
+
   if (id) {
     script.id = id;
   }
@@ -4586,5 +4593,43 @@ function cutCHSString(str, len, hasDot) {
     return newStr;
   }
 }
+/**
+ * @method windowLoaded
+ * @description 页面加载完成
+ * @param {number} timeout 超时时间 / 单位：秒
+ * @return {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
+*/
+
+function windowLoaded(_a) {
+  var _b = (_a === void 0 ? {} : _a).timeout,
+      timeout = _b === void 0 ? 90 : _b;
+
+  var loaded = function loaded() {
+    return undefined;
+  };
+
+  var loadFail = function loadFail() {
+    return undefined;
+  };
+
+  var status = new Promise(function (resolve, reject) {
+    loaded = resolve;
+    loadFail = reject;
+  });
+
+  if (document.readyState === 'complete') {
+    loaded('complete');
+  } else {
+    window.addEventListener('load', function () {
+      return loaded('load');
+    });
+  } // 超过 timeout 秒后加载失败
+
+
+  setTimeout(function () {
+    return loadFail('timeout');
+  }, timeout * 1000);
+  return status;
+}
 
-export { addClass, calLongestCommonSubsequence, calLongestCommonSubstring, camelCase2Underscore, camelCaseToKebabCase, cancelBubble, clearHtml, compatibleExist, cutCHSString, debounce, deepCopyObject, doFn, floatFixed, floatToPercent, friendlyInterval, generateRndNum, generateUniqueNum, getBrowserType, getCookie, getDomain, getHashQueryParam, getLocalStorage, getPerformance, getQueryParam, getSearchQueryParam, getSessionStorage, getUrlParam, hasClass, inRate, isJsonString, isNumber, isSafePWAEnv, join, loadCSS, loadScript, mNow, newLine, removeClass, renderTable, resetForm, setCookie, setLocalStorage, setSessionStorage, throttle, trim$1 as trim, updateQueryStringParameter };
+export { addClass, calLongestCommonSubsequence, calLongestCommonSubstring, camelCase2Underscore, camelCaseToKebabCase, cancelBubble, clearHtml, compatibleExist, cutCHSString, debounce, deepCopyObject, doFn, floatFixed, floatToPercent, friendlyInterval, generateRndNum, generateUniqueNum, getBrowserType, getCookie, getDomain, getHashQueryParam, getLocalStorage, getPerformance, getQueryParam, getSearchQueryParam, getSessionStorage, getUrlParam, hasClass, inRate, isJsonString, isNumber, isSafePWAEnv, join, loadCSS, loadScript, mNow, newLine, removeClass, renderTable, resetForm, setCookie, setLocalStorage, setSessionStorage, throttle, trim$1 as trim, updateQueryStringParameter, windowLoaded };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mazey",
-  "version": "1.4.25",
+  "version": "1.4.29",
   "description": "Mazey's library for front end.",
   "main": "lib/index.cjs.js",
   "module": "lib/index.esm.js",
@@ -13,7 +13,7 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "dev": "webpack-dev-server --open",
     "build": "npx rollup -c",
-    "doc": "npx jsdoc -c ./jsdoc.config.json -d ./doc",
+    "[已废弃]doc": "npx jsdoc -c ./jsdoc.config.json -d ./doc",
     "docs": "npx typedoc --out docs/ src/",
     "release": "npm run build && npm publish",
     "lint-and-fix": "eslint ./src/index.ts --ext 'ts,tsx' --fix"

package/src/index.ts

@@ -747,15 +747,19 @@ export function loadCSS({ url = '', id = '' } = {}) {
  * @param {String} id -- DOM ID
  * @param {Function} callback -- 加载后回调函数
  * @param {Number} timeout -- 超时时长
+ * @param {Boolean} isDefer -- 是否添加 defer 标签
  * @return {Promise<Boolean>} -- true 成功
  */
-export function loadScript({ url = '', id = '', callback = function () { /* pass */ }, timeout = 5000 } = {}) {
+export function loadScript({ url = '', id = '', callback = function () { /* pass */ }, timeout = 5000, isDefer = false } = {}): any {
   let success: any = null;
   let fail: any = null;
   const script: any = document.createElement('script');
   // 如果没有 script 标签，那么代码就不会运行。可以利用这一事实，在页面的第一个 script 标签上使用 insertBefore()。
   const firstScript: any = document.getElementsByTagName('script')[0];
   script.type = 'text/javascript';
+  if (isDefer) {
+    script.defer = 'defer';
+  }
   if (id) {
     script.id = id;
   }
@@ -1326,3 +1330,26 @@ export function cutCHSString(str = '', len = str.length, hasDot = false): string
     return newStr;
   }
 }
+
+/**
+ * @method windowLoaded
+ * @description 页面加载完成
+ * @param {number} timeout 超时时间 / 单位：秒
+ * @return {Promise<string>} document is loaded? 'complete' 'load' / 'timeout'
+*/
+export function windowLoaded({ timeout = 90 } = {}): Promise<string> {
+  let loaded: (value: string) => void = () => undefined;
+  let loadFail: (value: string) => void = () => undefined;
+  const status = new Promise((resolve: (value: string) => void, reject: (value: string) => void) => {
+      loaded = resolve;
+      loadFail = reject;
+  });
+  if (document.readyState === 'complete') {
+      loaded('complete');
+  } else {
+      window.addEventListener('load', () => loaded('load'));
+  }
+  // 超过 timeout 秒后加载失败
+  setTimeout(() => loadFail('timeout'), timeout * 1000);
+  return status;
+}

package/src/test.ts

@@ -10,6 +10,8 @@ import {
   loadScript,
   isSafePWAEnv,
   getBrowserType,
+  debounce,
+  windowLoaded,
   // getPerformance,
  } from './index';
 
@@ -23,12 +25,31 @@ import {
 // console.log(getUrlParam(url, 'bsource'))
 // console.log(getUrlParam(url, 'topic'))
 
-// loadScript({
-//   url: 'https://www.bilibili.com/bangumi/play/ss28296?bsource=douban&topic=blog.mazey.net',
-//   id: 'abbb',
-// })
+loadScript({
+  url: 'https://www.bilibili.com/bangumi/play/ss28296?bsource=douban&topic=blog.mazey.net',
+  id: 'abbb',
+  isDefer: true,
+});
 
 console.log('isSafePWAEnv', isSafePWAEnv());
 console.log('getBrowserType', JSON.stringify(getBrowserType()));
 console.log('getPerformance', getPerformance());
-getPerformance().then(console.log);
+getPerformance().then(console.log);
+
+const foo = debounce(() => {
+  console.log('执行 1 秒内再次执行无反应');
+}, 1000, { leading: true });
+
+foo();
+
+setTimeout(foo, 500);
+
+setTimeout(foo, 2500);
+
+windowLoaded({ timeout: 30 })
+  .then(res => {
+    console.log(`加载完成：${res}`);
+  })
+  .catch(err => {
+    console.log(`加载超时：${err}`);
+  });

package/.eslintrc

@@ -1,15 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",
-  "plugins": [
-    "@typescript-eslint"
-  ],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/eslint-recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "rules": {
-    "semi": ["error", "always"]
-  }
-}