nhanh-pure-function 1.0.0

package/lib/Index.js

@@ -0,0 +1,5 @@
+import * as Utility from "./Utility.js";
+import * as User from "./User.js";
+
+const _PureFunction = { Utility, User };
+export default _PureFunction;

package/lib/User.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 添加滚动触底事件
+ * @param {滚动标签} element
+ * @param {触底事件} callback
+ */
+export function _AddScrollBottomListener(element: HTMLElement, callback: Function): void;
+
+/**
+ * 自动处理 currentPage * pageSize > total
+ * @param ask 请求方法
+ * @param config 请求参数
+ */
+export function _PagingQuery<Ask extends Function>(
+  ask: Ask,
+  config: {
+    currentPage: number;
+    pageSize: number;
+    [key: string]: any;
+  }
+): ReturnType<Ask> & { currentPage?: number };
+
+/**
+ * 纯数字转  数字加单位
+ * @param number 数字或字符串数字
+ * @param config : {
+ *    join 拼接起来吗
+ *    suffix 后缀
+ *    integer 不超过万位的数字时保持整数吗
+ * }
+ * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
+ */
+export function _FormatNumberWithUnit(
+  number: string | number,
+  config?: {
+    join?: boolean;
+    suffix?: string;
+    integer?: boolean;
+  }
+): string | [number, string];
+
+/**
+ * 设置量词属性
+ * @param {*} data 需修改对象
+ * @param {*} options 配置
+ * @returns data
+ */
+export function _SetQuantifierAttribute<T>(
+  data: T,
+  options?: (
+    | keyof T
+    | [
+        keyof T,
+        {
+          join?: boolean;
+          suffix?: string;
+          integer?: boolean;
+        }
+      ]
+  )[]
+): T;
+
+/**
+ * 为属性值为null | undefined的属性设置默认值
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetDefaultValue<T>(
+  data: T,
+  options: {
+    defaultValue?: string;
+    fieldsNotRequiringAction?: (string | number | symbol)[];
+  } = {}
+): T;
+
+/**
+ * 将字典value转为对应label
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetDictionary<T>(
+  data: T,
+  options: {
+    dictionaryOptions?: { [key in keyof T]: { [key: string | number]: any } };
+    dictionaryLabel?: (keyof T)[];
+    dictionaryLabelJoin?: (keyof T)[];
+    defaultValue?: string;
+  }
+): T;
+
+/**
+ * 将字符串拼接的图片地址转为数组
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetPhoto<T>(
+  data: T,
+  options: {
+    label?: (keyof T)[];
+    defaultUrl?: {
+      [key in keyof T]: string[];
+    };
+  }
+): T;
+
+/**
+ * 将接口返回的数据进行处理，得到展示数据
+ * @param data object 类型的数据
+ * @param options 配置
+ * @returns exhibit_data
+ */
+export function _Exhibit_details<T>(
+  data: T,
+  options: {
+    dictionaryOptions?: { [key in keyof T]: { [key: string | number]: any } };
+    dictionaryLabel?: (keyof T)[];
+    dictionaryLabelJoin?: (keyof T)[];
+
+    photoLabel?: (keyof T)[];
+    photoDefaultUrl?: {
+      [key in keyof T]: string[];
+    };
+
+    quantifierLabel?: (
+      | keyof T
+      | [
+          keyof T,
+          {
+            join?: boolean;
+            suffix?: string;
+            integer?: boolean;
+          }
+        ]
+    )[];
+
+    filterLabel?: (keyof T)[];
+
+    defaultValue?: string;
+  } = {}
+): T;
+
+// 定义加载状态更新函数类型
+type LoadingStateUpdater = (newState: boolean) => void;
+// 定义加载控制器的类型
+interface LoadingController {
+  invokers: Set<any>; // 假设invoker可以是任何类型
+  timer: NodeJS.Timeout | null;
+  startTime: number;
+  loadingState: LoadingStateUpdater;
+  delayTime: number;
+  minDisplayTime: number;
+}
+/** 多组loading控制器 */
+export class _LoadingController {
+  #controllersCollection: Map<string, LoadingController>;
+
+  constructor() {}
+
+  // addController方法的类型定义
+  addController(
+    key?: string,
+    config: {
+      loadingState: LoadingStateUpdater;
+      delayTime?: number;
+      minDisplayTime?: number;
+    }
+  ): void;
+
+  // deleteController方法的类型定义
+  deleteController(key: string): void;
+
+  // getController方法的类型定义
+  getController(key?: string): LoadingController;
+
+  // resetController方法的类型定义
+  resetController(key: string): void;
+
+  // startLoading方法的类型定义
+  startLoading(invoker: any, key?: string): void;
+
+  // stopLoading方法的类型定义
+  stopLoading(invoker: any, key?: string): void;
+}

