tools-for-js 1.5.4 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 ### 项目名称
 
-> tools-for-js —— Javascript 工具库
+> tools-for-js —— JavaScript 前端工具库
 
 ### 安装
 
@@ -14,7 +14,7 @@ npm install tools-for-js --save
 import { API } from 'tools-for-js'
 ```
 
-### API
+### JS API
 
 | 名称                                             | API               |
 | ------------------------------------------------ | ----------------- |
@@ -71,3 +71,38 @@ import { API } from 'tools-for-js'
 | 验证运动账号                                     | checkSports       |
 | 判断是否为 json 字符串                           | isJSONString      |
 | 待更新                                           | function          |
+
+### WEB 相关 API
+
+| 名称                       | API              |
+| -------------------------- | ---------------- |
+| store2:localStorage 缓存   | local            |
+| store2:sessionStorage 缓存 | session          |
+| 设置有效期信息             | setExpires       |
+| 获取有效期信息             | getExpires       |
+| 移除有效期信息             | removeExpires    |
+| 获取 cookie                | getCookie        |
+| 获取所有 cookie            | getCookies       |
+| 设置 cookie                | setCookie        |
+| 删除指定 cookie            | removeCookie     |
+| 删除所有 cookie            | removeCookies    |
+| 将 txt 的 blob 转文本内容  | blobToText       |
+| 下载流文件                 | downloadStream   |
+| 图片转 base64              | getBase64        |
+| 浏览器内核                 | kernelInfo       |
+| 移动端/PC 端               | isMobile         |
+| 是否 android 终端          | isAndroid        |
+| 是否 ios 终端              | isIOS            |
+| 是否微信环境               | isWeiXn          |
+| 是否 QQ 环境               | isQQ             |
+| 是否钉钉环境               | isDingTalk       |
+| 是否微博环境               | isWeiBo          |
+| 获取哈希路由参数           | getHashParam     |
+| 获取路由参数               | getQueryParams   |
+| 获取当前路径               | getPath          |
+| 清除.html 后缀             | wrapperCleanUrls |
+| 获取移动端转换比例         | getScale         |
+| 移动端自适应尺寸转换       | sizeConvert      |
+| 创建 script 标签加载 js    | createScript     |
+| 清除.html 后缀             | wrapperCleanUrls |
+| 复制文本                   | copyText         |

package/lib/index.js

@@ -1,5 +1,6 @@
 "use strict";
 
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -27,6 +28,12 @@ Object.defineProperty(exports, "arrayToTree", {
     return _array.arrayToTree;
   }
 });
+Object.defineProperty(exports, "blobToText", {
+  enumerable: true,
+  get: function get() {
+    return _files.blobToText;
+  }
+});
 Object.defineProperty(exports, "checkCode", {
   enumerable: true,
   get: function get() {
@@ -75,6 +82,12 @@ Object.defineProperty(exports, "convertSmallHump", {
     return _transform.convertSmallHump;
   }
 });
+Object.defineProperty(exports, "copyText", {
+  enumerable: true,
+  get: function get() {
+    return _core.copyText;
+  }
+});
 Object.defineProperty(exports, "countDown", {
   enumerable: true,
   get: function get() {
@@ -93,6 +106,12 @@ Object.defineProperty(exports, "createDate", {
     return _time.createDate;
   }
 });
+Object.defineProperty(exports, "createScript", {
+  enumerable: true,
+  get: function get() {
+    return _core.createScript;
+  }
+});
 Object.defineProperty(exports, "createUUID", {
   enumerable: true,
   get: function get() {
@@ -123,6 +142,12 @@ Object.defineProperty(exports, "deepCopy", {
     return _common.deepCopy;
   }
 });
+Object.defineProperty(exports, "downloadStream", {
+  enumerable: true,
+  get: function get() {
+    return _files.downloadStream;
+  }
+});
 Object.defineProperty(exports, "encrypt", {
   enumerable: true,
   get: function get() {
@@ -153,18 +178,66 @@ Object.defineProperty(exports, "getAfterNDays", {
     return _time.getAfterNDays;
   }
 });
+Object.defineProperty(exports, "getBase64", {
+  enumerable: true,
+  get: function get() {
+    return _files.getBase64;
+  }
+});
+Object.defineProperty(exports, "getCookie", {
+  enumerable: true,
+  get: function get() {
+    return _store.getCookie;
+  }
+});
+Object.defineProperty(exports, "getCookies", {
+  enumerable: true,
+  get: function get() {
+    return _store.getCookies;
+  }
+});
+Object.defineProperty(exports, "getExpires", {
+  enumerable: true,
+  get: function get() {
+    return _store.getExpires;
+  }
+});
 Object.defineProperty(exports, "getExpiresEndTime", {
   enumerable: true,
   get: function get() {
     return _time.getExpiresEndTime;
   }
 });
+Object.defineProperty(exports, "getHashParam", {
+  enumerable: true,
+  get: function get() {
+    return _route.getHashParam;
+  }
+});
 Object.defineProperty(exports, "getPagination", {
   enumerable: true,
   get: function get() {
     return _array.getPagination;
   }
 });
+Object.defineProperty(exports, "getPath", {
+  enumerable: true,
+  get: function get() {
+    return _route.getPath;
+  }
+});
+Object.defineProperty(exports, "getQueryParams", {
+  enumerable: true,
+  get: function get() {
+    return _route.getQueryParams;
+  }
+});
+Object.defineProperty(exports, "getScale", {
+  enumerable: true,
+  get: function get() {
+    return _mobile.getScale;
+  }
+});
 Object.defineProperty(exports, "getStrLength", {
   enumerable: true,
   get: function get() {
@@ -195,6 +268,18 @@ Object.defineProperty(exports, "invertSelection", {
     return _array.invertSelection;
   }
 });
+Object.defineProperty(exports, "isAndroid", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isAndroid;
+  }
+});
+Object.defineProperty(exports, "isDingTalk", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isDingTalk;
+  }
+});
 Object.defineProperty(exports, "isEmpty", {
   enumerable: true,
   get: function get() {
@@ -213,18 +298,60 @@ Object.defineProperty(exports, "isExpires", {
     return _time.isExpires;
   }
 });
+Object.defineProperty(exports, "isIOS", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isIOS;
+  }
+});
 Object.defineProperty(exports, "isJsonString", {
   enumerable: true,
   get: function get() {
     return _object.isJsonString;
   }
 });
+Object.defineProperty(exports, "isMobile", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isMobile;
+  }
+});
+Object.defineProperty(exports, "isQQ", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isQQ;
+  }
+});
+Object.defineProperty(exports, "isWeiBo", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isWeiBo;
+  }
+});
+Object.defineProperty(exports, "isWeiXn", {
+  enumerable: true,
+  get: function get() {
+    return _browser.isWeiXn;
+  }
+});
 Object.defineProperty(exports, "jsonParse", {
   enumerable: true,
   get: function get() {
     return _object.jsonParse;
   }
 });
+Object.defineProperty(exports, "kernelInfo", {
+  enumerable: true,
+  get: function get() {
+    return _browser.kernelInfo;
+  }
+});
+Object.defineProperty(exports, "local", {
+  enumerable: true,
+  get: function get() {
+    return _store.local;
+  }
+});
 Object.defineProperty(exports, "lowercaseKeys", {
   enumerable: true,
   get: function get() {
@@ -297,18 +424,60 @@ Object.defineProperty(exports, "randomNumEnum", {
     return _random.randomNumEnum;
   }
 });
+Object.defineProperty(exports, "removeCookie", {
+  enumerable: true,
+  get: function get() {
+    return _store.removeCookie;
+  }
+});
+Object.defineProperty(exports, "removeCookies", {
+  enumerable: true,
+  get: function get() {
+    return _store.removeCookies;
+  }
+});
+Object.defineProperty(exports, "removeExpires", {
+  enumerable: true,
+  get: function get() {
+    return _store.removeExpires;
+  }
+});
 Object.defineProperty(exports, "replacePath", {
   enumerable: true,
   get: function get() {
     return _string.replacePath;
   }
 });
+Object.defineProperty(exports, "session", {
+  enumerable: true,
+  get: function get() {
+    return _store.session;
+  }
+});
+Object.defineProperty(exports, "setCookie", {
+  enumerable: true,
+  get: function get() {
+    return _store.setCookie;
+  }
+});
+Object.defineProperty(exports, "setExpires", {
+  enumerable: true,
+  get: function get() {
+    return _store.setExpires;
+  }
+});
 Object.defineProperty(exports, "shuffleArray", {
   enumerable: true,
   get: function get() {
     return _array.shuffleArray;
   }
 });
+Object.defineProperty(exports, "sizeConvert", {
+  enumerable: true,
+  get: function get() {
+    return _mobile.sizeConvert;
+  }
+});
 Object.defineProperty(exports, "sortByKeyAndTime", {
   enumerable: true,
   get: function get() {
@@ -327,6 +496,12 @@ Object.defineProperty(exports, "splitToFileName", {
     return _string.splitToFileName;
   }
 });
+Object.defineProperty(exports, "store", {
+  enumerable: true,
+  get: function get() {
+    return _store["default"];
+  }
+});
 Object.defineProperty(exports, "summation", {
   enumerable: true,
   get: function get() {
@@ -369,6 +544,12 @@ Object.defineProperty(exports, "upperCaseKeys", {
     return _transform.upperCaseKeys;
   }
 });
+Object.defineProperty(exports, "wrapperCleanUrls", {
+  enumerable: true,
+  get: function get() {
+    return _route.wrapperCleanUrls;
+  }
+});
 var _transform = require("./utils/transform");
 var _time = require("./utils/time");
 var _array = require("./utils/array");
@@ -377,4 +558,12 @@ var _common = require("./utils/common");
 var _string = require("./utils/string");
 var _random = require("./utils/random");
 var _object = require("./utils/object");
-var _regexp = require("./utils/regexp");
+var _regexp = require("./utils/regexp");
+var _files = require("./web/files");
+var _store = _interopRequireWildcard(require("./web/store"));
+var _browser = require("./web/browser");
+var _route = require("./web/route");
+var _mobile = require("./web/mobile");
+var _core = require("./web/core");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }

package/lib/utils/string.js

@@ -140,7 +140,7 @@ var decrypt = exports.decrypt = function decrypt(input, key) {
   }
   return output[1] || '';
 };
-console.log('测试:', decrypt('', 'www.kimshift.cn'));
+
 /*******
  * @description: 校验加密字符
  * @author: 琴时
@@ -314,9 +314,10 @@ var fromCode = exports.fromCode = function fromCode(params) {
     arr[i] = b1 * len * len + b2 * len + b3; //利用索引值，反推被加密字符的Unicode编码值
   }
   // 将数组转换成字符串连接起来
-  var str1 = arr.join(',');
+  // let str1 = arr.join(',')
   //用fromCharCode()算出字符串
-  result = eval('String.fromCharCode(' + str1 + ')');
+  // result = eval('String.fromCharCode(' + str1 + ')')
+  result = String.fromCharCode.apply(String, arr);
   return result; //返回被解密的字符串
 };
 

package/lib/web/browser.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.kernelInfo = exports.isWeiXn = exports.isWeiBo = exports.isQQ = exports.isMobile = exports.isIOS = exports.isDingTalk = exports.isAndroid = void 0;
+/*******
+ * @description: 浏览器信息
+ * @author: 琴时
+ */
+var ua = '';
+if (typeof window !== 'undefined') {
+  ua = navigator.userAgent; // 获取设备信息
+}
+
+/*******
+ * @description: 浏览器内核
+ * @author: 琴时
+ * @return {Object} 返回内核信息
+ */
+var kernelInfo = exports.kernelInfo = {
+  trident: ua.indexOf('Trident') > -1,
+  //IE内核
+  presto: ua.indexOf('Presto') > -1,
+  //opera内核
+  webKit: ua.indexOf('AppleWebKit') > -1,
+  //苹果、谷歌内核
+  gecko: ua.indexOf('Gecko') > -1 && ua.indexOf('KHTML') == -1 //火狐内核
+};
+
+/*******
+ * @description: 检测移动端/PC端
+ * [移动端:true - PC端:false]
+ */
+var isMobile = exports.isMobile = Boolean(ua.match(/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i));
+
+/*******
+ * @description: android终端
+ */
+var isAndroid = exports.isAndroid = ua.indexOf('Android') > -1 || ua.indexOf('Adr') > -1;
+
+/*******
+ * @description: ios终端
+ */
+var isIOS = exports.isIOS = Boolean(ua.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/));
+
+/*******
+ * @description: 微信环境
+ */
+var isWeiXn = exports.isWeiXn = ua.toLowerCase().includes('micromessenger');
+
+/*******
+ * @description: QQ环境
+ */
+var isQQ = exports.isQQ = ua.toLowerCase().includes('qqbrowser');
+
+/*******
+ * @description: 钉钉环境
+ */
+var isDingTalk = exports.isDingTalk = ua.toLowerCase().includes('dingtalk');
+
+/*******
+ * @description: 微博环境
+ */
+var isWeiBo = exports.isWeiBo = ua.toLowerCase().includes('weibo');

package/lib/web/core.js

@@ -0,0 +1,65 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.copyText = copyText;
+exports.createScript = void 0;
+/*******
+ * @description: 创建script标签加载js
+ * @author: 琴时
+ * @param {String} url
+ * @return {*}
+ */
+var createScript = exports.createScript = function createScript() {
+  var url = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  if (typeof window === 'undefined') return;
+  var scriptTags = window.document.querySelectorAll('script');
+  var len = scriptTags.length;
+  var i = 0;
+  // 截取字符串,去掉可能url是相对路径的
+  url = url.indexOf('.') === 0 ? url.substr(1) : url;
+  var _url = location.origin + url;
+  return new Promise(function (resolve, reject) {
+    var isHas = false;
+    for (i = 0; i < len; i++) {
+      var src = scriptTags[i].src;
+      if (src && src === _url) {
+        isHas = true;
+        resolve();
+      }
+    }
+    if (!isHas) {
+      var node = document.createElement('script');
+      node.type = 'text/javascript';
+      node.src = url;
+      node.onload = resolve;
+      document.body.appendChild(node);
+    }
+  });
+};
+
+/*******
+ * @description: 复制文本
+ * @author: 琴时
+ * @param {String} text
+ * @return {*}
+ */
+function copyText(text) {
+  if (typeof window === 'undefined') return;
+  if (navigator.clipboard) {
+    exports.copyText = copyText = function copyText(text) {
+      navigator.clipboard.writeText(text);
+    };
+  } else {
+    exports.copyText = copyText = function copyText(text) {
+      var input = document.createElement('input');
+      input.setAttribute('value', text);
+      document.body.appendChild(input);
+      input.select();
+      document.execCommand('copy');
+      document.body.removeChild(input);
+    };
+  }
+  copyText(text);
+}

package/lib/web/files.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getBase64 = exports.downloadStream = exports.blobToText = void 0;
+/*******
+ * @description: 将txt的blob转文本内容
+ * @author: 琴时
+ * @param {*} blob
+ * @return {*}
+ */
+var blobToText = exports.blobToText = function blobToText(blob) {
+  return new Promise(function (resolve, reject) {
+    if (typeof FileReader === 'undefined') {
+      reject(new Error('浏览器不支持FileReader对象'));
+      return;
+    }
+    var reader = new FileReader();
+    reader.onload = function () {
+      resolve(reader.result);
+    };
+    reader.onerror = function () {
+      reject(new Error('无法读取Blob对象'));
+    };
+    if (blob.constructor !== File) {
+      reject(new Error('该数据不是blob'));
+      return;
+    }
+    reader.readAsText(blob);
+  });
+};
+
+/*******
+ * @description: 下载流文件
+ * @author: 琴时
+ * @param {*} stream 文件流
+ * @param {String} fileName 文件名
+ * @return {*}
+ */
+var downloadStream = exports.downloadStream = function downloadStream(stream, fileName) {
+  try {
+    if (typeof window === 'undefined') return;
+    var fileTypeMime = {
+      png: 'image/png',
+      jpeg: 'image/jpeg',
+      gif: 'image/gif',
+      svg: 'image/svg+xml',
+      tiff: 'image/tiff',
+      doc: 'application/msword',
+      docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+      txt: 'text/plain',
+      pdf: 'application/pdf',
+      mp4: 'video/mp4',
+      mp3: 'audio/mpeg',
+      rar: 'application/x-rar-compressed',
+      html: 'text/html',
+      xml: 'text/xml',
+      json: 'application/json',
+      css: 'text/css',
+      js: 'text/javascript',
+      ppt: 'application/vnd.ms-powerpoint',
+      pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+      csv: 'text/csv',
+      xls: 'application/vnd.ms-excel',
+      xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+      zip: 'application/zip',
+      '7z': 'application/x-7z-compressed'
+    };
+    var suffix = fileName.slice(fileName.indexOf('.') + 1); //获取文件后缀
+    var blob = new Blob([stream], {
+      type: fileTypeMime[suffix]
+    }); //创建blob对象
+    var aLink = document.createElement('a'); //创建a标签
+    document.body.appendChild(aLink); //末尾添加新的子节点
+    aLink.style.display = 'none'; //将a标签隐藏
+    var blobURL = URL.createObjectURL(blob); //将blob转换成URL
+    aLink.href = aLink.download = fileName; //配置下载文件名
+    aLink.click(); //自动触发点击a标签[下载文件]
+    document.body.removeChild(aLink); //移除a标签
+    URL.revokeObjectURL(blobURL); // 释放blob URL地址
+  } catch (error) {
+    console.log('下载异常:', error.message);
+  }
+};
+
+/*******
+ * @description: 图片转base64
+ * @author: 琴时
+ * @param {File} fil
+ * @return {*}
+ */
+var getBase64 = exports.getBase64 = function getBase64(file) {
+  return new Promise(function (resolve, reject) {
+    if (typeof FileReader === 'undefined') {
+      reject(new Error('浏览器不支持FileReader对象'));
+      return;
+    }
+    var reader = new FileReader();
+    reader.readAsDataURL(file);
+    reader.onload = function () {
+      return resolve(reader.result);
+    };
+    reader.onerror = function (error) {
+      return reject(error);
+    };
+  });
+};

package/lib/web/mobile.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sizeConvert = exports.getScale = void 0;
+var _calculate = require("../utils/calculate");
+/*******
+ * @description: 获取移动端转换比例
+ * @return {*}
+ */
+var getScale = exports.getScale = function getScale() {
+  var size = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 75;
+  if (typeof window === 'undefined') return 1;
+  var htmlElement = document.documentElement;
+  var fontSize = window.getComputedStyle(htmlElement).fontSize;
+  var scale = (0, _calculate.countNumber)(parseFloat(fontSize), size, 'divide');
+  return scale;
+};
+
+/*******
+ * @description: 移动端自适应尺寸转换
+ * @return {*}
+ */
+var sizeConvert = exports.sizeConvert = function sizeConvert(number, fontSize) {
+  var scale = getScale(fontSize);
+  var value = (0, _calculate.countNumber)(number, scale, 'multiply');
+  return value;
+};

package/lib/web/route.js

@@ -0,0 +1,80 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getHashParam = void 0;
+exports.getPath = getPath;
+exports.getQueryParams = void 0;
+exports.wrapperCleanUrls = wrapperCleanUrls;
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/*******
+ * @description: 获取哈希路由参数
+ * @author: 琴时
+ * @param {String} key
+ * @return {*}
+ */
+var getHashParam = exports.getHashParam = function getHashParam(key) {
+  if (typeof window === 'undefined') return null;
+  var reg = new RegExp('(^|&)' + key + '=([^&]*)(&|$)');
+  // 只有当在浏览器环境中时才执行下面的代码
+  var queryString = window.location.href.split('?')[1] || '';
+  var result = queryString.match(reg);
+  return result ? decodeURIComponent(result[2]) : null;
+};
+
+/*******
+ * @description: 获取路由参数
+ * @author: 琴时
+ * @return {*}
+ */
+var getQueryParams = exports.getQueryParams = function getQueryParams() {
+  if (typeof window === 'undefined') return null;
+  var queryString = window.location.href.split('?')[1] || '';
+  if (!queryString) return null;
+  var params = {};
+  queryString.split('&').forEach(function (param) {
+    var _param$split = param.split('='),
+      _param$split2 = _slicedToArray(_param$split, 2),
+      key = _param$split2[0],
+      value = _param$split2[1];
+    params[decodeURIComponent(key)] = decodeURIComponent(value);
+  });
+  return params;
+};
+
+// 获取当前路径
+function getPath() {
+  if (typeof window === 'undefined') return [];
+  var pathname = window.location.pathname;
+  var currentPath = pathname.replace(/.html$/, '');
+  // 兼容中文路径
+  var okPaths = [currentPath, decodeURIComponent(currentPath)];
+  // 兼容 /(index.md)
+  if (currentPath.endsWith('/')) {
+    okPaths.push.apply(okPaths, ["".concat(currentPath, "index"), "".concat(decodeURIComponent(currentPath), "index")]);
+  }
+  return _toConsumableArray(new Set(okPaths));
+}
+
+/*******
+ * @description: 清除.html后缀
+ * @author: 琴时
+ * @param {Boolean} cleanUrls [是否清除]
+ * @param {String} path
+ * @return {String}
+ */
+function wrapperCleanUrls(cleanUrls) {
+  var path = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  var tempUrl = path.replace(/\.html$/, '');
+  return cleanUrls ? tempUrl : "".concat(tempUrl, ".html");
+}

package/lib/web/store.js

@@ -0,0 +1,150 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setExpires = exports.setCookie = exports.session = exports.removeExpires = exports.removeCookies = exports.removeCookie = exports.local = exports.getExpires = exports.getCookies = exports.getCookie = exports["default"] = void 0;
+var _store = _interopRequireDefault(require("store2"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; } /*******
+ * @description: 缓存工具
+ * @author: 琴时
+ */
+var _default = exports["default"] = _store["default"];
+/*******
+ * @description: localStorage缓存
+ * get:获取缓存|set:设置缓存|remove:删除缓存
+ */
+var local = exports.local = _store["default"].local;
+local.getItem = local.get;
+local.setItem = local.set;
+local.removeItem = local.remove;
+/*******
+ * @description: sessionStorage缓存
+ * get:获取缓存|set:设置缓存|remove:删除缓存
+ */
+
+var session = exports.session = _store["default"].session;
+session.getItem = session.get;
+session.setItem = session.set;
+session.removeItem = session.remove;
+/*******
+ * @description: 设置有效期信息
+ * @author: 琴时
+ * @param {Number} value [到期时间，单位毫秒] [默认30分钟]
+ */
+var setExpires = exports.setExpires = function setExpires() {
+  var value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 30 * 60 * 1000;
+  session.set('user_last_time', +new Date()); //最后一次设置缓存时间
+  session.set('user_expires', value); //设置到期时间，单位毫秒
+};
+
+/*******
+ * @description: 获取有效期信息
+ * @author: 琴时
+ * @return {Boolean} true:未过期 false:已过期
+ */
+var getExpires = exports.getExpires = function getExpires() {
+  var lastTime = session.get('user_last_time'); //最后登录时间
+  var expires = session.get('user_expires'); //过期时间
+  if (!lastTime || !expires) return false; //无记录==>过期
+  var nowTime = +new Date(); // 当前时间戳
+  var times = nowTime - (lastTime + expires); // 剩余时间总毫秒数
+  return times < 0;
+};
+
+/*******
+ * @description: 移除有效期信息
+ * @author: 琴时
+ */
+var removeExpires = exports.removeExpires = function removeExpires() {
+  session.remove('user_last_time');
+  session.remove('user_expires');
+};
+
+/*******
+ * @description: 获取cookie
+ * @author: 琴时
+ * @param {String} key
+ * @return {String}
+ */
+var getCookie = exports.getCookie = function getCookie(key) {
+  if (typeof document === 'undefined') return '';
+  var name = key + '=';
+  var ca = document.cookie.split(';');
+  for (var i = 0; i < ca.length; i++) {
+    var c = ca[i].trim();
+    if (c.indexOf(name) === 0) {
+      return c.substring(name.length, c.length);
+    }
+  }
+  return '';
+};
+
+/*******
+ * @description: 获取所有cookie
+ * @author: 琴时
+ * @return {Array}
+ */
+var getCookies = exports.getCookies = function getCookies() {
+  var cookies = [];
+  if (typeof document === 'undefined') return cookies;
+  if (document.cookie.length === 0) return cookies;
+  var array = document.cookie.split('; '); //通过分号连空格将字符串切割成数组
+  cookies = array.map(function (item) {
+    var _item$split = item.split('='),
+      _item$split2 = _slicedToArray(_item$split, 2),
+      key = _item$split2[0],
+      value = _item$split2[1]; // 通过=再次切割
+    return {
+      key: key,
+      value: value
+    };
+  });
+  return cookies;
+};
+
+/*******
+ * @description: 设置cookie
+ * @author: 琴时
+ * @param {String} key   [键名]
+ * @param {String} value [键值]
+ * @param {Number} day   [有效期/天] | 不传默认当前会话有效
+ * @return {*}
+ */
+var setCookie = exports.setCookie = function setCookie(key, value, day) {
+  var cookie = key + '=' + value + '; path=/';
+  if (day != undefined) {
+    var d = new Date();
+    d.setTime(d.getTime() + day * 24 * 60 * 60 * 1000);
+    var expires = '; expires=' + d.toGMTString();
+    cookie += expires;
+  }
+  if (typeof document === 'undefined') return;
+  document.cookie = cookie;
+};
+
+/*******
+ * @description: 删除指定cookie
+ * @author: 琴时
+ * @param {*} key [指定cookies的键]
+ * @return {*}
+ */
+var removeCookie = exports.removeCookie = function removeCookie(key) {
+  setCookie(key, '', -1); // 将生命周期改为-1
+};
+/*******
+ * @description:删除所有cookie
+ * @author: 琴时
+ * @return {*}
+ */
+var removeCookies = exports.removeCookies = function removeCookies() {
+  getCookies().forEach(function (cookie) {
+    setCookie(cookie.key, '', -1); //将生命周期改为-1==>使其失效
+  });
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tools-for-js",
-  "version": "1.5.4",
-  "description": "基于babel构建的javascript工具库",
+  "version": "2.0.0",
+  "description": "基于babel构建的JavaScript前端工具库",
   "main": "lib/index.js",
   "scripts": {
     "start": "nodemon",
@@ -16,8 +16,9 @@
     "url": "https://github.com/kimshift/tools-for-js/issues"
   },
   "keywords": [
-    "JavaScript",
-    "tools"
+    "web",
+    "tools",
+    "JavaScript"
   ],
   "author": "kimshift",
   "license": "ISC",
@@ -33,7 +34,8 @@
     "nodemon": "^3.1.0"
   },
   "dependencies": {
-    "dayjs": "^1.11.11"
+    "dayjs": "^1.11.11",
+    "store2": "^2.14.3"
   },
   "volta": {
     "node": "20.12.2"