@whitesev/utils 1.2.0 → 1.2.2

package/dist/src/Httpx.d.ts

@@ -1028,7 +1028,7 @@ export declare interface HttpxDetailsConfig extends HttpxDetails {
 /**
  * 响应的数据的data
  */
-export declare interface HttpxAsyncResultData<T extends HttpxDetails> {
+export declare interface HttpxAsyncResultData<T = HttpxDetails> {
     /**
      * 如果fetch为true，且返回的headers中的Content-Type存在text/event-stream或者是主动设置的responseType为stream
      * 则存在该属性为true
@@ -1089,7 +1089,7 @@ export declare interface HttpxAsyncResultData<T extends HttpxDetails> {
 /**
  * 响应的数据
  */
-export declare interface HttpxAsyncResult<T extends HttpxDetails> {
+export declare interface HttpxAsyncResult<T = HttpxDetails> {
     /**
      * 请求状态，状态码为200为成功true，否则false
      */

package/dist/src/Utils.d.ts

@@ -309,7 +309,30 @@ declare class Utils {
      * Utils.formatTime()
      * > '2023-1-1 00:00:00'
      **/
-    formatTime(text?: string | number | Date, formatType?: "yyyy-MM-dd HH:mm:ss" | "yyyy/MM/dd HH:mm:ss" | "yyyy年MM月dd日 HH时mm分ss秒" | "yyyyMMdd" | "yyyy_MM_dd_HH_mm_ss" | "yyyy年MM月dd日 hh:mm:ss" | "yyyy-MM-dd" | "HH:mm:ss"): string;
+    formatTime(text?: string | number | Date, formatType?: string): string;
+    /**
+     * 获取格式化后的时间
+     * @param text （可选）需要格式化的字符串或者时间戳，默认：new Date()
+     * @param formatType （可选）格式化成的显示类型，默认：yyyy-MM-dd HH:mm:ss
+     * + yyyy 年
+     * + MM 月
+     * + dd 天
+     * + HH 时 (24小时制)
+     * + hh 时 (12小时制)
+     * + mm 分
+     * + ss 秒
+     * @returns {string}	返回格式化后的时间
+     * @example
+     * Utils.formatTime("2022-08-21 23:59:00","HH:mm:ss");
+     * > '23:59:00'
+     * @example
+     * Utils.formatTime(1899187424988,"HH:mm:ss");
+     * > '15:10:13'
+     * @example
+     * Utils.formatTime()
+     * > '2023-1-1 00:00:00'
+     **/
+    formatTime(text?: string | number | Date, formatType?: "yyyy-MM-dd HH:mm:ss" | "yyyy/MM/dd HH:mm:ss" | "yyyy_MM_dd_HH_mm_ss" | "yyyy年MM月dd日 HH时mm分ss秒" | "yyyy年MM月dd日 hh:mm:ss" | "yyyy年MM月dd日 HH:mm:ss" | "yyyy-MM-dd" | "yyyyMMdd" | "HH:mm:ss"): string;
     /**
      * 字符串格式的时间转时间戳
      * @param text	字符串格式的时间，例如：
@@ -1506,6 +1529,25 @@ declare class Utils {
      * })
      */
     waitNodeList<T extends HTMLElement>(nodeSelector: string): Promise<T>;
+    /**
+     * 等待指定元素出现
+     * @param nodeSelectors
+     * @returns 当nodeSelectors为数组多个时，
+     * 返回如：[ NodeList, NodeList ]，
+     * 当nodeSelectors为单个时，
+     * 返回如：NodeList。
+     * NodeList元素与页面存在强绑定，当已获取该NodeList，但是页面中却删除了，该元素在NodeList中会被自动删除
+     * @example
+     * Utils.waitNodeList("div.xxx").then( nodeList =>{
+     *  console.log(nodeList) // div.xxx => NodeList
+     * })
+     * @example
+     * Utils.waitNodeList("div.xxx","a.xxx").then( nodeListArray =>{
+     *  console.log(nodeListArray[0]) // div.xxx => NodeList
+     *  console.log(nodeListArray[1]) // a.xxx => NodeList
+     * })
+     */
+    waitNodeList<T extends HTMLElement[]>(nodeSelector: string): Promise<T>;
     /**
      * 等待指定元素出现，支持多个selector
      * @param nodeSelectors

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@whitesev/utils",
-	"version": "1.2.0",
+	"version": "1.2.2",
 	"description": "一个常用的工具库",
 	"main": "dist/index.cjs.js",
 	"module": "dist/node/index.esm.js",

package/src/Httpx.ts

@@ -1124,7 +1124,7 @@ export declare interface HttpxDetailsConfig extends HttpxDetails {
 /**
  * 响应的数据的data
  */
-export declare interface HttpxAsyncResultData<T extends HttpxDetails> {
+export declare interface HttpxAsyncResultData<T = HttpxDetails> {
 	/**
 	 * 如果fetch为true，且返回的headers中的Content-Type存在text/event-stream或者是主动设置的responseType为stream
 	 * 则存在该属性为true
@@ -1185,7 +1185,7 @@ export declare interface HttpxAsyncResultData<T extends HttpxDetails> {
 /**
  * 响应的数据
  */
-export declare interface HttpxAsyncResult<T extends HttpxDetails> {
+export declare interface HttpxAsyncResult<T = HttpxDetails> {
 	/**
 	 * 请求状态，状态码为200为成功true，否则false
 	 */

package/src/Utils.ts

@@ -807,6 +807,29 @@ class Utils {
 		}
 		return resultValue;
 	}
+	/**
+	 * 获取格式化后的时间
+	 * @param text （可选）需要格式化的字符串或者时间戳，默认：new Date()
+	 * @param formatType （可选）格式化成的显示类型，默认：yyyy-MM-dd HH:mm:ss
+	 * + yyyy 年
+	 * + MM 月
+	 * + dd 天
+	 * + HH 时 (24小时制)
+	 * + hh 时 (12小时制)
+	 * + mm 分
+	 * + ss 秒
+	 * @returns {string}	返回格式化后的时间
+	 * @example
+	 * Utils.formatTime("2022-08-21 23:59:00","HH:mm:ss");
+	 * > '23:59:00'
+	 * @example
+	 * Utils.formatTime(1899187424988,"HH:mm:ss");
+	 * > '15:10:13'
+	 * @example
+	 * Utils.formatTime()
+	 * > '2023-1-1 00:00:00'
+	 **/
+	formatTime(text?: string | number | Date, formatType?: string): string;
 	/**
 	 * 获取格式化后的时间
 	 * @param text （可选）需要格式化的字符串或者时间戳，默认：new Date()
@@ -834,11 +857,12 @@ class Utils {
 		formatType?:
 			| "yyyy-MM-dd HH:mm:ss"
 			| "yyyy/MM/dd HH:mm:ss"
-			| "yyyy年MM月dd日 HH时mm分ss秒"
-			| "yyyyMMdd"
 			| "yyyy_MM_dd_HH_mm_ss"
+			| "yyyy年MM月dd日 HH时mm分ss秒"
 			| "yyyy年MM月dd日 hh:mm:ss"
+			| "yyyy年MM月dd日 HH:mm:ss"
 			| "yyyy-MM-dd"
+			| "yyyyMMdd"
 			| "HH:mm:ss"
 	): string;
 	formatTime(text = new Date(), formatType = "yyyy-MM-dd HH:mm:ss") {
@@ -4155,6 +4179,25 @@ class Utils {
 	 * })
 	 */
 	waitNodeList<T extends HTMLElement>(nodeSelector: string): Promise<T>;
+	/**
+	 * 等待指定元素出现
+	 * @param nodeSelectors
+	 * @returns 当nodeSelectors为数组多个时，
+	 * 返回如：[ NodeList, NodeList ]，
+	 * 当nodeSelectors为单个时，
+	 * 返回如：NodeList。
+	 * NodeList元素与页面存在强绑定，当已获取该NodeList，但是页面中却删除了，该元素在NodeList中会被自动删除
+	 * @example
+	 * Utils.waitNodeList("div.xxx").then( nodeList =>{
+	 *  console.log(nodeList) // div.xxx => NodeList
+	 * })
+	 * @example
+	 * Utils.waitNodeList("div.xxx","a.xxx").then( nodeListArray =>{
+	 *  console.log(nodeListArray[0]) // div.xxx => NodeList
+	 *  console.log(nodeListArray[1]) // a.xxx => NodeList
+	 * })
+	 */
+	waitNodeList<T extends HTMLElement[]>(nodeSelector: string): Promise<T>;
 	/**
 	 * 等待指定元素出现，支持多个selector
 	 * @param nodeSelectors
@@ -4407,18 +4450,14 @@ class Utils {
 	 * )
 	 */
 	waitVueByInterval(
-		element:
-			| HTMLElement
-			| (() => any),
+		element: HTMLElement | (() => any),
 		propertyName: string | ((__vue__: any) => boolean),
 		timer?: number,
 		maxTime?: number,
 		vueName?: "__vue__" | string
 	): Promise<boolean>;
 	async waitVueByInterval(
-		element:
-			| HTMLElement
-			| (() => any),
+		element: HTMLElement | (() => any),
 		propertyName: string | ((__vue__: any) => boolean),
 		timer = 250,
 		maxTime = -1,