@anjianshi/utils 1.0.0

package/lang/object.js

@@ -0,0 +1,31 @@
+/**
+ * 对两个对象进行浅比较
+ * 代码取自 react-addons-shallow-compare 包
+ */
+export function shallowEqual(objA, objB) {
+    if (is(objA, objB))
+        return true;
+    if (!isObject(objA) || !isObject(objB))
+        return false;
+    const keysA = Object.keys(objA);
+    const keysB = Object.keys(objB);
+    if (keysA.length !== keysB.length)
+        return false;
+    // eslint-disable-next-line @typescript-eslint/prefer-for-of
+    for (let i = 0; i < keysA.length; i++) {
+        const key = keysA[i];
+        // eslint-disable-next-line prefer-object-has-own
+        if (!Object.prototype.hasOwnProperty.call(objB, key) || !is(objA[key], objB[key]))
+            return false;
+    }
+    return true;
+}
+function is(x, y) {
+    if (x === y)
+        return x !== 0 || y !== 0 || 1 / x === 1 / y;
+    else
+        return x !== x && y !== y; // eslint-disable-line no-self-compare
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}

package/lang/string.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 将数字字符串化，并在左侧填充 0 直到达到 length 参数指定的长度
+ * 若数字本身达到或超过此长度，则不填充
+ */
+export declare function zfill(num: number, length?: number): string;
+export declare function keywordCompare(keyword: string, target: string): boolean;
+export declare function numericCompare(a: string, b: string): number;
+/**
+ * 字符串解析成整数，补充安全措施：
+ * 1. 默认设置 radix 为 10，无需再手动指定
+ * 2. 支持指定 fallback，当解析出来的数字是 NaN 时返回这个值
+ */
+export declare function safeParseInt(value: string | number, fallback?: number, redix?: number): number;
+/**
+ * 字符串解析成浮点数；若解析结果是 NaN，返回 fallback
+ */
+export declare function safeParseFloat(value: string | number, fallback: number): number;

package/lang/string.js

@@ -0,0 +1,59 @@
+/**
+ * 字符串处理相关函数
+ */
+import escapeRegExp from 'lodash/escapeRegExp.js';
+import padStart from 'lodash/padStart.js';
+/**
+ * 将数字字符串化，并在左侧填充 0 直到达到 length 参数指定的长度
+ * 若数字本身达到或超过此长度，则不填充
+ */
+export function zfill(num, length = 2) {
+    return padStart(String(num), length, '0');
+}
+/**
+ * 执行关键词匹配
+ * 成功返回 true；失败返回 false
+ */
+const kwCache = {}; // 避免大量重复构建正则表达式影响性能
+export function keywordCompare(keyword, target) {
+    if (!keyword)
+        return true;
+    if (!(keyword in kwCache)) {
+        const regStr = keyword.split('').map(escapeRegExp).join('.*');
+        kwCache[keyword] = new RegExp(regStr, 'i');
+    }
+    return kwCache[keyword].test(target);
+}
+/**
+ * 对两个字符串进行排序，支持处理逻辑上的数字。
+ * 两个字符串都完全由数字组成，且都不以 0 开头时，以数字大小排序；否则以字符串形式排序。
+ *
+ * 以 0 开头是特例，例如 019 和 12 两个字符串，按直觉还是应该 019 在前面，毕竟本质还是字符串排序。
+ *
+ *
+ * "123" "456"             数字排序
+ * "123你好" "133我好"     字符串排序
+ * "019" "12"              字符串排序
+ */
+const _pattern = /^[1-9][0-9]*$/;
+export function numericCompare(a, b) {
+    if (_pattern.exec(a) && _pattern.exec(b))
+        return parseInt(a, 10) - parseInt(b, 10);
+    return a.localeCompare(b);
+}
+/**
+ * 字符串解析成整数，补充安全措施：
+ * 1. 默认设置 radix 为 10，无需再手动指定
+ * 2. 支持指定 fallback，当解析出来的数字是 NaN 时返回这个值
+ */
+export function safeParseInt(value, fallback, redix = 10) {
+    const raw = parseInt(String(value), redix);
+    return isFinite(raw) ? raw : fallback ?? raw;
+}
+/**
+ * 字符串解析成浮点数；若解析结果是 NaN，返回 fallback
+ */
+export function safeParseFloat(value, fallback) {
+    const raw = parseFloat(String(value));
+    return isFinite(raw) ? raw : fallback;
+}

