xjs-common 13.5.0 → 13.5.1

package/README.md

@@ -14,7 +14,7 @@ if you has been used the features (e.g. `HttpResolver`, `UFile`), please use the
 # Code example (only part)
 ### Miscellaneous utilities.
 ```ts
-import { delay, int2array, UHttp, retry, MaybeArray, Loggable } from "xjs-common";
+import { delay, int2array, UHttp, retry, MaybeArray, Loggable, valueof } from "xjs-common";
 
 (async () => {
     // await 3 seconds.
@@ -35,8 +35,9 @@ import { delay, int2array, UHttp, retry, MaybeArray, Loggable } from "xjs-common
     console.log(UHttp.isHttpSuccess(204));
     // https://aaa.com?p1=a&p2=1&p2=2
     console.log(UHttp.concatParamsWithEncoding("https://aaa.com", { p1: "a", p2: ["1", "2"] }));
-    // p1=a&p2=1&p2=2
-    console.log(UHttp.concatParamsWithEncoding(null, { p1: "a", p2: ["1", "2"] }));
+    // checks and casts a value like enum valueof.
+    enum EnumA { A = "a", B = "b" }
+    const e: EnumA = valueof(EnumA, "a");
 })();
 ```
 ### Array utilities.

package/build/cjs/func/u.js

@@ -4,6 +4,7 @@ exports.getJSTDate = getJSTDate;
 exports.delay = delay;
 exports.int2array = int2array;
 exports.retry = retry;
+exports.valueof = valueof;
 const xjs_err_1 = require("../obj/xjs-err");
 const u_type_1 = require("./u-type");
 const s_errCode = 10;
@@ -76,3 +77,17 @@ function retry(cb, op) {
     };
     return prcs(initialCount);
 }
+/**
+ * this checks whether the object (**mainly enum**) has the value or not.
+ * if true this returns the value as value type of the object.
+ * ```js
+ * enum EnumA {
+ *   A = "a",
+ *   B = "b"
+ * }
+ * const enm: EnumA = valueof(EnumA, "a");
+ * ```
+ */
+function valueof(o, v) {
+    return Object.values(o).find(v2 => v2 === v);
+}

package/build/esm/func/u.d.ts

@@ -1,4 +1,4 @@
-import { Loggable, MaybePromise } from "../const/types";
+import { IndexSignature, Loggable, MaybePromise } from "../const/types";
 export declare function getJSTDate(d?: Date | number): Date;
 export declare function delay(sec: number): Promise<void>;
 export declare function int2array(size: number): number[];
@@ -41,3 +41,17 @@ export declare function retry<T>(cb: () => T, op?: SyncRetryOption): T;
 export declare function retry<T>(cb: () => T, op?: AsyncRetryOption): Promise<T>;
 export declare function retry<T>(cb: () => Promise<T>, op?: SyncRetryOption): Promise<T>;
 export declare function retry<T>(cb: () => Promise<T>, op?: AsyncRetryOption): Promise<T>;
+/**
+ * this checks whether the object (**mainly enum**) has the value or not.
+ * if true this returns the value as value type of the object.
+ * ```js
+ * enum EnumA {
+ *   A = "a",
+ *   B = "b"
+ * }
+ * const enm: EnumA = valueof(EnumA, "a");
+ * ```
+ */
+export declare function valueof<E extends {
+    [k: string]: IndexSignature;
+}>(o: E, v: IndexSignature): (typeof o)[keyof typeof o];

package/build/esm/func/u.js

@@ -70,3 +70,17 @@ export function retry(cb, op) {
     };
     return prcs(initialCount);
 }
+/**
+ * this checks whether the object (**mainly enum**) has the value or not.
+ * if true this returns the value as value type of the object.
+ * ```js
+ * enum EnumA {
+ *   A = "a",
+ *   B = "b"
+ * }
+ * const enm: EnumA = valueof(EnumA, "a");
+ * ```
+ */
+export function valueof(o, v) {
+    return Object.values(o).find(v2 => v2 === v);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xjs-common",
-  "version": "13.5.0",
+  "version": "13.5.1",
   "description": "library modules for typescript that bundled general-purpose implementations.",
   "repository": {
     "type": "git",