@whitesev/utils 2.5.5 → 2.5.7

package/dist/types/src/Utils.d.ts

@@ -1422,6 +1422,53 @@ declare class Utils {
      * await Utils.waitArrayLoopToEnd([callback,callback,callback],xxxcallback);
      **/
     waitArrayLoopToEnd(data: any[] | HTMLElement[], handleFunc: Function): Promise<void[]>;
+    /**
+     * 等待任意事件成立
+     *
+     * 运行方式为根据页面元素的改变而触发回调
+     * @param checkFn 检测的函数
+     * @param timeout 超时时间，默认0
+     * @param parent （可选）父元素，默认document
+     * @example
+     * Utils.wait(()=> {
+     *   let $test = document.querySelector("#test");
+     *   return {
+     *     success: $test !== null,
+     *     data:  $test
+     *   }
+     * })
+     */
+    wait<T extends any>(checkFn: (...args: any[]) => {
+        /**
+         * 是否检测成功
+         */
+        success: boolean;
+        /**
+         * 返回的值
+         */
+        data: T;
+    }, timeout?: null | undefined, parent?: Node | Element | Document | HTMLElement): Promise<T>;
+    wait<T extends any>(checkFn: (...args: any[]) => {
+        /**
+         * 是否检测成功
+         */
+        success: boolean;
+        /**
+         * 返回的值
+         */
+        data: T;
+    }, timeout?: number, parent?: Node | Element | Document | HTMLElement): Promise<T | null>;
+    /**
+     * 等待元素出现
+     * @param selectorFn 获取元素的函数
+     * @param timeout 超时时间，默认0
+     * @example
+     * Utils.waitNode(()=>document.querySelector("div"), 1000).then( $div =>{
+     *  console.log($div); // $div => HTMLDivELement | null
+     * })
+     */
+    waitNode<K extends any>(selectorFn: () => K | null | undefined): Promise<K>;
+    waitNode<K extends any>(selectorFn: () => K | null | undefined, timeout: number): Promise<K | null | undefined>;
     /**
      * 等待元素出现
      * @param selector CSS选择器
@@ -1430,7 +1477,7 @@ declare class Utils {
      * Utils.waitNode("div").then( $div =>{
      *  console.log($div); // div => HTMLDivELement
      * })
-     * Utils.waitNode("div",document).then( $div =>{
+     * Utils.waitNode("div", document).then( $div =>{
      *  console.log($div); // div => HTMLDivELement
      * })
      */
@@ -1444,7 +1491,7 @@ declare class Utils {
      * Utils.waitNode(["div"]).then( ([$div]) =>{
      *  console.log($div); // div => HTMLDivELement[]
      * })
-     * Utils.waitNode(["div"],document).then( ([$div]) =>{
+     * Utils.waitNode(["div"], document).then( ([$div]) =>{
      *  console.log($div); // div => HTMLDivELement[]
      * })
      */
@@ -1456,7 +1503,7 @@ declare class Utils {
      * @param parent 父元素，默认document
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNode("div",document,1000).then( $div =>{
+     * Utils.waitNode("div", document, 1000).then( $div =>{
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
@@ -1468,7 +1515,7 @@ declare class Utils {
      * @param parent 父元素，默认document
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNode(["div"],document,1000).then( ([$div]) =>{
+     * Utils.waitNode(["div"], document, 1000).then( ([$div]) =>{
      *  console.log($div); // $div => HTMLDivELement[] | null
      * })
      */
@@ -1479,7 +1526,7 @@ declare class Utils {
      * @param selector CSS选择器
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNode("div",1000).then( $div =>{
+     * Utils.waitNode("div", 1000).then( $div =>{
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
@@ -1490,7 +1537,7 @@ declare class Utils {
      * @param selectorList CSS选择器数组
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNode(["div"],1000).then( [$div] =>{
+     * Utils.waitNode(["div"], 1000).then( [$div] =>{
      *  console.log($div); // $div => HTMLDivELement[] | null
      * })
      */
@@ -1504,7 +1551,7 @@ declare class Utils {
      * Utils.waitAnyNode(["div","div"]).then( $div =>{
      *  console.log($div); // $div => HTMLDivELement 这里是第一个
      * })
-     * Utils.waitAnyNode(["a","div"],document).then( $a =>{
+     * Utils.waitAnyNode(["a","div"], document).then( $a =>{
      *  console.log($a); // $a => HTMLAnchorElement 这里是第一个
      * })
      */
@@ -1516,7 +1563,7 @@ declare class Utils {
      * @param parent 父元素，默认document
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitAnyNode(["div","div"],document,10000).then( $div =>{
+     * Utils.waitAnyNode(["div","div"], document, 10000).then( $div =>{
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
@@ -1527,7 +1574,7 @@ declare class Utils {
      * @param selectorList CSS选择器数组
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitAnyNode(["div","div"],10000).then( $div =>{
+     * Utils.waitAnyNode(["div","div"], 10000).then( $div =>{
      *  console.log($div); // $div => HTMLDivELement | null
      * })
      */
@@ -1541,7 +1588,7 @@ declare class Utils {
      * Utils.waitNodeList("div").then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>
      * })
-     * Utils.waitNodeList("div",document).then( $result =>{
+     * Utils.waitNodeList("div", document).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>
      * })
      */
@@ -1555,7 +1602,7 @@ declare class Utils {
      * Utils.waitNodeList(["div"]).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>[]
      * })
-     * Utils.waitNodeList(["div"],document).then( $result =>{
+     * Utils.waitNodeList(["div"], document).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>[]
      * })
      */
@@ -1567,7 +1614,7 @@ declare class Utils {
      * @param parent 监听的父元素
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNodeList("div",document,10000).then( $result =>{
+     * Utils.waitNodeList("div", document, 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
      * })
      */
@@ -1579,7 +1626,7 @@ declare class Utils {
      * @param parent 监听的父元素
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNodeList(["div"],document,10000).then( $result =>{
+     * Utils.waitNodeList(["div"], document, 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>[] | null
      * })
      */
@@ -1590,7 +1637,7 @@ declare class Utils {
      * @param selector CSS选择器数组
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNodeList("div",10000).then( $result =>{
+     * Utils.waitNodeList("div", 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
      * })
      */
@@ -1601,7 +1648,7 @@ declare class Utils {
      * @param selectorList CSS选择器数组
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitNodeList(["div"],10000).then( $result =>{
+     * Utils.waitNodeList(["div"], 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>[] | null
      * })
      */
@@ -1615,7 +1662,7 @@ declare class Utils {
      * Utils.waitAnyNodeList(["div","a"]).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>
      * })
-     * Utils.waitAnyNodeList(["div","a"],document).then( $result =>{
+     * Utils.waitAnyNodeList(["div","a"], document).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement>
      * })
      */
@@ -1627,7 +1674,7 @@ declare class Utils {
      * @param parent 父元素，默认document
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitAnyNodeList(["div","a"],document,10000).then( $result =>{
+     * Utils.waitAnyNodeList(["div","a"], document, 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
      * })
      */
@@ -1638,7 +1685,7 @@ declare class Utils {
      * @param selectorList CSS选择器数组
      * @param timeout 超时时间，默认0
      * @example
-     * Utils.waitAnyNodeList(["div","div"],10000).then( $result =>{
+     * Utils.waitAnyNodeList(["div","div"], 10000).then( $result =>{
      *  console.log($result); // $result => NodeListOf<HTMLDivElement> | null
      * })
      */

package/dist/types/src/UtilsGMCookie.d.ts

@@ -32,5 +32,14 @@ declare class UtilsGMCookie {
      * @param callback 删除操作后的回调(成功/失败)
      */
     delete(option: UtilsGMCookieDeleteOptions, callback?: (error?: Error) => void): void;
+    /**
+     * 解析cookie字符串
+     * 例如：document.cookie
+     * @param cookieStr
+     */
+    parseCookie(cookieStr: string): {
+        key: string;
+        value: string;
+    }[];
 }
 export { UtilsGMCookie };

package/dist/types/src/types/global.d.ts

@@ -25,3 +25,4 @@ export declare interface AnyObject {
 export type PartialKeys<T, K extends keyof T> = {
 	[P in K]?: T[P];
 };
+export type Values<T> = T[keyof T];

package/package.json

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