package/lang/time.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 时间处理相关函数
+ */
+/**
+ * 返回指定时间长度的 毫秒数
+ */
+export declare function daysMS(n: number): number;
+export declare function hoursMS(n: number): number;
+export declare function minutesMS(n: number): number;
+export declare function secondsMS(n: number): number;

package/lang/time.js

@@ -0,0 +1,18 @@
+/**
+ * 时间处理相关函数
+ */
+/**
+ * 返回指定时间长度的 毫秒数
+ */
+export function daysMS(n) {
+    return hoursMS(n * 24);
+}
+export function hoursMS(n) {
+    return minutesMS(n * 60);
+}
+export function minutesMS(n) {
+    return secondsMS(n * 60);
+}
+export function secondsMS(n) {
+    return n * 1000;
+}

package/lang/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 对类型系统的辅助、补充
+ */
+/**
+ * 解决 TypeScript 中，数组字面量 [1, 'a'] 无法自动识别为 tuple 的问题
+ *
+ * 使用方法：
+ * const t = tuple(1, 'a')    // 类型会识别为 [1, 'a'] 而不是 (number | string)[]
+ *
+ * 待官方提供语言层面的支持
+ * https://github.com/microsoft/TypeScript/issues/27179
+ * https://github.com/microsoft/TypeScript/issues/16656
+ */
+export declare function tuple<T extends unknown[]>(...elements: T): T;
+/**
+ * 将一个对象中的指定 key 设为必须的
+ */
+export type RequiredFields<T, K extends keyof T> = Omit<T, K> & Pick<Required<T>, K>;
+/**
+ * 将一个对象中的指定 key 设为非必须的
+ */
+export type OptionalFields<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * 用 ReplaceT 中的字段定义代替 T 中的
+ */
+export type ReplaceFields<T, ReplaceT> = Omit<T, keyof ReplaceT> & ReplaceT;
+/**
+ * 获取一个对象所有 value 的集合
+ */
+export type ValueOf<T> = T extends {
+    [_ in keyof T]: infer U;
+} ? U : never;
+/**
+ * 获取指定类型的 key 的集合
+ * 可以解决 keyof 无法正确获取继承了 plain object interface 的类型的 key 的问题
+ *
+ * interface Base { [key: string]: number }
+ * interface MyType extends Base { a: 1, b: 2 }
+ * keyof MyType          // string | number
+ * KnownKeys<MyType>     // 'a' | 'b'
+ */
+export type KnownKeys<T> = ValueOf<{
+    [K in keyof T]: string extends K ? never : number extends K ? never : K;
+}>;
+/**
+ * 排除对象中指定类型的项目
+ */
+export type ExcludePropertiesOfType<T, ExcludeValueT> = Pick<T, {
+    [K in keyof T]: T[K] extends ExcludeValueT ? never : K;
+}[keyof T]>;
+/**
+ * 排除对象的方法（仅保留属性）
+ */
+export type ExcluceMethods<T> = ExcludePropertiesOfType<T, Function>;
+/**
+ * 所有“可能失败”的操作都可使用此类型作为返回值
+ */
+export interface Success<T = void> {
+    success: true;
+    data: T;
+}
+export interface Failed<ET = string> {
+    success: false;
+    error: ET;
+}
+export type MaySuccess<T = void, ET = string> = Success<T> | Failed<ET>;
+declare function success(): Success;
+declare function success<T>(data: T): Success<T>;
+export { success };
+export declare function failed<ET>(error: ET): Failed<ET>;
+/**
+ * 若传入值为 success，格式化其 data；否则原样返回错误
+ * 支持传入会返回 MaySuccess 的 Promise
+ */
+declare function formatSuccess<T, ET, FT>(item: MaySuccess<T, ET>, formatter: (data: T) => FT): MaySuccess<FT, ET>;
+declare function formatSuccess<T, ET, FT>(item: Promise<MaySuccess<T, ET>>, formatter: (data: T) => FT): Promise<MaySuccess<FT, ET>>;
+export { formatSuccess };
+/**
+ * 确认变量是否有值
+ * 注意：空字符串和数字 0 也会判定为没有值
+ */
+declare function truthy(value: string | number | boolean | null | undefined): value is string | number | true;
+declare function truthy<T>(value: T | string | number | boolean | null | undefined): value is T | string | number | true;
+export { truthy };
+/**
+ * 定义 JSON 数据
+ */
+export type JSONData = number | boolean | string | null | JSONData[] | {
+    [key: string]: JSONData;
+};
+/**
+ * 有些场景不适合用 undefined 判断一个变量是否被赋值（例如它允许被赋值成 undefined）
+ * 此时可以用这个 symbol 来做判断。
+ *
+ * if (value === noValue) console.log('未赋值')
+ * else console.log('已赋值', value)
+ */
+export declare const noValue: unique symbol;