package/lib/User.js

@@ -0,0 +1,387 @@
+import { _IsObject, _IsWithinErrorMargin, _NotNull } from './Utility';
+
+/**
+ * 添加滚动触底事件
+ * @param {滚动标签} element
+ * @param {触底事件} callback
+ */
+export function _AddScrollBottomListener(element, callback) {
+  element.addEventListener('scroll', function () {
+    if (_IsWithinErrorMargin(element.scrollTop + element.clientHeight, element.scrollHeight, 2)) {
+      callback();
+    }
+  });
+}
+
+/**
+ * 自动处理 currentPage * pageSize > total
+ * @param ask 请求方法
+ * @param config 请求参数
+ */
+export function _PagingQuery(ask, config) {
+  return new Promise(function (resolve, reject) {
+    ask(config)
+      .then((data) => {
+        const { rows, total } = data;
+        if (rows.length == 0 && total > 0) {
+          config.currentPage = Math.ceil(total / config.pageSize);
+          ask(config)
+            .then((data) => {
+              data.currentPage = config.currentPage;
+              resolve(data);
+            })
+            .catch(reject);
+        } else {
+          resolve(data);
+        }
+      })
+      .catch(reject);
+  });
+}
+
+/**
+ * 纯数字转  数字加单位
+ * @param number 数字或字符串数字
+ * @param config : {
+ *    join 拼接起来吗
+ *    suffix 后缀
+ *    integer 不超过万位的数字时保持整数吗
+ * }
+ * @returns 123456  -->  12.34万 | [ 12.34 , 万 ]
+ */
+export function _FormatNumberWithUnit(number, config = {}) {
+  const { join, suffix, integer } = Object.assign(
+    {
+      join: true,
+      suffix: '',
+      integer: false
+    },
+    config
+  );
+
+  function _join(value, suffix, plus = true) {
+    value = (plus ? '' : '-') + value;
+    if (join) return value + suffix;
+    else return [value, suffix];
+  }
+
+  if (typeof number == 'string') {
+    if (!/^\d+$/.test(number.trim())) {
+      console.error('错误输入：', number);
+      return _join(0, suffix);
+    }
+  } else if (typeof number != 'number') {
+    console.error('错误输入：', number);
+    return _join(0, suffix);
+  }
+
+  if (Math.abs(number) == Infinity || number == 0) {
+    return _join(0, suffix);
+  }
+
+  number = Number(number);
+  const plus = number >= 0;
+  number = Math.abs(number);
+
+  const units = ['', '万', '亿', '兆', '京', '垓', '秭', '穰', '沟', '涧', '正', '载', '极'];
+  const digits = Math.floor(Math.log10(number) / 4); // 计算位数
+
+  // 不超过万位的数字直接返回
+  if (digits === 0) {
+    if (integer) {
+      return _join(number, suffix, plus);
+    } else {
+      return _join(number.toFixed(2), suffix, plus);
+    }
+  }
+
+  const dividedNumber = number / Math.pow(10000, digits);
+  const formattedNumber = dividedNumber.toFixed(2);
+
+  return _join(formattedNumber, units[digits] + suffix, plus);
+}
+
+/**
+ * 设置量词属性
+ * @param {*} data 需修改对象
+ * @param {*} options 配置
+ * @returns data
+ */
+export function _SetQuantifierAttribute(data, options = []) {
+  if (!_IsObject(data)) {
+    console.error('异常输入：', data);
+    return data;
+  }
+
+  options.forEach((item) => {
+    if (typeof item === 'string') {
+      data[item] = _FormatNumberWithUnit(data[item]);
+    } else if (Array.isArray(item)) {
+      const [label, config] = data[item];
+      if (_NotNull(label) && _IsObject(config)) data[label] = _FormatNumberWithUnit(label, config);
+    }
+  });
+  return data;
+}
+
+/**
+ * 为属性值为null | undefined的属性设置默认值
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetDefaultValue(data, options = {}) {
+  if (!_IsObject(data)) {
+    console.error('异常输入：', data);
+    return data;
+  }
+
+  const { defaultValue = '--', fieldsNotRequiringAction } = options;
+
+  for (const key in data) {
+    if (Object.prototype.hasOwnProperty.call(data, key)) {
+      const element = data[key];
+      if (fieldsNotRequiringAction) {
+        if (!fieldsNotRequiringAction.includes(key) && !_NotNull(element)) {
+          data[key] = defaultValue;
+        }
+      } else if (!_NotNull(element)) {
+        data[key] = defaultValue;
+      }
+    }
+  }
+
+  return data;
+}
+
+/**
+ * 将字典value转为对应label
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetDictionary(data, options = {}) {
+  if (!_IsObject(data)) {
+    console.error('异常输入：', data);
+    return data;
+  }
+
+  const {
+    dictionaryLabel = [],
+    dictionaryLabelJoin = [],
+    dictionaryOptions,
+    defaultValue = '--'
+  } = options;
+
+  if (dictionaryOptions) {
+    dictionaryLabel.forEach((label) => {
+      if (_NotNull(data[label])) {
+        const options = dictionaryOptions[label];
+
+        if (options) {
+          data[label] = options[data[label]];
+        } else {
+          data[label] = defaultValue;
+        }
+      } else {
+        data[label] = defaultValue;
+      }
+    });
+    dictionaryLabelJoin.forEach((label) => {
+      if (_NotNull(data[label]) && data[label] != '') {
+        const options = dictionaryOptions[label];
+        if (options) {
+          const oldvalue = data[label].split(',');
+          data[label] = '';
+          oldvalue.forEach((_label) => {
+            data[label] += options[_label];
+          });
+        } else {
+          data[label] = defaultValue;
+        }
+      } else {
+        data[label] = defaultValue;
+      }
+    });
+  }
+
+  return data;
+}
+
+/**
+ * 将字符串拼接的图片地址转为数组
+ * @param data 需修改对象
+ * @param options 配置
+ * @returns
+ */
+export function _SetPhoto(data, options = {}) {
+  if (!_IsObject(data)) {
+    console.error('异常输入：', data);
+    return data;
+  }
+
+  const { label, defaultUrl } = options;
+
+  if (label) {
+    label.forEach((label) => {
+      const defaultValue = (defaultUrl && defaultUrl[label]) || [];
+      const value = data[label];
+      if (typeof value === 'string') {
+        data[label] = value.split(',').filter(Boolean);
+      } else {
+        data[label] = defaultValue;
+      }
+    });
+  }
+
+  return data;
+}
+
+/**
+ * 将接口返回的数据进行处理，得到展示数据
+ * @param data object 类型的数据
+ * @param options 配置
+ * @returns exhibit_data
+ */
+export function _Exhibit_details(data, options = {}) {
+  if (!_IsObject(data)) {
+    console.error('异常输入：', data);
+    return {};
+  }
+
+  data = JSON.parse(JSON.stringify(data));
+
+  const {
+    dictionaryLabel = [],
+    dictionaryLabelJoin = [],
+    dictionaryOptions,
+
+    photoLabel = [],
+    photoDefaultUrl,
+
+    quantifierLabel = [],
+
+    filterLabel = [],
+
+    defaultValue = '--'
+  } = options;
+
+  _SetDictionary(data, {
+    dictionaryLabel,
+    dictionaryLabelJoin,
+    dictionaryOptions,
+    defaultValue
+  });
+
+  _SetPhoto(data, {
+    label: photoLabel,
+    defaultUrl: photoDefaultUrl
+  });
+
+  _SetQuantifierAttribute(data, quantifierLabel);
+
+  _SetDefaultValue(data, {
+    defaultValue,
+    fieldsNotRequiringAction: dictionaryLabel
+      .concat(dictionaryLabelJoin)
+      .concat(photoLabel)
+      .concat(
+        quantifierLabel
+          .map((item) => {
+            if (typeof item == 'string') return item;
+            if (Array.isArray(item)) return item[0];
+          })
+          .filter(Boolean)
+      )
+      .concat(filterLabel)
+  });
+
+  return data;
+}
+
+/** 多组loading控制器 */
+export class _LoadingController {
+  #controllersCollection = new Map();
+  constructor() {}
+
+  addController(key = 'default', config) {
+    if (this.#controllersCollection.has(key))
+      throw new Error('key为: ' + key + ' 的loading控制器已存在, 请重命名。');
+
+    const {
+      loadingState /** 更新/获取 loading 状态的方法 */,
+      delayTime = 200 /** 延迟时间 */,
+      minDisplayTime = 400 /** 最少显示时间 */
+    } = config;
+    this.#controllersCollection.set(key, {
+      invokers: new Set(),
+      timer: null,
+      startTime: 0,
+      loadingState,
+      delayTime,
+      minDisplayTime
+    });
+  }
+
+  deleteController(key) {
+    this.#controllersCollection.delete(key);
+  }
+
+  getController(key = 'default') {
+    const controller = this.#controllersCollection.get(key);
+    if (!controller) throw new Error('还未添加key为: ' + key + ' 的loading控制器');
+    return controller;
+  }
+
+  resetController(key) {
+    const controller = this.getController(key);
+    const { invokers, loadingState, timer } = controller;
+    invokers.clear();
+    loadingState(false);
+    controller.startTime = 0;
+    if (timer) clearTimeout(timer);
+    controller.timer = null;
+  }
+
+  startLoading(invoker, key) {
+    const controller = this.getController(key);
+    const { invokers, timer, loadingState, delayTime } = controller;
+
+    invokers.add(invoker);
+
+    if (invokers.size > 1) return;
+
+    if (delayTime) {
+      if (timer) {
+        return;
+      } else if (!loadingState()) {
+        controller.timer = setTimeout(() => {
+          loadingState(true);
+          controller.startTime = +new Date();
+          controller.timer = null;
+        }, delayTime);
+      }
+    } else {
+      loadingState(true);
+      controller.startTime = +new Date();
+    }
+  }
+
+  stopLoading(invoker, key) {
+    const controller = this.getController(key);
+    const { invokers, startTime, minDisplayTime } = controller;
+
+    const isFinished = invokers.has(invoker) && invokers.size == 1;
+
+    if (isFinished) {
+      const displayTime = +new Date() - startTime;
+      if (displayTime >= minDisplayTime) {
+        this.resetController(key);
+      } else {
+        setTimeout(() => this.stopLoading(invoker, key), displayTime - minDisplayTime);
+      }
+    } else {
+      invokers.delete(invoker);
+    }
+  }
+}

