@whitesev/utils 1.0.9 → 1.1.1

package/src/LockFunction.ts

@@ -1,10 +1,14 @@
-import { Utils } from ".";
+import { Utils } from "./Utils";
 
 class LockFunction<K extends (...args: any[]) => any | Promise<any> | void> {
 	#flag: boolean = false;
 	#delayTime: number = 0;
 	#callback: K;
 	#context: typeof Utils;
+	lock: () => void;
+	unlock: () => void;
+	run: (...args: any[]) => Promise<void>;
+	isLock: () => boolean;
 	/**
 	 * @param callback 需要执行的函数
 	 * @param delayTime （可选）延迟xx毫秒后解锁，默认：0
@@ -25,37 +29,38 @@ class LockFunction<K extends (...args: any[]) => any | Promise<any> | void> {
 			this.#delayTime = delayTime as number;
 			this.#context = context;
 		}
-	}
-	/**
-	 * 判断是否被锁
-	 */
-	isLock() {
-		return this.#flag;
-	}
-	/**
-	 * 锁
-	 */
-	lock() {
-		this.#flag = true;
-	}
-	/**
-	 * 解锁
-	 */
-	unlock() {
-		setTimeout(() => {
-			this.#flag = false;
-		}, this.#delayTime);
-	}
-	/**
-	 * 执行
-	 */
-	async run(...args: any[]) {
-		if (this.isLock()) {
-			return;
-		}
-		this.lock();
-		await this.#callback.apply(this.#context, args);
-		this.unlock();
+
+		/**
+		 * 锁
+		 */
+		this.lock = function () {
+			this.#flag = true;
+		};
+		/**
+		 * 解锁
+		 */
+		this.unlock = function () {
+			setTimeout(() => {
+				this.#flag = false;
+			}, this.#delayTime);
+		};
+		/**
+		 * 判断是否被锁
+		 */
+		this.isLock = function () {
+			return this.#flag;
+		};
+		/**
+		 * 执行
+		 */
+		this.run = async function (...args: any[]) {
+			if (this.isLock()) {
+				return;
+			}
+			this.lock();
+			await this.#callback.apply(this.#context, args);
+			this.unlock();
+		};
 	}
 }
 

package/src/Log.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from ".";
+import type { AnyObject } from "./Utils";
 
 /** Utils.Log的初始化配置 */
 declare interface UtilsLogOptions {
@@ -21,11 +21,15 @@ declare interface UtilsLogOptions {
 }
 
 class Log {
-	/** 前面的TAG标志 */
+	/** 是否禁用输出的flag */
 	#disable: boolean = false;
-	tag: string = "";
+	/** 前面的TAG标志 */
+	tag: string = "Utils.Log";
+	/* 使用的console函数 */
 	#console: Console = null as any;
+	/* 当前输出的数量 */
 	#logCount = 0;
+	/* 配置 */
 	#details: UtilsLogOptions = {
 		tag: true,
 		successColor: "#0000FF",
@@ -36,10 +40,6 @@ class Log {
 		autoClearConsole: false,
 		logMaxCount: 999,
 	};
-	/**
-	 * 待恢复的函数或对象
-	 */
-	#recoveryList = [];
 	#msgColorDetails = [
 		"font-weight: bold; color: cornflowerblue",
 		"font-weight: bold; color: cornflowerblue",
@@ -47,22 +47,27 @@ class Log {
 		"font-weight: bold; color: cornflowerblue",
 	];
 	/**
-	 * @param _GM_info_ 油猴管理器的API GM_info，或者是一个对象，如{"script":{name:"Utils.Log"}}
+	 * @param _GM_info_ 油猴管理器的API GM_info，或者是一个对象，如{"script":{name:"Utils.Log"}}，或者直接是一个字符串
 	 * @param console 可指定console对象为unsafeWindow下的console或者是油猴window下的console
 	 */
 	constructor(
-		_GM_info_: {
-			script: {
-				name: string;
-			};
-		} = {
-			script: {
-				name: "Utils.Log",
-			},
-		},
-		console: Console = global.console
+		_GM_info_?:
+			| {
+					script: {
+						name: string;
+					};
+			  }
+			| string,
+		console: Console = globalThis.console
 	) {
-		this.tag = _GM_info_.script.name;
+		if (typeof _GM_info_ === "string") {
+			this.tag = _GM_info_;
+		} else if (
+			typeof _GM_info_ === "object" &&
+			typeof _GM_info_?.script?.name === "string"
+		) {
+			this.tag = _GM_info_.script.name;
+		}
 		this.#console = console;
 	}
 
@@ -87,6 +92,7 @@ class Log {
 			if (stackFunctionNamePositionMatch == null) {
 				continue;
 			}
+			/* 获取最后一个，因为第一个是包含了at  */
 			let stackFunctionName =
 				stackFunctionNameMatch[stackFunctionNameMatch.length - 1];
 			let stackFunctionNamePosition =
@@ -96,10 +102,7 @@ class Log {
 			if (
 				stackFunctionName === "" ||
 				stackFunctionName.match(
-					new RegExp(
-						"(^Utils.Log.|.<anonymous>$|^Function.each|^NodeList.forEach|^k.fn.init.each)",
-						"g"
-					)
+					/^(Utils\.|)Log(\.|)|.<anonymous>$|^Function.each|^NodeList.forEach|^k.fn.init.each/g
 				)
 			) {
 				continue;
@@ -144,7 +147,7 @@ class Log {
 	 * @param otherStyle 其它CSS
 	 */
 	private printContent(msg: any, color: string, otherStyle?: string) {
-		this.checkClearConsole.apply(this);
+		this.checkClearConsole();
 		otherStyle = otherStyle || "";
 		let stackSplit = new Error()!.stack!.split("\n");
 		stackSplit.splice(0, 2);
@@ -244,7 +247,7 @@ class Log {
 	 */
 	table(msg: AnyObject[], color = this.#details.infoColor, otherStyle = "") {
 		if (this.#disable) return;
-		this.checkClearConsole.apply(this);
+		this.checkClearConsole();
 		let stack = new Error()!.stack!.split("\n");
 		stack.splice(0, 1);
 		let errorStackParse = this.parseErrorStack(stack);

package/src/Progress.ts

@@ -1,4 +1,4 @@
-import { Utils } from ".";
+import { Utils } from "./Utils";
 
 declare interface ProgressParamConfig {
 	/** canvas元素节点 */

package/src/{tryCatch.ts → TryCatch.ts}

@@ -1,4 +1,4 @@
-import { Utils } from ".";
+import { Utils } from "./Utils";
 
 export declare interface UtilsTryCatchConfig {
 	log: boolean;

package/src/{index.ts → Utils.ts}

@@ -11,8 +11,9 @@ import { indexedDB } from "./indexedDB";
 import { LockFunction } from "./LockFunction";
 import { Log } from "./Log";
 import { Progress } from "./Progress";
-import { TryCatch } from "./tryCatch";
+import { TryCatch } from "./TryCatch";
 import { UtilsDictionary } from "./Dictionary";
+import type { DOMUtils_EventType } from "./Event";
 
 export declare var unsafeWindow: Window & typeof globalThis;
 
@@ -33,8 +34,8 @@ export type ArgsType<T extends JSTypeNames[]> = {
 	[I in keyof T]: JSTypeMap[T[I]];
 };
 
-export declare interface UtilsNestedObjectWithToString<V extends any> {
-	[key: string]: V | UtilsNestedObjectWithToString<V>;
+export declare interface UtilsOwnObject<V extends any> {
+	[key: string]: V | UtilsOwnObject<V>;
 }
 export declare interface AnyObject {
 	[key: string]: any | AnyObject;
@@ -64,199 +65,9 @@ export declare interface Vue2Context extends AnyObject {
 	$el: Element;
 }
 
-/**
- * 鼠标事件
- * + https://blog.csdn.net/weixin_68658847/article/details/126939879
- */
-
-declare interface DOMUtils_MouseEvent {
-	click: MouseEvent | PointerEvent;
-	contextmenu: MouseEvent | PointerEvent;
-	dblclick: MouseEvent | PointerEvent;
-	mousedown: MouseEvent | PointerEvent;
-	mouseenter: MouseEvent | PointerEvent;
-	mouseleave: MouseEvent | PointerEvent;
-	mousemove: MouseEvent | PointerEvent;
-	mouseover: MouseEvent | PointerEvent;
-	mouseout: MouseEvent | PointerEvent;
-	mouseup: MouseEvent | PointerEvent;
-}
-declare type DOMUtils_MouseEventType = keyof DOMUtils_MouseEvent;
-/**
- * 鼠标事件
- */
-declare interface DOMUtils_KeyboardEvent {
-	keydown: KeyboardEvent;
-	keypress: KeyboardEvent;
-	keyup: KeyboardEvent;
-}
-declare type DOMUtils_KeyboardEventType = keyof DOMUtils_KeyboardEvent;
-/**
- * 框架/对象事件
- */
-declare interface DOMUtils_Frame_Object_Event {
-	abort: Event;
-	beforeunload: Event;
-	error: Event;
-	hashchange: Event;
-	load: Event;
-	pageshow: Event;
-	pagehide: Event;
-	resize: Event;
-	scroll: Event;
-	unload: Event;
-}
-declare type DOMUtils_Frame_Object_EventType =
-	keyof DOMUtils_Frame_Object_Event;
-/**
- * 表单事件
- */
-declare interface DOMUtils_FormEvent {
-	blur: Event;
-	change: Event;
-	focus: Event;
-	focusin: Event;
-	focusout: Event;
-	input: Event;
-	reset: Event;
-	search: Event;
-}
-declare type DOMUtils_FormEventType = keyof DOMUtils_FormEvent;
-
-/**
- * 剪贴板事件
- */
-declare interface DOMUtils_ClipboardEvent {
-	copy: ClipboardEvent;
-	cut: ClipboardEvent;
-	paste: ClipboardEvent;
-}
-declare type DOMUtils_ClipboardEventType = keyof DOMUtils_ClipboardEvent;
-
-/**
- * 打印事件
- */
-declare interface DOMUtils_PrintEvent {
-	afterprint: Event;
-	beforeprint: Event;
-}
-declare type DOMUtils_PrintEventType = keyof DOMUtils_PrintEvent;
-
-/**
- * 拖动事件
- */
-declare interface DOMUtils_DragEvent {
-	drag: DragEvent;
-	dragend: DragEvent;
-	dragenter: DragEvent;
-	dragleave: DragEvent;
-	dragover: DragEvent;
-	dragstart: DragEvent;
-	drop: DragEvent;
-}
-declare type DOMUtils_DragEventType = keyof DOMUtils_DragEvent;
-
-/**
- * 多媒体（Media）事件
- */
-declare interface DOMUtils_MediaEvent {
-	abort: Event;
-	canplay: Event;
-	canplaythrough: Event;
-	durationchange: Event;
-	emptied: Event;
-	ended: Event;
-	error: Event;
-	loadeddata: Event;
-	loadedmetadata: Event;
-	loadstart: Event;
-	pause: Event;
-	play: Event;
-	playing: Event;
-	progress: Event;
-	ratechange: Event;
-	seeked: Event;
-	seeking: Event;
-	stalled: Event;
-	suspend: Event;
-	timeupdate: Event;
-	volumechange: Event;
-	waiting: Event;
-}
-declare type DOMUtils_MediaEventType = keyof DOMUtils_MediaEvent;
-
-/**
- * 动画事件
- */
-declare interface DOMUtils_AnimationEvent {
-	animationend: AnimationEvent;
-	animationiteration: AnimationEvent;
-	animationstart: AnimationEvent;
-}
-declare type DOMUtils_AnimationEventType = keyof DOMUtils_AnimationEvent;
-
-/**
- * 过渡事件
- */
-declare interface DOMUtils_TransitionEvent {
-	transitionend: TransitionEvent;
-}
-declare type DOMUtils_TransitionEventType = keyof DOMUtils_TransitionEvent;
-
-/**
- * 触摸事件
- */
-declare interface DOMUtils_TouchEvent {
-	touchstart: TouchEvent;
-	touchmove: TouchEvent;
-	touchend: TouchEvent;
-	touchcancel: TouchEvent;
-	touchenter: TouchEvent;
-	touchleave: TouchEvent;
-}
-declare type DOMUtils_TouchEventType = keyof DOMUtils_TouchEvent;
-/**
- * 其它事件
- */
-declare interface DOMUtils_OtherEvent {
-	message: Event;
-	online: Event;
-	offline: Event;
-	popstate: Event;
-	show: Event;
-	storage: Event;
-	toggle: Event;
-	wheel: Event;
-	propertychange: Event;
-	fullscreenchange: Event;
-	DOMContentLoaded: Event;
-}
-declare type DOMUtils_OtherEventType = keyof DOMUtils_OtherEvent;
-
-/**
- * 全部事件
- */
-declare type DOMUtils_Event = DOMUtils_MouseEvent &
-	DOMUtils_KeyboardEvent &
-	DOMUtils_Frame_Object_Event &
-	DOMUtils_FormEvent &
-	DOMUtils_ClipboardEvent &
-	DOMUtils_PrintEvent &
-	DOMUtils_DragEvent &
-	DOMUtils_MediaEvent &
-	DOMUtils_AnimationEvent &
-	DOMUtils_TransitionEvent &
-	DOMUtils_TouchEvent &
-	DOMUtils_OtherEvent;
-
-/**
- * 事件类型
- */
-declare type DOMUtils_EventType = keyof DOMUtils_Event;
-
 class Utils {
 	/** 版本号 */
-	version = "2024.5.25";
+	version = "2024.5.28";
 
 	/**
 	 * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
@@ -697,7 +508,7 @@ class Utils {
 	dispatchEvent(
 		element: HTMLElement | Document,
 		eventName: DOMUtils_EventType | DOMUtils_EventType[],
-		details?: UtilsNestedObjectWithToString<any>
+		details?: UtilsOwnObject<any>
 	): void;
 	/**
 	 * 主动触发事件
@@ -712,12 +523,12 @@ class Utils {
 	dispatchEvent(
 		element: HTMLElement | Document,
 		eventName: string,
-		details?: UtilsNestedObjectWithToString<any>
+		details?: UtilsOwnObject<any>
 	): void;
 	dispatchEvent(
 		element: HTMLElement | Document,
 		eventName: DOMUtils_EventType | DOMUtils_EventType[] | string,
-		details?: UtilsNestedObjectWithToString<any>
+		details?: UtilsOwnObject<any>
 	) {
 		let eventNameList: string[] = [];
 		if (typeof eventName === "string") {
@@ -926,7 +737,7 @@ class Utils {
 		}
 		let result = 0;
 		let resultType = "KB";
-		let sizeData: UtilsNestedObjectWithToString<number> = {};
+		let sizeData: UtilsOwnObject<number> = {};
 		sizeData.B = 1;
 		sizeData.KB = 1024;
 		sizeData.MB = sizeData.KB * sizeData.KB;
@@ -1341,7 +1152,7 @@ class Utils {
 	 * > 456
 	 */
 	getMaxValue(
-		val: UtilsNestedObjectWithToString<number>,
+		val: UtilsOwnObject<number>,
 		handler: (key: any, value: any) => number
 	): number;
 	/**
@@ -1431,7 +1242,7 @@ class Utils {
 	 * > 123
 	 */
 	getMinValue(
-		val: UtilsNestedObjectWithToString<number>,
+		val: UtilsOwnObject<number>,
 		handler: (key: any, value: any) => number
 	): number;
 	/**
@@ -1441,7 +1252,7 @@ class Utils {
 	 * > 0
 	 */
 	getMinValue(
-		val: UtilsNestedObjectWithToString<number>[],
+		val: UtilsOwnObject<number>[],
 		handler: (index: number, value: any) => number
 	): number;
 	getMinValue(...args: any[]): number {
@@ -1528,7 +1339,7 @@ class Utils {
 	 * Utils.getRandomValue({1:"结果1",2:"结果2",3:"结果3"}})
 	 * > 结果2
 	 */
-	getRandomValue<T extends any>(val: T[] | UtilsNestedObjectWithToString<T>): T;
+	getRandomValue<T extends any>(val: T[] | UtilsOwnObject<T>): T;
 	/**
 	 * 获取两个数之间随机值
 	 * @example
@@ -1543,8 +1354,8 @@ class Utils {
 	 * > {1: 1}
 	 */
 	getRandomValue<T extends any>(
-		val_1: UtilsNestedObjectWithToString<T>,
-		val_2: UtilsNestedObjectWithToString<T>
+		val_1: UtilsOwnObject<T>,
+		val_2: UtilsOwnObject<T>
 	): T;
 	getRandomValue(...args: any[]): any {
 		let result = [...args];
@@ -2174,7 +1985,7 @@ class Utils {
 			return false;
 		}
 		targetStr = targetStr.toLowerCase();
-		const targetCharMap: UtilsNestedObjectWithToString<string> = {};
+		const targetCharMap: UtilsOwnObject<string> = {};
 		let targetStrLength = 0;
 		for (const char of targetStr) {
 			if (Reflect.has(targetCharMap, char)) {
@@ -2691,60 +2502,52 @@ class Utils {
 		let default_obverser_config = {
 			/* 监听到元素有反馈，需执行的函数 */
 			callback: () => {},
-			config: {
+			config: <MutationObserverInit>{
 				/**
-				 * @type {boolean|undefined}
 				 * + true 监听以 target 为根节点的整个子树。包括子树中所有节点的属性，而不仅仅是针对 target
 				 * + false (默认) 不生效
 				 */
-				subtree: void 0,
+				subtree: void 0 as any as boolean,
 				/**
-				 * @type {boolean|undefined}
 				 * + true 监听 target 节点中发生的节点的新增与删除（同时，如果 subtree 为 true，会针对整个子树生效）
 				 * + false (默认) 不生效
 				 */
-				childList: void 0,
+				childList: void 0 as any as boolean,
 				/**
-				 * @type {boolean|undefined}
 				 * + true 观察所有监听的节点属性值的变化。默认值为 true，当声明了 attributeFilter 或 attributeOldValue
 				 * + false (默认) 不生效
 				 */
-				attributes: void 0,
+				attributes: void 0 as any as boolean,
 				/**
 				 * 一个用于声明哪些属性名会被监听的数组。如果不声明该属性，所有属性的变化都将触发通知
-				 * @type {[...string]|undefined}
 				 */
-				attributeFilter: void 0,
+				attributeFilter: void 0 as any as string[],
 				/**
-				 * @type {boolean|undefined}
 				 * + true 记录上一次被监听的节点的属性变化；可查阅 MutationObserver 中的 Monitoring attribute values 了解关于观察属性变化和属性值记录的详情
 				 * + false (默认) 不生效
 				 */
-				attributeOldValue: void 0,
+				attributeOldValue: void 0 as any as boolean,
 				/**
-				 * @type {boolean|undefined}
 				 * + true 监听声明的 target 节点上所有字符的变化。默认值为 true，如果声明了 characterDataOldValue
 				 * + false (默认) 不生效
 				 */
-				characterData: void 0,
+				characterData: void 0 as any as boolean,
 				/**
-				 * @type {boolean|undefined}
 				 * + true 记录前一个被监听的节点中发生的文本变化
 				 * + false (默认) 不生效
 				 */
-				characterDataOldValue: void 0,
+				characterDataOldValue: void 0 as any as boolean,
 			},
 		};
 		observer_config = UtilsContext.assign(
 			default_obverser_config,
 			observer_config
 		);
-		let MutationObserver =
-			(UtilsCore.window as any).MutationObserver ||
+		let windowMutationObserver =
+			window.MutationObserver ||
 			(UtilsCore.window as any).webkitMutationObserver ||
 			(UtilsCore.window as any).MozMutationObserver;
-		/** @type {MutationObserver} */
-		let mutationObserver = new MutationObserver(function (
+		let mutationObserver = new windowMutationObserver(function (
 			mutations: MutationRecord[],
 			observer: MutationObserver
 		) {

package/src/UtilsGMCookie.ts

@@ -1,4 +1,4 @@
-import { Utils } from ".";
+import { Utils } from "./Utils";
 
 declare interface UtilsGMCookieListResult {
 	/** 为 window.location.hostname */

package/src/UtilsGMMenu.ts

@@ -1,4 +1,4 @@
-import { Utils } from ".";
+import { Utils } from "./Utils";
 
 declare interface UtilsGMMenuClickCallBackData {
 	/** 菜单键名 */

package/src/indexedDB.ts

@@ -1,5 +1,3 @@
-import type { AnyObject } from ".";
-
 declare interface UtilsIDBOpenErrorResult {
 	code: number;
 	msg: string;
@@ -104,14 +102,14 @@ class indexedDB {
 			};
 			request.onsuccess = function (event: Event) {
 				if (!that.#db[dbName]) {
-                    let target = event.target as IDBRequest;
+					let target = event.target as IDBRequest;
 					that.#db[dbName] = target.result;
 				}
 				let store = that.createStore(dbName);
 				callback(store, true);
 			};
 			request.onupgradeneeded = function (event: Event) {
-                let target = event.target as IDBRequest;
+				let target = event.target as IDBRequest;
 				that.#db[dbName] = target.result;
 				let store = that.#db[dbName].createObjectStore(that.#storeName, {
 					keyPath: "key",