package/lang/types.js

@@ -0,0 +1,41 @@
+/**
+ * 对类型系统的辅助、补充
+ */
+/**
+ * 解决 TypeScript 中，数组字面量 [1, 'a'] 无法自动识别为 tuple 的问题
+ *
+ * 使用方法：
+ * const t = tuple(1, 'a')    // 类型会识别为 [1, 'a'] 而不是 (number | string)[]
+ *
+ * 待官方提供语言层面的支持
+ * https://github.com/microsoft/TypeScript/issues/27179
+ * https://github.com/microsoft/TypeScript/issues/16656
+ */
+export function tuple(...elements) {
+    return elements;
+}
+function success(data) {
+    return { success: true, data };
+}
+export { success };
+export function failed(error) {
+    return { success: false, error };
+}
+function formatSuccess(item, formatter) {
+    if ('then' in item)
+        return item.then(finalItem => formatSuccess(finalItem, formatter));
+    return item.success ? { ...item, data: formatter(item.data) } : item;
+}
+export { formatSuccess };
+function truthy(value) {
+    return value !== null && value !== undefined && value !== '' && value !== 0 && value !== false;
+}
+export { truthy };
+/**
+ * 有些场景不适合用 undefined 判断一个变量是否被赋值（例如它允许被赋值成 undefined）
+ * 此时可以用这个 symbol 来做判断。
+ *
+ * if (value === noValue) console.log('未赋值')
+ * else console.log('已赋值', value)
+ */
+export const noValue = Symbol('no-value');

package/logging/adapt.d.ts

@@ -0,0 +1,5 @@
+import type { Debug } from 'debug';
+/**
+ * 适配 debug package
+ */
+export declare function adaptDebugLib(debugLib: Debug, enable?: string): void;

package/logging/adapt.js

@@ -0,0 +1,38 @@
+import { getLogger } from './index.js';
+/**
+ * 适配 debug package
+ */
+export function adaptDebugLib(debugLib, enable = '') {
+    // 不在 localStorage 里记录 debugLib enable 状态，
+    // 以解决 web worker 里读不到 localStorage 而无法启用 debugLib 日志的问题
+    const emulate = {
+        storage: {
+            data: {},
+            getItem(name) {
+                return emulate.storage.data[name];
+            },
+            setItem(name, value) {
+                emulate.storage.data[name] = value;
+            },
+            removeItem(name) {
+                delete emulate.storage.data[name];
+            },
+        },
+        save(namespaces) {
+            if (namespaces)
+                emulate.storage.setItem('debug', namespaces);
+            else
+                emulate.storage.removeItem('debug');
+        },
+        load() {
+            return emulate.storage.getItem('debug');
+        },
+    };
+    Object.assign(debugLib, emulate);
+    // 将 debugLib 日志转发给 logger
+    const logger = getLogger('3rd-library');
+    debugLib.log = logger.debug.bind(logger);
+    if (enable) {
+        debugLib.enable(enable);
+    }
+}

package/logging/formatters.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 日志常用数据的格式化函数
+ */
+import { type LogInfo } from './index.js';
+declare const formatters: {
+    time(info: LogInfo): string;
+    datetime(info: LogInfo): string;
+    level(info: LogInfo): string;
+};
+export default formatters;

package/logging/formatters.js

@@ -0,0 +1,22 @@
+/**
+ * 日志常用数据的格式化函数
+ */
+import { LogLevel } from './index.js';
+const formatters = {
+    time(info) {
+        return info.time.format('HH:mm:ss.SSS');
+    },
+    datetime(info) {
+        return info.time.format('YY-MM-DD HH:mm:ss.SSS');
+    },
+    level(info) {
+        const map = {
+            [LogLevel.Debug]: 'debug',
+            [LogLevel.Info]: 'info',
+            [LogLevel.Warning]: 'warn',
+            [LogLevel.Error]: 'error',
+        };
+        return map[info.level];
+    },
+};
+export default formatters;

package/logging/index.d.ts

