版本发布

2025-07-21 16:47:04 +08:00
parent 1abed7a2e1
commit 6d8193880a
307 changed files with 41718 additions and 0 deletions
--- a/cool/utils/comm.ts
+++ b/cool/utils/comm.ts
@@ -0,0 +1,627 @@
+/**
+ * 检查值是否为数组
+ * @example isArray([1, 2, 3]) // true
+ * @example isArray('123') // false
+ */
+export function isArray(value: any): boolean {
+	return Array.isArray(value);
+}
+
+/**
+ * 检查值是否为对象
+ * @example isObject({}) // true
+ * @example isObject([]) // false
+ */
+export function isObject(value: any): boolean {
+	return typeof value == "object" && !Array.isArray(value) && !isNull(value);
+}
+
+/**
+ * 检查值是否为字符串
+ * @example isString('abc') // true
+ * @example isString(123) // false
+ */
+export function isString(value: any): boolean {
+	return typeof value == "string";
+}
+
+/**
+ * 检查值是否为数字
+ * @example isNumber(123) // true
+ * @example isNumber('123') // false
+ */
+export function isNumber(value: any): boolean {
+	return typeof value == "number" && !isNaN(value);
+}
+
+/**
+ * 检查值是否为布尔值
+ * @example isBoolean(true) // true
+ * @example isBoolean(1) // false
+ */
+export function isBoolean(value: any): boolean {
+	return typeof value == "boolean";
+}
+
+/**
+ * 检查值是否为函数
+ * @example isFunction(() => {}) // true
+ * @example isFunction({}) // false
+ */
+export function isFunction(value: any): boolean {
+	return typeof value == "function";
+}
+
+/**
+ * 检查值是否为 null
+ * @example isNull(null) // true
+ * @example isNull(undefined) // true
+ */
+export function isNull(value?: any | null): boolean {
+	// #ifdef APP
+	return value == null;
+	// #endif
+
+	// #ifndef APP
+	return value == null || value == undefined;
+	// #endif
+}
+
+/**
+ * 检查值是否为空
+ * @example isEmpty([]) // true
+ * @example isEmpty('') // true
+ * @example isEmpty({}) // true
+ */
+export function isEmpty(value: any): boolean {
+	if (isArray(value)) {
+		return (value as any[]).length == 0;
+	}
+
+	if (isString(value)) {
+		return value == "";
+	}
+
+	if (isObject(value)) {
+		return keys(value).length == 0;
+	}
+
+	return false;
+}
+
+/**
+ * 返回对象的所有键名
+ * @example keys({a: 1, b: 2}) // ['a', 'b']
+ */
+export function keys(value: any): string[] {
+	// @ts-ignore
+	return UTSJSONObject.keys(value as UTSJSONObject);
+}
+
+/**
+ * 返回数组的第一个元素
+ * @example first([1, 2, 3]) // 1
+ * @example first([]) // null
+ */
+export function first<T>(array: T[]): T | null {
+	return isArray(array) && array.length > 0 ? array[0] : null;
+}
+
+/**
+ * 返回数组的最后一个元素
+ * @example last([1, 2, 3]) // 3
+ * @example last([]) // null
+ */
+export function last<T>(array: T[]): T | null {
+	return isArray(array) && array.length > 0 ? array[array.length - 1] : null;
+}
+
+/**
+ * 截取数组的一部分
+ * @example slice([1, 2, 3], 1) // [2, 3]
+ * @example slice([1, 2, 3], 1, 2) // [2]
+ */
+export function slice<T>(array: T[], start: number = 0, end: number = array.length): T[] {
+	if (!isArray(array)) return [];
+
+	const result: T[] = [];
+
+	for (let i = start; i < end && i < array.length; i++) {
+		result.push(array[i]);
+	}
+
+	return result;
+}
+
+/**
+ * 检查对象是否包含指定属性
+ * @example has({a: 1}, 'a') // true
+ * @example has({a: 1}, 'b') // false
+ */
+export function has(object: any, key: string): boolean {
+	return keys(object).includes(key);
+}
+
+/**
+ * 获取对象的属性值
+ * @example get({a: {b: 1}}, 'a.b') // 1
+ * @example get({a: {b: 1}}, 'a.c', 'default') // 'default'
+ */
+export function get(object: any, path: string, defaultValue: any | null = null): any | null {
+	if (isNull(object)) {
+		return defaultValue;
+	}
+
+	// @ts-ignore
+	const value = new UTSJSONObject(object).getAny(path);
+
+	if (isNull(value)) {
+		return defaultValue;
+	}
+
+	return value;
+}
+
+/**
+ * 设置对象的属性值
+ * @example set({a: 1}, 'b', 2) // {a: 1, b: 2}
+ */
+export function set(object: any, key: string, value: any): void {
+	(object as UTSJSONObject)[key] = value;
+}
+
+/**
+ * 遍历数组并返回新数组
+ * @example map([1, 2, 3], x => x * 2) // [2, 4, 6]
+ */
+export function map<T, U>(array: T[], iteratee: (item: T, index: number) => U): U[] {
+	const result: U[] = [];
+
+	if (!isArray(array)) return result;
+
+	for (let i = 0; i < array.length; i++) {
+		result.push(iteratee(array[i], i));
+	}
+
+	return result;
+}
+
+/**
+ * 将数组归约为单个值
+ * @example reduce([1, 2, 3], (sum, n) => sum + n, 0) // 6
+ */
+export function reduce<T, U>(
+	array: T[],
+	iteratee: (accumulator: U, value: T, index: number) => U,
+	initialValue: U
+): U {
+	if (!isArray(array)) return initialValue;
+
+	let accumulator: U = initialValue;
+	for (let i = 0; i < array.length; i++) {
+		accumulator = iteratee(accumulator, array[i], i);
+	}
+
+	return accumulator;
+}
+
+/**
+ * 检查数组中的所有元素是否都满足条件
+ * @example every([2, 4, 6], x => x % 2 == 0) // true
+ */
+export function every<T>(array: T[], predicate: (value: T, index: number) => boolean): boolean {
+	if (!isArray(array)) return true;
+
+	for (let i = 0; i < array.length; i++) {
+		if (!predicate(array[i], i)) {
+			return false;
+		}
+	}
+
+	return true;
+}
+
+/**
+ * 检查数组中是否有元素满足条件
+ * @example some([1, 2, 3], x => x > 2) // true
+ */
+export function some<T>(array: T[], predicate: (value: T, index: number) => boolean): boolean {
+	if (!isArray(array)) return false;
+
+	for (let i = 0; i < array.length; i++) {
+		if (predicate(array[i], i)) {
+			return true;
+		}
+	}
+
+	return false;
+}
+
+/**
+ * 创建去重后的数组
+ * @example uniq([1, 2, 2, 3]) // [1, 2, 3]
+ */
+export function uniq<T>(array: T[]): T[] {
+	if (!isArray(array)) return [];
+
+	const result: T[] = [];
+	const seen = new Map<T, boolean>();
+
+	for (let i = 0; i < array.length; i++) {
+		const item = array[i];
+		const key = item;
+		if (!seen.has(item)) {
+			seen.set(key, true);
+			result.push(item);
+		}
+	}
+
+	return result;
+}
+
+/**
+ * 将数组扁平化一层
+ * @example flatten([1, [2, 3], 4]) // [1, 2, 3, 4]
+ */
+export function flatten(array: any[]): any[] {
+	if (!isArray(array)) return [];
+
+	const result: any[] = [];
+
+	for (let i = 0; i < array.length; i++) {
+		const item = array[i];
+		if (isArray(item)) {
+			result.push(...(item as any[]));
+		} else {
+			result.push(item);
+		}
+	}
+
+	return result;
+}
+
+/**
+ * 将数组完全扁平化
+ * @example flattenDeep([1, [2, [3, [4]]]]) // [1, 2, 3, 4]
+ */
+export function flattenDeep(array: any[]): any[] {
+	if (!isArray(array)) return [];
+
+	const result: any[] = [];
+
+	for (let i = 0; i < array.length; i++) {
+		const item = array[i];
+		if (isArray(item)) {
+			result.push(...flattenDeep(item as any[]));
+		} else {
+			result.push(item);
+		}
+	}
+
+	return result;
+}
+
+/**
+ * 对数组进行排序
+ * @example sort([3, 1, 2]) // [1, 2, 3]
+ * @example sort(['c', 'a', 'b'], 'desc') // ['c', 'b', 'a']
+ */
+export function sort<T>(array: T[], order: "asc" | "desc" = "asc"): T[] {
+	const result = [...array];
+
+	return result.sort((a, b) => {
+		if (typeof a == "number" && typeof b == "number") {
+			return order == "asc" ? a - b : b - a;
+		}
+
+		if (typeof a == "string" && typeof b == "string") {
+			return order == "asc" ? a.localeCompare(b) : b.localeCompare(a);
+		}
+
+		return 0;
+	});
+}
+
+/**
+ * 根据对象属性对数组进行排序
+ * @example orderBy([{age: 30}, {age: 20}], 'age') // [{age: 20}, {age: 30}]
+ */
+export function orderBy<T>(array: T[], key: string, order: "asc" | "desc" = "asc"): T[] {
+	if (!isArray(array)) return [];
+
+	const result = [...array];
+
+	result.sort((a, b) => {
+		const valueA = get(a as any, key) as number;
+		const valueB = get(b as any, key) as number;
+
+		if (order == "asc") {
+			return valueA > valueB ? 1 : -1;
+		} else {
+			return valueA < valueB ? 1 : -1;
+		}
+	});
+
+	return result;
+}
+
+/**
+ * 根据对象属性对数组进行分组
+ * @example groupBy([{type: 'a'}, {type: 'b'}, {type: 'a'}], 'type') // {a: [{type: 'a'}, {type: 'a'}], b: [{type: 'b'}]}
+ */
+export function groupBy<T>(array: T[], key: string) {
+	if (!isArray(array)) return {};
+
+	const result = {};
+
+	for (let i = 0; i < array.length; i++) {
+		const item = array[i];
+		let value = get(item as any, key)!;
+
+		if (typeof value == "number") {
+			value = value.toString();
+		}
+
+		if (typeof value == "string") {
+			if (!isArray(result[value])) {
+				result[value] = new Array<T>();
+			}
+
+			(result[value] as T[]).push(item);
+		}
+	}
+
+	return result;
+}
+
+/**
+ * 将多个对象的属性合并到一个对象中
+ * @example assign({a: 1}, {b: 2}) // {a: 1, b: 2}
+ */
+export function assign(...items: any[]) {
+	// @ts-ignore
+	return UTSJSONObject.assign(...items.map((item) => item as UTSJSONObject));
+}
+
+/**
+ * 获取数组中指定索引的元素
+ * @example nth([1, 2, 3], 1) // 2
+ * @example nth([1, 2, 3], -1) // 3
+ */
+export function nth<T>(array: T[], index: number): T | null {
+	if (index >= 0) {
+		return array[index];
+	}
+
+	return array[array.length + index];
+}
+
+/**
+ * 从数组中移除指定的值
+ * @example pull([1, 2, 3, 1, 2, 3], 1, 2) // [3, 3]
+ */
+export function pull<T>(array: T[], ...values: T[]): T[] {
+	if (!isArray(array)) return [];
+
+	return array.filter((item) => !values.includes(item));
+}
+
+/**
+ * 从数组中移除满足条件的元素
+ * @example remove([1, 2, 3, 4], x => x % 2 == 0) // [1, 3]
+ */
+export function remove<T>(array: T[], predicate: (value: T, index: number) => boolean): T[] {
+	if (!isArray(array)) return [];
+
+	const result: T[] = [];
+
+	for (let i = 0; i < array.length; i++) {
+		if (!predicate(array[i], i)) {
+			result.push(array[i]);
+		}
+	}
+
+	return result;
+}
+
+/**
+ * 遍历数组
+ * @example forEach([1, 2, 3], x => console.log(x))
+ */
+export function forEach<T>(data: T[], iteratee: (value: T, index: number) => void): void {
+	if (isArray(data)) {
+		const array = data as T[];
+
+		for (let i = 0; i < array.length; i++) {
+			if (array[i] != null) {
+				iteratee(array[i], i);
+			}
+		}
+	}
+}
+
+/**
+ * 查找数组中第一个满足条件的元素
+ * @example find([1, 2, 3, 4], x => x > 2) // 3
+ */
+export function find<T>(array: T[], predicate: (value: T, index: number) => boolean): T | null {
+	if (!isArray(array)) return null;
+
+	for (let i = 0; i < array.length; i++) {
+		if (predicate(array[i], i)) {
+			return array[i];
+		}
+	}
+	return null;
+}
+
+/**
+ * 遍历对象
+ * @example forInObject({a: 1, b: 2}, (value, key) => console.log(key, value))
+ */
+export function forInObject(data: any, iteratee: (value: any, key: string) => void): void {
+	if (isObject(data)) {
+		const objKeys = keys(data);
+		for (let i = 0; i < objKeys.length; i++) {
+			const key = objKeys[i];
+			iteratee(get(data, key)!, key);
+		}
+	}
+}
+
+/**
+ * 对象转数组
+ * @example toArray({a: 1, b: 2}, (value, key) => ({key, value})) // [{key: 'a', value: 1}, {key: 'b', value: 2}]
+ */
+export function toArray<T>(data: any, iteratee: (value: any, key: string) => T): T[] {
+	const result: T[] = [];
+
+	if (isObject(data)) {
+		forInObject(data, (value, key) => {
+			result.push(iteratee(value, key));
+		});
+	}
+
+	return result;
+}
+
+/**
+ * 生成UUID
+ * @example uuid() // "123e4567-e89b-12d3-a456-426614174000"
+ */
+export function uuid(): string {
+	let uuid = "";
+	let i: number;
+	let random: number;
+
+	for (i = 0; i < 36; i++) {
+		if (i == 8 || i == 13 || i == 18 || i == 23) {
+			uuid += "-";
+		} else if (i == 14) {
+			uuid += "4";
+		} else if (i == 19) {
+			random = (Math.random() * 16) | 0;
+			uuid += ((random & 0x3) | 0x8).toString(16);
+		} else {
+			random = (Math.random() * 16) | 0;
+			uuid += random.toString(16);
+		}
+	}
+	return uuid;
+}
+
+/**
+ * 创建一个防抖函数，在指定延迟后执行函数，如果在延迟期间再次调用则重新计时
+ * @example debounce(() => console.log('执行'), 300)
+ */
+export function debounce(func: () => void, delay: number): () => number {
+	let timeoutId = 0;
+
+	return function (): number {
+		// 清除之前的定时器
+		if (timeoutId != 0) {
+			clearTimeout(timeoutId);
+		}
+
+		// 设置新的定时器
+		// @ts-ignore
+		timeoutId = setTimeout(() => {
+			func();
+			timeoutId = 0;
+		}, delay);
+
+		return timeoutId;
+	};
+}
+
+/**
+ * 创建一个节流函数，在指定时间间隔内只会执行一次
+ * @example
+ * const throttled = throttle(() => console.log('执行'), 300)
+ * throttled()
+ */
+export function throttle(func: () => void, delay: number): () => number {
+	let timeoutId: number = 0;
+	let lastExec: number = 0;
+
+	return function (): number {
+		const now: number = Date.now();
+
+		// 如果距离上次执行已超过delay，则立即执行
+		if (now - lastExec >= delay) {
+			func();
+			lastExec = now;
+			return 0;
+		}
+
+		// 否则在剩余时间后执行
+		if (timeoutId != 0) {
+			clearTimeout(timeoutId);
+		}
+		const remaining: number = delay - (now - lastExec);
+		// @ts-ignore
+		timeoutId = setTimeout(() => {
+			func();
+			lastExec = Date.now();
+			timeoutId = 0;
+		}, remaining);
+
+		return timeoutId;
+	};
+}
+
+/**
+ * 生成指定范围内的随机数
+ * @example random(1, 10) // 随机生成1到10之间的整数
+ */
+export function random(min: number, max: number): number {
+	return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+/**
+ * 检查是否为小程序环境
+ * @returns 是否为小程序环境
+ */
+export const isMp = (): boolean => {
+	// #ifdef MP
+	return true;
+	// #endif
+
+	return false;
+};
+
+/**
+ * 检查是否为App环境
+ * @returns 是否为App环境
+ */
+export const isApp = (): boolean => {
+	// #ifdef APP
+	return true;
+	// #endif
+
+	return false;
+};
+
+/**
+ * 检查是否为H5环境
+ * @returns 是否为H5环境
+ */
+export const isH5 = (): boolean => {
+	// #ifdef H5
+	return true;
+	// #endif
+
+	return false;
+};
+
+/**
+ * 检查是否为鸿蒙环境
+ * @returns 是否为鸿蒙环境
+ */
+export const isHarmony = (): boolean => {
+	// #ifdef APP-HARMONY
+	return true;
+	// #endif
+
+	return false;
+};