@zcrkey/js-utils 0.0.5 → 0.0.7

package/docs/api/util/index.tsx

@@ -1,405 +0,0 @@
-/**
- * title: 基本使用
- */
-
-import { CrUtil } from '@zcrkey/js-utils';
-import React, { useState } from 'react';
-
-export default () => {
-  const [result, setResult] = useState<any>({});
-
-  const trim = () => {
-    let value1 = ' XXX ';
-    let value2 = 'XXX ';
-    let value3 = ' XXX';
-    let value4 = ' X X X ';
-    let res: any[] = [
-      `${value1} => ${CrUtil.trim(value1)}`,
-      `${value2} => ${CrUtil.trim(value2)}`,
-      `${value3} => ${CrUtil.trim(value3)}`,
-      `${value4} => ${CrUtil.trim(value4)}`,
-    ];
-    setResult({
-      ...result,
-      trim: res,
-    });
-  };
-
-  const getArrayDimension = () => {
-    let value1: any[] = [];
-    let value2: any[] = [[], 1];
-    let value3: any[] = [[], 1, [[], 34]];
-    let value4: any[] = [1, 2, 3];
-    let res: any[] = [
-      `${JSON.stringify(value1)} => ${CrUtil.getArrayDimension(value1)}维`,
-      `${JSON.stringify(value2)} => ${CrUtil.getArrayDimension(value2)}维`,
-      `${JSON.stringify(value3)} => ${CrUtil.getArrayDimension(value3)}维`,
-      `${JSON.stringify(value4)} => ${CrUtil.getArrayDimension(value4)}维`,
-    ];
-    setResult({
-      ...result,
-      getArrayDimension: res,
-    });
-  };
-
-  const deepCopy = () => {
-    let value1: any[] = [
-      {
-        number: 1,
-        string: 'zcr',
-        obj: {},
-        arr: [1, 2, 3],
-      },
-    ];
-    let value2: any = {
-      number: 1,
-      string: 'zcr',
-      obj: {
-        a: 123,
-      },
-      arr: [],
-    };
-
-    let value3 = CrUtil.deepCopy(value1);
-    let value4 = CrUtil.deepCopy(value2);
-
-    value3[0].arr.push(4);
-    value4.obj.a = 456;
-
-    let res: any[] = [
-      `${JSON.stringify(value1)} => ${JSON.stringify(value3)}`,
-      `${JSON.stringify(value2)} => ${JSON.stringify(value4)}`,
-    ];
-    setResult({
-      ...result,
-      deepCopy: res,
-    });
-  };
-
-  const compareVersion = () => {
-    let v1 = '1.2.3';
-    let v2 = '1.0.3';
-    let res: any[] = [
-      `${v1}和${v2} => ${CrUtil.compareVersion(v1, v2)}`,
-      `${v2}和${v1} => ${CrUtil.compareVersion(v2, v1)}`,
-      `${v1}和${v1} => ${CrUtil.compareVersion(v1, v1)}`,
-    ];
-    setResult({
-      ...result,
-      compareVersion: res,
-    });
-  };
-
-  const compareDataDiff = () => {
-    let data1: any = {
-      a: 1,
-      b: 1,
-      d: 4,
-      arr: [1],
-      arr2: [1, 2],
-      arr3: [{ aa: 1 }],
-      arr4: [{ aa: 2 }, { cc: 2 }],
-    };
-    let data2: any = {
-      a: 1,
-      b: 2,
-      c: 3,
-      arr: [1, 2],
-      arr2: [1],
-      arr3: [{ aa: 2 }, { cc: 2 }],
-      arr4: [{ aa: 1 }],
-    };
-    let res: any[] = [
-      `${JSON.stringify(data1)}和${JSON.stringify(data2)} => ${JSON.stringify(
-        CrUtil.compareDataDiff(data1, data2),
-      )}`,
-    ];
-    setResult({
-      ...result,
-      compareDataDiff: res,
-    });
-  };
-
-  const paramsSerializer = () => {
-    let v1 = { a: '1', b: {}, c: [] };
-    let v2 = { a: '1', b: { b1: 1, b2: 'zcr' }, c: [1, 2, 3] };
-    let res: any[] = [
-      `${JSON.stringify(v1)} => ${CrUtil.paramsSerializer(v1)}`,
-      `${JSON.stringify(v2)} => ${CrUtil.paramsSerializer(v2)}`,
-    ];
-    setResult({
-      ...result,
-      paramsSerializer: res,
-    });
-  };
-
-  const paramsParse = () => {
-    let v1 = `a=1`;
-    let v2 = `a=1&b%5Bb1%5D=1&b%5Bb2%5D=zcr&c%5B0%5D=1&c%5B1%5D=2&c%5B2%5D=3`;
-    let res: any[] = [
-      `${v1} => ${JSON.stringify(CrUtil.paramsParse(v1))}`,
-      `${v2} => ${JSON.stringify(CrUtil.paramsParse(v2))}`,
-    ];
-    setResult({
-      ...result,
-      paramsParse: res,
-    });
-  };
-
-  const listData = [
-    // { id: 1, name: '1', parentId: 0 },
-    // { id: 2, name: '1-1', parentId: 1 },
-    // { id: 3, name: '1-2', parentId: 1 },
-    // { id: 4, name: '1-1-1', parentId: 2 },
-    // { id: 5, name: '1-1-2', parentId: 2 },
-    { id: 1, parentId: null, name: 'Root A' },
-    { id: 2, parentId: 1, name: 'Child A1' },
-    { id: 3, parentId: 1, name: 'Child A2' },
-    { id: 4, parentId: 2, name: 'Grandchild A1-1' },
-    { id: 5, parentId: 0, name: 'Root B' },
-    { id: 6, parentId: 5, name: 'Child B1' },
-    { id: 7, parentId: 999, name: 'Orphan Node' },
-  ];
-
-  const listToTreeData = () => {
-    let res = CrUtil.listToTreeData(listData, {
-      isDeepCopy: true,
-    });
-    setResult({
-      ...result,
-      listToTreeData: res,
-    });
-  };
-
-  const urls = [
-    'https://example.com/#/?a=1&b=2',
-    'https://example.com/page?foo=1#/?a=1&b=2',
-    'https://example.com/page#/?a=1&b=2',
-    'https://example.com/page#/page?a=123&b=456',
-    'http://10.0.9.200:8862/index.html#/menu?clientType=pc',
-    'http://10.0.9.200:8862/index.html#/url=http://https://example.com?a=1&b=2&c=3&d=4',
-    'http://10.0.9.200:8862/index.html#/?url=http://https://example.com?a=1&b=2&c=3&d=4',
-    'https://example.com',
-    'https://example.com/path/to/resource',
-    'https://example.com?foo=bar&baz=qux',
-    'https://example.com#section2',
-    'https://example.com/path?foo=1#bar=2&baz=3',
-    'https://example.com/page?url=http%3A%2F%2Fother.com%3Fa%3D1%26b%3D2',
-    'https://example.com/page?foo=1&bar=2#id=3&name=Tom',
-    'https://example.com/page#id=2&flag',
-    'https://example.com/page',
-  ];
-
-  const getQueryParams = () => {
-    let res = [];
-    for (let url of urls) {
-      res.push(CrUtil.getQueryParams(url));
-    }
-    setResult({
-      ...result,
-      getQueryParams: res,
-    });
-  };
-
-  function stringifyFirstLevelOnly(obj: Record<string, any>): string {
-    if (obj === null || typeof obj !== 'object') {
-      return JSON.stringify(obj);
-    }
-    const entries = Object.keys(obj).map((key) => {
-      const valueStr = JSON.stringify(obj[key]);
-      return `  "${key}": ${valueStr}`;
-    });
-    return `{\n${entries.join(',\n')}\n}`;
-  }
-
-  return (
-    <>
-      <div className="flex flex-direction">
-        <div>获取URL参数</div>
-        <div className="text-lg">CrUtil.getQueryParams</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={getQueryParams}
-          >
-            调用
-          </button>
-          <div>
-            <div style={{ display: 'inline-grid', width: '50%' }}>
-              <pre style={{ marginBottom: '0px' }}>
-                {JSON.stringify(urls, null, 2)}
-              </pre>
-            </div>
-            <div style={{ display: 'inline-grid', width: '50%' }}>
-              <pre style={{ marginBottom: '0px' }}>
-                {stringifyFirstLevelOnly(result.getQueryParams)}
-              </pre>
-            </div>
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>去掉字符串前后所有空格</div>
-        <div className="text-lg">CrUtil.trim</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={trim}
-          >
-            调用
-          </button>
-          <pre>
-            {result.trim &&
-              result.trim.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </pre>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>获取数组为几维数组</div>
-        <div className="text-lg">CrUtil.getArrayDimension</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={getArrayDimension}
-          >
-            调用
-          </button>
-          <div>
-            {result.getArrayDimension &&
-              result.getArrayDimension.map((str: number) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>深拷贝</div>
-        <div className="text-lg">CrUtil.deepCopy</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={deepCopy}
-          >
-            调用
-          </button>
-          <div>
-            {result.deepCopy &&
-              result.deepCopy.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>比较数据差异</div>
-        <div className="text-lg">CrUtil.compareDataDiff</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={compareDataDiff}
-          >
-            调用
-          </button>
-          <div>
-            {result.compareDataDiff &&
-              result.compareDataDiff.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>版本号比较</div>
-        <div className="text-lg">CrUtil.compareVersion</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={compareVersion}
-          >
-            调用
-          </button>
-          <div>
-            {result.compareVersion &&
-              result.compareVersion.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>参数序列化</div>
-        <div className="text-lg">CrUtil.paramsSerializer</div>
-        <div>参数解析</div>
-        <div className="text-lg">CrUtil.paramsParse</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={paramsSerializer}
-          >
-            序列化
-          </button>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={paramsParse}
-          >
-            参数解析
-          </button>
-          <div>
-            {result.paramsSerializer &&
-              result.paramsSerializer.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-          <div>
-            {result.paramsParse &&
-              result.paramsParse.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-      <div className="divider"></div>
-      <div className="flex flex-direction">
-        <div>列表数据转树型数据</div>
-        <div className="text-lg">CrUtil.listToTreeData</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={listToTreeData}
-          >
-            调用
-          </button>
-          <div>
-            <div style={{ display: 'inline-grid', width: '50%' }}>
-              <pre style={{ marginBottom: '0px' }}>
-                {JSON.stringify(listData, null, 2)}
-              </pre>
-            </div>
-            <div style={{ display: 'inline-grid', width: '50%' }}>
-              <pre style={{ marginBottom: '0px' }}>
-                {JSON.stringify(result.listToTreeData, null, 2)}
-              </pre>
-            </div>
-          </div>
-        </div>
-      </div>
-    </>
-  );
-};

package/docs/api/util/is.tsx

@@ -1,196 +0,0 @@
-/**
- * title: isXxx 判断
- */
-
-import { CrUtil } from '@zcrkey/js-utils';
-import React, { useEffect, useState } from 'react';
-
-const number = 1;
-const emptyString = '';
-const string = 'zcr';
-const date = new Date();
-const sin = Math.sin;
-const _null = null;
-const _undefined = undefined;
-const boolean = true;
-const emptyArray: never[] = [];
-const emptyObject = {};
-const object = {
-  number: 1,
-  string: 'zcr',
-  obj: {},
-  arr: [],
-};
-const array = [1, 'zcr', {}, []];
-
-export default () => {
-  const [result, setResult] = useState<any>({});
-
-  useEffect(() => {
-    let value: any = [];
-    let other: { name: string } | { name: string }[] = value;
-    if (CrUtil.isObject(other)) {
-      other.name; // other 的类型为 { name: string }
-    }
-    if (CrUtil.isArray(other)) {
-      other[0]?.name; // other 的类型为 { name: string }[]
-    }
-  });
-
-  const isArray = () => {
-    let res: any[] = [];
-    if (CrUtil.isArray(emptyArray)) {
-      res.push(`${JSON.stringify(emptyArray)}：是数组`);
-    }
-    if (CrUtil.isArray(array)) {
-      res.push(`${JSON.stringify(array)}：是数组`);
-    }
-    if (!CrUtil.isArray(emptyString)) {
-      res.push(`${JSON.stringify(emptyString)}： 不是数组`);
-    }
-    if (!CrUtil.isArray(number)) {
-      res.push(`${JSON.stringify(number)}： 不是数组`);
-    }
-    if (!CrUtil.isArray(_null)) {
-      res.push(`${JSON.stringify(_null)}： 不是数组`);
-    }
-    if (!CrUtil.isArray(_undefined)) {
-      res.push(`${JSON.stringify(_undefined)}： 不是数组`);
-    }
-    setResult({
-      ...result,
-      isArray: res,
-    });
-  };
-
-  const isObject = () => {
-    let res: any[] = [];
-    if (CrUtil.isObject(emptyObject)) {
-      res.push(`${JSON.stringify(emptyObject)}：是对象`);
-    }
-    if (CrUtil.isObject(object)) {
-      res.push(`${JSON.stringify(object)}：是对象`);
-    }
-    if (CrUtil.isObject(date)) {
-      res.push(`new Date()： 是对象`);
-    }
-    if (!CrUtil.isObject(array)) {
-      res.push(`${JSON.stringify(array)}： 不是对象`);
-    }
-    if (!CrUtil.isObject(_null)) {
-      res.push(`${JSON.stringify(_null)}： 不是对象`);
-    }
-    if (!CrUtil.isObject(_undefined)) {
-      res.push(`${JSON.stringify(_undefined)}： 不是对象`);
-    }
-    if (!CrUtil.isObject(sin)) {
-      res.push(`Math.sin： 不是对象`);
-    }
-    setResult({
-      ...result,
-      isObject: res,
-    });
-  };
-
-  const isEmptyObject = () => {
-    let res: any[] = [];
-    if (CrUtil.isEmptyObject(emptyObject)) {
-      res.push(`${JSON.stringify(emptyObject)}：是空对象`);
-    }
-    if (!CrUtil.isEmptyObject(object)) {
-      res.push(`${JSON.stringify(object)}： 不是空对象`);
-    }
-
-    setResult({
-      ...result,
-      isEmptyObject: res,
-    });
-  };
-
-  return (
-    <>
-      <div className="flex flex-direction">
-        <div>判断是否为数组</div>
-        <div className="text-lg">CrUtil.isArray</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={isArray}
-          >
-            调用
-          </button>
-          <div>
-            {result.isArray &&
-              result.isArray.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-
-      <div className="divider"></div>
-
-      <div className="flex flex-direction">
-        <div>判断是否为对象</div>
-        <div className="text-lg">CrUtil.isObject</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={isObject}
-          >
-            调用
-          </button>
-          <div>
-            {result.isObject &&
-              result.isObject.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-
-      <div className="divider"></div>
-
-      <div className="flex flex-direction">
-        <div>判断是否为空对象</div>
-        <div className="text-lg">CrUtil.isEmptyObject</div>
-        <div>
-          <button
-            type="button"
-            className="cr-btn line-blue radius"
-            onClick={isEmptyObject}
-          >
-            调用
-          </button>
-          <div>
-            {result.isEmptyObject &&
-              result.isEmptyObject.map((str: string) => {
-                return <div key={str}>{str}</div>;
-              })}
-          </div>
-        </div>
-      </div>
-
-      <div className="divider"></div>
-
-      <div className="flex flex-direction margin-bottom">
-        <div>判断是否对象的属性是否全部为空</div>
-        <div className="text-lg margin-bottom">
-          CrUtil.isObjectPropertiesAllEmpty
-        </div>
-        <div>判断是否为日期</div>
-        <div className="text-lg margin-bottom">CrUtil.isDate</div>
-        <div>判断是否为字符串</div>
-        <div className="text-lg margin-bottom">CrUtil.isString</div>
-        <div>判断是否为数字</div>
-        <div className="text-lg margin-bottom">CrUtil.isNumber</div>
-        <div>判断是否为文件 File</div>
-        <div className="text-lg margin-bottom">CrUtil.isFile</div>
-        <div>判断是否为 Boolean</div>
-        <div className="text-lg margin-bottom">CrUtil.isBoolean</div>
-      </div>
-    </>
-  );
-};

package/docs/guide.md

@@ -1,24 +0,0 @@
-# @zcrkey/js-utils
-
-<!-- [![NPM version](https://img.shields.io/npm/v/js-utils.svg?style=flat)](https://g-nhxn7953.coding.net/public-artifacts/zcrkey/npm/@zcrkey/js-utils/version/40193242/overview)
-[![NPM downloads](http://img.shields.io/npm/dm/js-utils.svg?style=flat)](https://g-nhxn7953.coding.net/public-artifacts/zcrkey/npm/@zcrkey/js-utils/version/40193242/overview) -->
-
-一个 javascript 实用函数库
-
-## git 规范
-
-- feat: 新增特性 (feature)
-- fix: 修复 Bug(bug fix)
-- docs: 修改文档 (documentation)
-- style: 代码格式修改(white-space, formatting, missing semi colons, etc)
-- refactor: 代码重构(refactor)
-- perf: 改善性能(A code change that improves performance)
-- test: 测试(when adding missing tests)
-- build: 变更项目构建或外部依赖（例如 scopes: webpack、gulp、npm 等）
-- ci: 更改持续集成软件的配置文件和 package 中的 scripts 命令，例如 scopes: Travis, Circle 等
-- chore: 变更构建流程或辅助工具(比如更改测试环境)
-- revert: 代码回退
-
-## LICENSE
-
-MIT

package/src/index.ts

@@ -1,8 +0,0 @@
-export type * from './eventCenter';
-export { default as CrEventCenter } from './eventCenter';
-export type * from './objUtil';
-export { default as CrObjUtil } from './objUtil';
-export { default as CrStorage } from './storage';
-export type * from './treeUtil';
-export { default as CrTreeUtil } from './treeUtil';
-export { default as CrUtil } from './util';

package/src/objUtil.ts

@@ -1,20 +0,0 @@
-import { get, PropertyPath } from 'lodash';
-
-export type { PropertyPath };
-
-export default class CrObjUtil {
-  /**
-   * 根据字段路径获取对象值
-   * @param obj { 'a': [{ 'b': { 'c': 3 } }] }
-   * @param path 'a[0].b.c' | ['a', '0', 'b', 'c']
-   * @param defaultValue 找不到时返回的默认值
-   * @returns
-   */
-  static getValueByPath(
-    obj: Record<string | number | symbol, any>,
-    propertyPath: PropertyPath,
-    defaultValue?: any,
-  ) {
-    return get(obj, propertyPath, defaultValue);
-  }
-}