package/lib/Utility.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 非null | undefined判断
+ * @param value any
+ * @returns boolean
+ */
+export function _NotNull(value: any): boolean;
+
+/**
+ * 是正常对象吗
+ * @param {} value
+ * @returns boolean
+ */
+export function _IsObject(value: any): boolean;
+
+/**
+ * 寻找空闲时机执行传入方法
+ * @param callback  需执行的方法
+ */
+export function _ExecuteWhenIdle(callback: Function);
+
+/**
+ * 转为百分比字符串
+ * @param value 分子
+ * @param totalValue 分母
+ * @param decimalPlaces 保留小数位
+ * @returns 10.00%
+ */
+export function _ConvertToPercentage(
+  value: number,
+  totalValue: number,
+  decimalPlaces?: number
+): number;
+
+/**
+ * 等待条件满足
+ * @param conditionChecker 条件检查器
+ * @param timeoutMillis 超时毫秒数
+ * @returns Promise<unknown>
+ */
+export function _WaitForCondition(
+  conditionChecker: () => boolean,
+  timeoutMillis: number
+): Promise;
+
+/**
+ * 排除子串
+ * @param inputString 需裁剪字符串
+ * @param substringToDelete 被裁减字符串
+ * @param delimiter 分隔符
+ * @returns 裁减后的字符串
+ */
+export function _ExcludeSubstring(
+  inputString: string,
+  substringToDelete: string,
+  delimiter?: string
+): string;
+
+/**
+ * 首字母大写
+ * @param string
+ * @returns string
+ */
+export function _CapitalizeFirstLetter(string: string): string;
+
+/**
+ * 合并对象  注意: 本函数会直接操作 A
+ * @param {Object | Array} A
+ * @param {Object | Array} B
+ * @returns A&B || B
+ */
+export function _MergeObjects<T, T1>(A: T, B: T1): T & T1;
+
+/**
+ * 时间戳转换字符串
+ * @param {Number | Date} time 时间戳或Date对象
+ * @param {String} template 完整模板 -->  yyyy MM DD hh mm ss ms
+ * @param {Boolean} pad 补0
+ */
+export function _TimeTransition(
+  time: number | Date,
+  template: string,
+  pad: boolean
+): string;
+
+/**
+ * 误差范围
+ * @param value 需要判断的数字
+ * @param target 目标数字
+ * @param errorMargin 正负误差范围
+ * @returns 是否在误差内
+ */
+export function _IsWithinErrorMargin(
+  value: number,
+  target: number,
+  errorMargin: number
+): boolean;
+
+/**
+ * 读取文件
+ * @param src 文件地址
+ * @returns 文件的字符串内容
+ */
+export function _ReadFile(src: string): Promise<string>;
+
+/**
+ * 下载文件
+ * @param {文件路径} href
+ * @param {导出文件名} fileName
+ */
+export function _DownloadFile(href: string, fileName?: string): void;
+
+/**
+ * 获取帧率
+ * @param {Function} callback callback( 帧率 , 每帧时间 )
+ * @param {Number} referenceNode 参考节点数量
+ */
+export function _GetFrameRate(
+  callback: Function,
+  referenceNode: number = 10
+): void;
+
+/**
+ * 进度
+ * @param {Function} callback callback( 进度百分比 )
+ * @param {Number} TIME 总时长
+ */
+export function _Schedule(callback: Function, TIME: number = 500): void;
+
+/**
+ * 格式化数字，给数字加上千位分隔符。
+ * @param {number} number - 要格式化的数字。
+ * @returns {string} - 格式化后的字符串。
+ */
+export function _FormatNumber(number: number): string;
+
+/**
+ * 单位转换 12** -> **px
+ * @param {string} width
+ * @returns 对应的单位为px的宽
+ */
+export function _GetOtherSizeInPixels(width: string): string;
+
+/**
+ * 驼峰命名
+ * @param {字符串} str
+ * @param {是否删除分割字符} isRemoveDelimiter
+ * @returns 'wq1wqw-qw2qw' -> 'wq1Wqw-Qw2Qw' / 'wqWqwQwQw'
+ */
+export function _ConvertToCamelCase(
+  str: string,
+  isRemoveDelimiter?: boolean
+): string;