@@ -0,0 +1,43 @@
+export { default as formatters } from './formatters.js';
+export * from './adapt.js';
+import { type Dayjs } from 'dayjs';
+export declare enum LogLevel {
+    Debug = 1,
+    Info = 2,
+    Warning = 3,
+    Error = 4
+}
+export interface LogInfo {
+    logger: string;
+    level: LogLevel;
+    time: Dayjs;
+    args: unknown[];
+}
+export declare class LogHandler {
+    log(info: LogInfo): void;
+}
+export declare class Logger {
+    name: string;
+    base: Logger | null;
+    level: LogLevel;
+    handlers: Set<LogHandler>;
+    constructor(name?: string, base?: Logger | null);
+    setLevel(level: LogLevel): void;
+    addHandler(handler: LogHandler): void;
+    /**
+     * 创建一个以当前 logger 为 base 的 child logger
+     */
+    getChild(name: string): this;
+    log(level: LogLevel, args: unknown[]): void;
+    protected logByInfo(info: LogInfo): void;
+    debug(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+}
+/**
+ * 提供一套默认配置好的 logger
+ */
+declare const defaultLogger: Logger;
+export { defaultLogger as logger };
+export declare function getLogger(name: string): Logger;

package/logging/index.js

@@ -0,0 +1,72 @@
+export { default as formatters } from './formatters.js';
+export * from './adapt.js';
+import dayjs from 'dayjs';
+import { initDayJs } from '../init-dayjs.js';
+// 引入 logging 库会自动初始化 dayjs
+initDayJs();
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Debug"] = 1] = "Debug";
+    LogLevel[LogLevel["Info"] = 2] = "Info";
+    LogLevel[LogLevel["Warning"] = 3] = "Warning";
+    LogLevel[LogLevel["Error"] = 4] = "Error";
+})(LogLevel || (LogLevel = {}));
+export class LogHandler {
+    log(info) { } // eslint-disable-line @typescript-eslint/no-unused-vars
+}
+export class Logger {
+    name;
+    base;
+    level = LogLevel.Info;
+    handlers = new Set();
+    constructor(name = '', base = null) {
+        this.name = name;
+        this.base = base;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    addHandler(handler) {
+        this.handlers.add(handler);
+    }
+    /**
+     * 创建一个以当前 logger 为 base 的 child logger
+     */
+    getChild(name) {
+        const fullname = this.name ? `${this.name}/${name}` : name;
+        // 这里加上 `as this` 才能让 TypeScript 判定，对继承了 Logger 的类调用此方法时，返回的是那个类而不是原始的 Logger 类的实例
+        return new this.constructor(fullname, this);
+    }
+    log(level, args) {
+        this.logByInfo({ logger: this.name, level, time: dayjs(), args });
+    }
+    logByInfo(info) {
+        if (this.base)
+            this.base.logByInfo(info);
+        if (this.level > info.level)
+            return;
+        for (const handler of this.handlers) {
+            handler.log(info);
+        }
+    }
+    debug(...args) {
+        this.log(LogLevel.Debug, args);
+    }
+    info(...args) {
+        this.log(LogLevel.Info, args);
+    }
+    warn(...args) {
+        this.log(LogLevel.Warning, args);
+    }
+    error(...args) {
+        this.log(LogLevel.Error, args);
+    }
+}
+/**
+ * 提供一套默认配置好的 logger
+ */
+const defaultLogger = new Logger();
+export { defaultLogger as logger };
+export function getLogger(name) {
+    return defaultLogger.getChild(name);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@anjianshi/utils",
+  "version": "1.0.0",
+  "description": "Common JavaScript Utils",
+  "homepage": "https://github.com/anjianshi/js-utils",
+  "bugs": {
+    "url": "https://github.com/anjianshi/js-utils/issues",
+    "email": "anjianshi@gmail.com"
+  },
+  "license": "MIT",
+  "author": "anjianshi <anjianshi@gmail.com>",
+  "repository": "github:anjianshi/js-utils",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "type": "module",
+  "scripts": {
+    "watch": "npm run clear && tsc --watch",
+    "build": "npm run clear && tsc",
+    "clear": "rm -rf dist",
+    "prepublishOnly": "npm run build && cp -R dist/* ./",
+    "postpublish": "node ./build-cleanup.cjs",
+    "lint": "tsc --noEmit && eslint './src/**/*'"
+  },
+  "main": "index.js",
+  "dependencies": {
+    "dayjs": "^1.11.10",
+    "lodash": "^4.17.21"
+  },
+  "devDependencies": {
+    "@anjianshi/presets": "1.3.0",
+    "@types/debug": "^4.1.9",
+    "@types/lodash": "^4.14.199",
+    "@types/node": "^20.8.6",
+    "eslint": "^8.51.0",
+    "prettier-not-stubborn": "^3.0.3",
+    "typescript": "^5.2.2",
+    "vconsole": "^3.15.1"
+  },
+  "eslintIgnore": [],
+  "prettier": "@anjianshi/presets/prettierrc"
+}

package/src/.eslintrc.cjs

@@ -0,0 +1,8 @@
+/* eslint-env node */
+module.exports = {
+  root: true,
+  extends: [
+    '../node_modules/@anjianshi/presets/eslint-base.js',
+    '../node_modules/@anjianshi/presets/eslint-typescript.js',
+  ],
+}

package/src/env-browser/.eslintrc.cjs

@@ -0,0 +1,6 @@
+/* eslint-env node */
+module.exports = {
+  env: {
+    browser: true,
+  },
+}

package/src/env-browser/device.ts

@@ -0,0 +1,60 @@
+/**
+ * 自动计算最合适的 rem 大小，应用到页面样式上。
+ *
+ * rem 的意义是对于大屏幕，适当地同步放大界面元素，以提供更饱满的显示效果。
+ * 不过也不是所有地方都原封不动地大就好了，所以还要配合 media query 来实现最佳效果。
+ */
+export function autoRem() {
+  const resizeEvt = 'orientationchange' in window ? 'orientationchange' : 'resize'
+
+  /**
+   * 计算规则：
+   * - 微信标准的 375px 宽度下，1rem 为 50px（这个比例的来由是这样的：移动端通常像素比 >= 2，这个 375px 的实际渲染像素是 750px，也就是实际渲染 750px 的情况下，1rem 为 100px）。
+   * - 在平板等特大屏幕下，限制 rem 的最大值为 75px，再大就夸张了。
+   * - 竖屏时取宽度来适配 rem，横屏时取高度来适配，以保证屏幕朝向不同时，界面元素的放大比例是一致的（这应该更符合人的认知：对于一个同样大小的屏幕，无论什么朝向，上面的文字应该是一样大的）。
+   *   注意：此计算方式仅适合“不能任意调整浏览器大小的”移动设备，对于浏览器窗口可能任意尺寸、比例的桌面端，还是应该始终按照宽度来适配。
+   *
+   * 从 px 到 rem 的换算：
+   * 原 px 单位的值换算成 rem，只要除以 50 即可。例如 12px 变成 0.24rem。
+   */
+  function updateRem() {
+    const { clientWidth, clientHeight } = document.documentElement
+    const refSize = Math.min(clientWidth, clientHeight)
+    const rem = Math.min((refSize / 750) * 100, 75)
+    document.documentElement.style.fontSize = `${rem}px`
+  }
+
+  window.addEventListener(resizeEvt, updateRem, false)
+  document.addEventListener('DOMContentLoaded', updateRem, false)
+}
+
+/**
+ * 当前设备是否是全面屏
+ * 页面刚加载时可能取不到 offsetHeight，因此通过一个函数而不是常量来提供此值
+ */
+export function isFullScreen() {
+  const rate = document.documentElement.offsetHeight / document.documentElement.offsetWidth
+  const limit = window.screen.height === window.screen.availHeight ? 1.8 : 1.65 // 临界判断值
+  return rate > limit
+}
+
+/**
+ * 当前是否是 iOS 设备
+ */
+export const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent)
+
+/**
+ * 当前是否是移动设备
+ */
+export const isMobile =
+  /(android|bb\d+|meego).+mobile|avantgo|bada\/|blackberry|blazer|compal|elaine|fennec|hiptop|iemobile|ip(hone|od)|iris|kindle|lge |maemo|midp|mmp|mobile.+firefox|netfront|opera m(ob|in)i|palm( os)?|phone|p(ixi|re)\/|plucker|pocket|psp|series(4|6)0|symbian|treo|up\.(browser|link)|vodafone|wap|windows ce|xda|xiino/i.test(
+    navigator.userAgent || navigator.vendor
+  ) ||
+  /1207|6310|6590|3gso|4thp|50[1-6]i|770s|802s|a wa|abac|ac(er|oo|s-)|ai(ko|rn)|al(av|ca|co)|amoi|an(ex|ny|yw)|aptu|ar(ch|go)|as(te|us)|attw|au(di|-m|r |s )|avan|be(ck|ll|nq)|bi(lb|rd)|bl(ac|az)|br(e|v)w|bumb|bw-(n|u)|c55\/|capi|ccwa|cdm-|cell|chtm|cldc|cmd-|co(mp|nd)|craw|da(it|ll|ng)|dbte|dc-s|devi|dica|dmob|do(c|p)o|ds(12|-d)|el(49|ai)|em(l2|ul)|er(ic|k0)|esl8|ez([4-7]0|os|wa|ze)|fetc|fly(-|_)|g1 u|g560|gene|gf-5|g-mo|go(\.w|od)|gr(ad|un)|haie|hcit|hd-(m|p|t)|hei-|hi(pt|ta)|hp( i|ip)|hs-c|ht(c(-| |_|a|g|p|s|t)|tp)|hu(aw|tc)|i-(20|go|ma)|i230|iac( |-|\/)|ibro|idea|ig01|ikom|im1k|inno|ipaq|iris|ja(t|v)a|jbro|jemu|jigs|kddi|keji|kgt( |\/)|klon|kpt |kwc-|kyo(c|k)|le(no|xi)|lg( g|\/(k|l|u)|50|54|-[a-w])|libw|lynx|m1-w|m3ga|m50\/|ma(te|ui|xo)|mc(01|21|ca)|m-cr|me(rc|ri)|mi(o8|oa|ts)|mmef|mo(01|02|bi|de|do|t(-| |o|v)|zz)|mt(50|p1|v )|mwbp|mywa|n10[0-2]|n20[2-3]|n30(0|2)|n50(0|2|5)|n7(0(0|1)|10)|ne((c|m)-|on|tf|wf|wg|wt)|nok(6|i)|nzph|o2im|op(ti|wv)|oran|owg1|p800|pan(a|d|t)|pdxg|pg(13|-([1-8]|c))|phil|pire|pl(ay|uc)|pn-2|po(ck|rt|se)|prox|psio|pt-g|qa-a|qc(07|12|21|32|60|-[2-7]|i-)|qtek|r380|r600|raks|rim9|ro(ve|zo)|s55\/|sa(ge|ma|mm|ms|ny|va)|sc(01|h-|oo|p-)|sdk\/|se(c(-|0|1)|47|mc|nd|ri)|sgh-|shar|sie(-|m)|sk-0|sl(45|id)|sm(al|ar|b3|it|t5)|so(ft|ny)|sp(01|h-|v-|v )|sy(01|mb)|t2(18|50)|t6(00|10|18)|ta(gt|lk)|tcl-|tdg-|tel(i|m)|tim-|t-mo|to(pl|sh)|ts(70|m-|m3|m5)|tx-9|up(\.b|g1|si)|utst|v400|v750|veri|vi(rg|te)|vk(40|5[0-3]|-v)|vm40|voda|vulc|vx(52|53|60|61|70|80|81|83|85|98)|w3c(-| )|webc|whit|wi(g |nc|nw)|wmlb|wonu|x700|yas-|your|zeto|zte-/i.test(
+    (navigator.userAgent || navigator.vendor).substr(0, 4)
+  )
+
+/**
+ * 当前是否是微信内部浏览器
+ */
+export const isWechat = /micromessenger/i.test(navigator.userAgent)

package/src/env-browser/global.ts

@@ -0,0 +1,20 @@
+/**
+ * 通过此模块注册全局变量以便于调试
+ */
+
+declare global {
+  interface Window {
+    app: { [key: string]: unknown }
+  }
+}
+
+// web-worker 环境下不存在 window 变量，无法执行注册
+let hasWindow = false
+try {
+  window.app = {}
+  hasWindow = true
+} catch (e) {} // eslint-disable-line no-empty
+
+export default function registerGlobal(key: string, content: unknown) {
+  if (hasWindow) window.app[key] = content
+}

package/src/env-browser/load-script.ts

@@ -0,0 +1,13 @@
+/**
+ * 加载脚本文件
+ * 返回 Promise，成功则 resolve，失败 reject
+ */
+export default async function loadScript(url: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const script = document.createElement('script')
+    script.src = url
+    script.onload = () => resolve()
+    script.onerror = err => reject(err)
+    window.document.head.appendChild(script)
+  })
+}