mazey 3.3.2 → 3.3.5

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022 Mazey Chu
+Copyright (c) 2018-2022 Mazey Chu
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -84,15 +84,95 @@ mazey.loadScript(
 
 ## API Examples
 
-There ara some usage cases maintained by hand below. For more latest information, please check the [documentation](https://i.mazey.net/mazey/docs/modules/_index_.html).
+There ara some examples maintained by hand below. For more information, please check the [full documentation](https://i.mazey.net/mazey/docs/modules/_index_.html).
+
+**Table of Contents**
+
+<ul>
+  <li><a href="#load-resource">Load Resource</a>
+    <ul>
+      <li><a href="#load-script">Load Script</a></li>
+      <li><a href="#load-css">Load CSS</a></li>
+      <li><a href="#check-load">Check Load</a></li>
+    </ul>
+  </li>
+  <li><a href="#function">Function</a>
+    <ul>
+      <li><a href="#debounce">Debounce</a></li>
+      <li><a href="#throttle">Throttle</a></li>
+      <li><a href="#check-number">Check Number</a></li>
+      <li><a href="#camel-case">Camel Case</a></li>
+      <li><a href="#trim">Trim</a></li>
+      <li><a href="#deep-clone">Deep Clone</a></li>
+      <li><a href="#json">JSON</a></li>
+      <li><a href="#random">Random</a></li>
+    </ul>
+  </li>
+  <li><a href="#dom">DOM</a>
+    <ul>
+      <li><a href="#class">Class</a></li>
+      <li><a href="#style">Style</a></li>
+      <li><a href="#newline">Newline</a></li>
+    </ul>
+  </li>
+  <li><a href="#url">URL</a>
+    <ul>
+      <li><a href="#query-param">Query Param</a></li>
+      <li><a href="#update-param">Update Param</a></li>
+      <li><a href="#hash-param">Hash Param</a></li>
+      <li><a href="#domain">Domain</a></li>
+    </ul>
+  </li>
+  <li><a href="#cache-data">Cache Data</a>
+    <ul>
+      <li><a href="#storage">Storage</a></li>
+      <li><a href="#cookie">Cookie</a></li>
+    </ul>
+  </li>
+  <li><a href="#calculate-formula">Calculate&amp;Formula</a>
+    <ul>
+      <li><a href="#rate">Rate</a></li>
+      <li><a href="#algorithm">Algorithm</a></li>
+    </ul>
+  </li>
+  <li><a href="#browser-information">Browser Information</a></li>
+  <li><a href="#web-performance">Web Performance</a></li>
+  <li><a href="#margin-of-safety">Margin of Safety</a></li>
+  <li><a href="#debug">Debug</a>
+    <ul>
+      <li><a href="#print">Print</a></li>
+    </ul>
+  </li>
+</ul>
 
 ### Load Resource
 
-#### Load CSS
+#### Load Script
 
 ```
-import { loadCSS } from 'mazey';
+loadScript(
+    'http://example.com/static/js/plugin-2.1.1.min.js',
+    {
+      id: 'iamid', // (Optional) script ID, default none
+      timeout: 5000, // (Optional) timeout, default `5000`
+      isDefer: false, // (Optional) defer, default `false`
+    }
+  )
+  .then(
+    res => {
+      console.log(`Load JavaScript script: ${res}`);
+    }
+  )
+  .catch(
+    err => {
+      console.error(`Load JavaScript script: ${err.message}`)
+    }
+  );
+```
+
+#### Load CSS
 
+```
 loadCSS(
     'http://example.com/css/mazey-base.css',
     {
@@ -116,8 +196,6 @@ loadCSS(
 Check whether the page is loaded successfully (Keepe the compatibility in case that browser's `load` event has been triggered).
 
 ```
-import { windowLoaded } from 'mazey';
-
 windowLoaded(30) // second
   .then(res => {
     console.log(`Load Success: ${res}`); // Load Success: load
@@ -126,13 +204,12 @@ windowLoaded(30) // second
     console.log(`Load Timeout or Fail: ${err.message}`);
   });
 ```
+
 ### Function
 
 #### Debounce
 
 ```
-import { debounce } from 'mazey';
-
 const foo = debounce(() => {
   console.log('The debounced function will only be invoked in 1000 milliseconds, the other invoking will disappear during the wait time.');
 }, 1000, true);
@@ -141,8 +218,6 @@ const foo = debounce(() => {
 #### Throttle
 
 ```
-import { throttle } from 'mazey';
-
 const foo = throttle(() => {
   console.log('The function will be invoked at most once per every wait 1000 milliseconds.');
 }, 1000, { leading: true });
@@ -153,8 +228,6 @@ const foo = throttle(() => {
 Check whether it is a right number.
 
 ```
-import { isNumber } from 'mazey';
-
 isNumber(123); // true
 isNumber('123'); // false
 // Default: NaN, Infinity is not Number
@@ -169,8 +242,6 @@ isNumber(NaN, { isNaNAsNumber: true, isUnFiniteAsNumber: true }); // true
 Transfer CamelCase to KebabCase.
 
 ```
-import { camelCaseToKebabCase } from 'mazey';
-
 camelCaseToKebabCase('ABC'); // a-b-c
 camelCaseToKebabCase('aBC'); // a-b-c
 ```
@@ -178,8 +249,6 @@ camelCaseToKebabCase('aBC'); // a-b-c
 Transfer CamelCase to Underscore.
 
 ```
-import { camelCase2Underscore } from 'mazey';
-
 camelCase2Underscore('ABC'); // a_b_c
 camelCase2Underscore('aBC'); // a_b_c
 ```
@@ -189,8 +258,6 @@ camelCase2Underscore('aBC'); // a_b_c
 Remove leading and trailing whitespace or specified characters from string.
 
 ```
-import { mTrim } from 'mazey';
-
 mTrim(' 1 2 3 '); // '1 2 3'
 mTrim('abc '); // 'abc'
 ```
@@ -200,8 +267,6 @@ mTrim('abc '); // 'abc'
 Clone Object deeply.
 
 ```
-import { deepCopyObject } from 'mazey';
-
 deepCopyObject(['a', 'b', 'c']); // ['a', 'b', 'c']
 deepCopyObject('abc'); // 'abc'
 ```
@@ -211,8 +276,6 @@ deepCopyObject('abc'); // 'abc'
 Check whether it is a valid JSON string.
 
 ```
-import { isJsonString } from 'mazey';
-
 isJsonString(`['a', 'b', 'c']`); // false
 isJsonString(`["a", "b", "c"]`); // true
 ```
@@ -222,8 +285,6 @@ isJsonString(`["a", "b", "c"]`); // true
 Produce a random string of number, `generateRndNum(7)` => '7658495'.
 
 ```
-import { generateRndNum } from 'mazey';
-
 generateRndNum(4); // '9730'
 generateRndNum(7); // '2262490'
 ```
@@ -235,8 +296,6 @@ generateRndNum(7); // '2262490'
 Modify `class`.
 
 ```
-import { hasClass, addClass, removeClass } from 'mazey';
-
 const dom = document.querySelector('#box');
 
 // Determine `class`
@@ -254,8 +313,6 @@ Add `<style>` in `<head>`.
 Case 1: Add the `<style>` with `id`, and repeated invoking will update the content instead of adding a new one.
 
 ```
-import { addStyle } from 'mazey';
-
 addStyle(
   `
     body {
@@ -276,8 +333,6 @@ addStyle(
 Case 2: Add the `<style>` without `id`, and repeated invoking will adding a new one.
 
 ```
-import { addStyle } from 'mazey';
-
 addStyle(
   `
     body {
@@ -297,8 +352,6 @@ addStyle(
 Make a newline of HTML.
 
 ```
-import { newLine } from 'mazey';
-
 newLine('a\nb\nc'); // 'a<br />b<br />c'
 newLine('a\n\nbc'); // 'a<br /><br />bc'
 ```
@@ -310,8 +363,6 @@ newLine('a\n\nbc'); // 'a<br /><br />bc'
 Get the query param's value of the current Web URL(`location.search`).
 
 ```
-import { getQueryParam } from 'mazey';
-
 // http://example.com/?t1=1&t2=2&t3=3&t4=4#2333
 // ?t1=1&t2=2&t3=3&t4=4
 getQueryParam('t3'); // 3
@@ -321,8 +372,6 @@ getQueryParam('t4'); // 4
 Get the query param's value of the input URL.
 
 ```
-import { getUrlParam } from 'mazey';
-
 getUrlParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't3'); // 3
 getUrlParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't4'); // 4
 ```
@@ -332,8 +381,6 @@ getUrlParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't4'); // 4
 Update the query param's value of the input URL.
 
 ```
-import { updateQueryParam } from 'mazey';
-
 updateQueryParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't3', 'three'); // http://example.com/?t1=1&t2=2&t3=three&t4=4
 updateQueryParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't4', 'four'); // http://example.com/?t1=1&t2=2&t3=3&t4=four
 ```
@@ -343,8 +390,6 @@ updateQueryParam('http://example.com/?t1=1&t2=2&t3=3&t4=4', 't4', 'four'); // ht
 Get the hash query param's value of the current Web URL(`location.hash`).
 
 ```
-import { getHashQueryParam } from 'mazey';
-
 // http://example.com/?#2333?t1=1&t2=2&t3=3&t4=4
 // #2333?t1=1&t2=2&t3=3&t4=4
 getHashQueryParam('t3'); // 3
@@ -356,8 +401,6 @@ getHashQueryParam('t4'); // 4
 Get the domain of URL, and other params.
 
 ```
-import { getDomain } from 'mazey';
-
 getDomain('http://example.com/?t1=1&t2=2&t3=3&t4=4'); // example.com
 getDomain('http://example.com/test/thanks?t1=1&t2=2&t3=3&t4=4', ['hostname', 'pathname']); // example.com/test/thanks
 ```
@@ -369,8 +412,6 @@ getDomain('http://example.com/test/thanks?t1=1&t2=2&t3=3&t4=4', ['hostname', 'pa
 Handle Storage (Keep fit for JSON, it can tansfer format automatically).
 
 ```
-import { setSessionStorage, getSessionStorage, setLocalStorage, getLocalStorage } from 'mazey';
-
 setSessionStorage('test', '123');
 getSessionStorage('test'); // 123
 setLocalStorage('test', '123');
@@ -392,8 +433,6 @@ function mGetLocalStorage (key) {
 Handle Cookie.
 
 ```
-import { setCookie, getCookie } from 'mazey';
-
 setCookie('test', '123', 30, 'example.com'); // key value day domain
 getCookie('test'); // 123
 ```
@@ -405,8 +444,6 @@ getCookie('test'); // 123
 Hit probability (1% ~ 100%).
 
 ```
-import { inRate } from 'mazey';
-
 inRate(0.5); // 0.01 ~ 1 true / false
 
 // Test
@@ -427,24 +464,18 @@ console.log(trueCount, falseCount); // 499994 500006
 Computes the longest common substring of two strings.
 
 ```
-import { calLongestCommonSubstring } from 'mazey';
-
 calLongestCommonSubstring('fish', 'finish'); // 3
 ```
 
 Computes the longest common subsequence of two strings.
 
 ```
-import { calLongestCommonSubsequence } from 'mazey';
-
 calLongestCommonSubsequence('fish', 'finish'); // 4
 ```
 
 ### Browser Information
 
 ```
-import { getBrowserInfo } from 'mazey';
-
 getBrowserInfo(); // {"engine":"webkit","engineVs":"537.36","platform":"desktop","supporter":"chrome","supporterVs":"85.0.4183.121","system":"windows","systemVs":"10"}
 // Shell and shell version { shell: 'wechat', shellVs: '20' } shell: wechat qq uc 360 2345 sougou liebao maxthon
 ```
@@ -467,8 +498,6 @@ getBrowserInfo(); // {"engine":"webkit","engineVs":"537.36","platform":"desktop"
 Get page load time(PerformanceTiming).
 
 ```
-import { getPerformance } from 'mazey';
-
 // `camelCase：true`(Default) Return hump data.
 // `camelCase：false` Return underline data.
 getPerformance(true)
@@ -498,8 +527,6 @@ getPerformance(true)
 Determine if it is a secure PWA environment that it can run.
 
 ```
-import { isSafePWAEnv } from 'mazey';
-
 isSafePWAEnv(); // true
 ```
 
@@ -510,8 +537,6 @@ isSafePWAEnv(); // true
 Custom console printing (`console`).
 
 ```
-import { genCustomConsole } from 'mazey';
-
 const myConsole = genCustomConsole('MazeyLog:');
 myConsole.log('I am string.'); // MazeyLog: I am string.
 myConsole.info('I am boolean.', true); // MazeyLog: I am boolean. true
@@ -519,18 +544,25 @@ myConsole.info('I am number.', 123, 456); // MazeyLog: I am number. 123 456
 myConsole.info('I am object.', { a: 123, b: 456}); // MazeyLog: I am object. {a: 123, b: 456}
 ```
 
-## Develop
+## Contributing
 
 ```
-# dev
-npm run dev;
+# Install
+npm i --registry=https://registry.npmjs.org
 
-# build
-npm run build;
+# Serve
+npm run dev
 
-# documentation
-npm run docs;
+# Build
+npm run build
 
-# test
-npm run test;
+# Document
+npm run docs
+
+# Test
+npm run test
 ```
+
+## License
+
+This software is released under the terms of the [MIT license](https://github.com/mazeyqian/mazey/blob/master/LICENSE).

package/README_CN.md

@@ -3,7 +3,7 @@
 [![NPM version][npm-image]][npm-url]
 [![l][l-image]][l-url]
 
-[npm-image]: https://i.mazey.net/asset/npm/mazey-v1.4.39.svg
+[npm-image]: ./images/mazey-v1.4.39.svg
 [npm-url]: https://www.npmjs.com/package/mazey/v/1.4.39
 [l-image]: https://img.shields.io/npm/l/mazey
 [l-url]: https://github.com/mazeyqian/mazey

package/images/mazey-v1.4.39.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="88" height="20" role="img" aria-label="npm: v1.4.39"><title>npm: v1.4.39</title><linearGradient id="s" x2="0" y2="100%"><stop offset="0" stop-color="#bbb" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><clipPath id="r"><rect width="88" height="20" rx="3" fill="#fff"/></clipPath><g clip-path="url(#r)"><rect width="35" height="20" fill="#555"/><rect x="35" width="53" height="20" fill="#007ec6"/><rect width="88" height="20" fill="url(#s)"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text aria-hidden="true" x="185" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="250">npm</text><text x="185" y="140" transform="scale(.1)" fill="#fff" textLength="250">npm</text><text aria-hidden="true" x="605" y="150" fill="#010101" fill-opacity=".3" transform="scale(.1)" textLength="430">v1.4.39</text><text x="605" y="140" transform="scale(.1)" fill="#fff" textLength="430">v1.4.39</text></g></svg>