package/lib/Utility.js

@@ -0,0 +1,304 @@
+/**
+ * 非null | undefined判断
+ * @param value any
+ * @returns boolean
+ */
+export function _NotNull(value) {
+  return value !== null && value !== undefined;
+}
+
+/**
+ * 是正常对象吗
+ * @param {} value
+ * @returns boolean
+ */
+export function _IsObject(value) {
+  return !(value === null || typeof value !== "object" || Array.isArray(value));
+}
+
+/**
+ * 寻找空闲时机执行传入方法
+ * @param callback  需执行的方法
+ */
+export function _ExecuteWhenIdle(callback) {
+  if (typeof callback !== "function")
+    return console.error("非函数：", callback);
+  const loop = function (deadline) {
+    if (deadline.didTimeout || deadline.timeRemaining() <= 0)
+      requestIdleCallback(loop);
+    else callback();
+  };
+  requestIdleCallback(loop);
+}
+
+/**
+ * 转为百分比字符串
+ * @param value 分子
+ * @param totalValue 分母
+ * @param decimalPlaces 保留小数位
+ * @returns 10.00%
+ */
+export function _ConvertToPercentage(value, totalValue, decimalPlaces = 2) {
+  if (
+    typeof value !== "number" ||
+    typeof totalValue !== "number" ||
+    typeof decimalPlaces !== "number" ||
+    totalValue == 0
+  ) {
+    console.error("异常输入：", arguments);
+    return "0.00%";
+  }
+  return (
+    Number(
+      parseInt((value / totalValue) * Math.pow(10, 2 + decimalPlaces)) /
+        Math.pow(10, decimalPlaces)
+    ) || 0
+  );
+}
+
+/**
+ * 等待条件满足
+ * @param conditionChecker 条件检查器
+ * @param timeoutMillis 超时毫秒数
+ * @returns Promise<unknown>
+ */
+export function _WaitForCondition(conditionChecker, timeoutMillis) {
+  const startTime = new Date() - 0;
+  return new Promise((resolve, reject) => {
+    const checkCondition = () => {
+      const nowTime = new Date() - 0;
+      if (nowTime - startTime >= timeoutMillis) return reject("超时");
+      if (conditionChecker()) return resolve("完成");
+      requestIdleCallback(checkCondition);
+    };
+    checkCondition();
+  });
+}
+
+/**
+ * 排除子串
+ * @param inputString 需裁剪字符串
+ * @param substringToDelete 被裁减字符串
+ * @param delimiter 分隔符
+ * @returns 裁减后的字符串
+ */
+export function _ExcludeSubstring(
+  inputString,
+  substringToDelete,
+  delimiter = ","
+) {
+  const regex = new RegExp(
+    `(^|${delimiter})${substringToDelete}(${delimiter}|$)`,
+    "g"
+  );
+  return inputString.replace(regex, function ($0, $1, $2) {
+    return $1 === $2 ? delimiter : "";
+  });
+}
+
+/**
+ * 首字母大写
+ * @param str
+ * @returns string
+ */
+export function _CapitalizeFirstLetter(string) {
+  return string.charAt(0).toUpperCase() + string.slice(1);
+}
+
+/**
+ * 合并对象  注意: 本函数会直接操作 A
+ * @param {Object | Array} A
+ * @param {Object | Array} B
+ * @returns A&B || B
+ */
+export function _MergeObjects(A, B, visitedObjects = []) {
+  const getType = (v) => (Array.isArray(v) ? "array" : typeof v);
+  const TA = getType(A);
+  const TB = getType(B);
+
+  if (TA != TB) return B;
+  if (visitedObjects.some((item) => item == B)) return B;
+
+  if (TA == "object") {
+    visitedObjects.push(A, B);
+    for (const key in B) {
+      if (Object.prototype.hasOwnProperty.call(B, key)) {
+        const BC = B[key];
+        const AC = A[key];
+        const fianlValue = _MergeObjects(AC, BC, visitedObjects);
+        A[key] = fianlValue;
+      }
+    }
+    return A;
+  } else if (TA == "array") {
+    visitedObjects.push(A, B);
+    B.forEach((item, index) => {
+      const BC = item;
+      const AC = A[index];
+      const fianlValue = _MergeObjects(AC, BC, visitedObjects);
+      A[index] = fianlValue;
+    });
+    return A;
+  } else return B;
+}
+
+/**
+ * 时间戳转换字符串
+ * @param {Number | Date} time 时间戳或Date对象
+ * @param {String} template 完整模板 -->  yyyy MM DD hh mm ss ms
+ * @param {Boolean} pad 补0
+ */
+export function _TimeTransition(time, template, pad = true) {
+  try {
+    time = new Date(time);
+  } catch (error) {
+    console.error(error);
+    return "";
+  }
+  const dictionary = {
+    yyyy: "getFullYear",
+    MM: "getMonth",
+    DD: "getDate",
+    hh: "getHours",
+    mm: "getMinutes",
+    ss: "getSeconds",
+    ms: (num) => +num % 1000,
+  };
+  for (const key in dictionary) {
+    if (Object.hasOwnProperty.call(dictionary, key)) {
+      if (new RegExp(key).test(template)) {
+        let value,
+          fun = dictionary[key];
+
+        if (typeof fun == "function") value = fun(time);
+        else value = time[fun]();
+
+        if (key == "MM") value++;
+
+        if (pad) value = String(value).padStart(2, "0");
+
+        template = template.replace(key, value);
+      }
+    }
+  }
+  return template;
+}
+
+/**
+ * 误差范围
+ * @param value 需要判断的数字
+ * @param target 目标数字
+ * @param errorMargin 正负误差范围
+ * @returns 是否在误差内
+ */
+export function _IsWithinErrorMargin(value, target, errorMargin) {
+  return Math.abs(value - target) <= errorMargin;
+}
+
+/**
+ * 读取文件
+ * @param src 文件地址
+ * @returns 文件的字符串内容
+ */
+export function _ReadFile(src) {
+  return new Promise((resolve, reject) => {
+    fetch(src)
+      .then((response) => resolve(response.text()))
+      .catch((error) => {
+        console.error("Error fetching :", error);
+        reject(error);
+      });
+  });
+}
+
+/**
+ * 下载文件
+ * @param {文件路径} href
+ * @param {导出文件名} download
+ */
+export function _DownloadFile(href, fileName) {
+  const a = document.createElement("a");
+  a.href = href;
+  if (fileName) a.download = fileName;
+  a.style.display = "none";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+}
+
+/**
+ * 获取帧率
+ * @param {Function} callback callback( 帧率 , 每帧时间 )
+ * @param {Number} referenceNode 参考节点数量
+ */
+export function _GetFrameRate(callback, referenceNode = 10) {
+  let t,
+    arr = [];
+  function loop(time) {
+    if (t) {
+      arr.push(time - t);
+      let l = arr.length;
+      if (l >= referenceNode) {
+        let num = arr.reduce((a, b) => a + b, 0);
+        num /= l;
+        callback(1000 / num, num);
+        return;
+      }
+    }
+    t = time;
+    requestAnimationFrame(loop);
+  }
+  requestAnimationFrame(loop);
+}
+
+/**
+ * 进度
+ * @param {Function} callback callback( 进度百分比 )
+ * @param {Number} TIME 总时长
+ */
+export function _Schedule(callback, TIME = 500) {
+  let t;
+  function loop(time) {
+    if (!t) t = time;
+    let percentage = Math.min((time - t) / TIME, 1);
+    callback(percentage);
+    if (time - t < TIME) requestAnimationFrame(loop);
+  }
+  requestAnimationFrame(loop);
+}
+
+/**
+ * 格式化数字，给数字加上千位分隔符。
+ * @param {number} number - 要格式化的数字。
+ * @returns {string} - 格式化后的字符串。
+ */
+export function _FormatNumber(number) {
+  return number.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
+
+/**
+ * 单位转换 12** -> **px
+ * @param {string} width
+ * @returns 对应的单位为px的宽
+ */
+export function _GetOtherSizeInPixels(width) {
+  if (/px/.test(width)) return width;
+  const dom = document.createElement("div");
+  dom.style.width = width;
+  document.body.appendChild(dom);
+  width = parseFloat(window.getComputedStyle(dom).width);
+  document.body.removeChild(dom);
+  return width;
+}
+
+/**
+ * 驼峰命名
+ * @param {字符串} str
+ * @param {是否删除分割字符} isRemoveDelimiter
+ * @returns 'wq1wqw-qw2qw' -> 'wq1Wqw-Qw2Qw' / 'wqWqwQwQw'
+ */
+export function _ConvertToCamelCase(str, isRemoveDelimiter) {
+  str = str.replace(/([^a-zA-Z][a-z])/g, (match) => match.toUpperCase());
+  if (isRemoveDelimiter) return str.replace(/[^a-zA-Z]+/g, "");
+  return str;
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "nhanh-pure-function",
+  "version": "1.0.0",
+  "description": "纯函数工具",
+  "main": "lib/Index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "pure-function",
+    "format"
+  ],
+  "author": "nhanh",
+  "license": "MIT"
+}