@nickyzj2023/utils 1.0.24 → 1.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nickyzj2023/utils",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "type": "module",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/is.ts

@@ -11,7 +11,10 @@ export type Falsy = false | 0 | -0 | 0n | "" | null | undefined;
 
 /**
  * 检测传入的值是否为**普通对象**
- * @returns 如果是普通对象，返回 true，否则返回 false
+ *
+ * @example
+ * const obj = { a: 1 };
+ * isObject(obj); // true
  */
 export const isObject = (value: any): value is object => {
 	return value?.constructor === Object;
@@ -19,7 +22,10 @@ export const isObject = (value: any): value is object => {
 
 /**
  * 检测传入的值是否为**原始值**（number、string、boolean、symbol、bigint、undefined、null）
- * @returns 如果是原始值，返回 true，否则返回 false
+ *
+ * @example
+ * isPrimitive(1);  // true
+ * isPrimitive([]); // false
  */
 export const isPrimitive = (value: any): value is Primitive => {
 	return (
@@ -30,14 +36,34 @@ export const isPrimitive = (value: any): value is Primitive => {
 };
 
 /**
- * 检测传入的值是否为**false值**（false、0、''、null、undefined、NaN等）
+ * 检测传入的值是否为**假值**（false、0、''、null、undefined、NaN等）
+ *
+ * @example
+ * isFalsy(""); // true
+ * isFalsy(1); // false
  */
 export const isFalsy = (value: any): value is Falsy => {
 	return !value;
 };
 
+/**
+ * 检测传入的值是否为**真值**
+ *
+ * @example
+ * isTruthy(1); // true
+ * isTruthy(""); // false
+ */
+export const isTruthy = (value: any): value is any => {
+	return !!value;
+};
+
 /**
  * 检测传入的值是否为**空值**（null、undefined）
+ *
+ * @example
+ * isNil(null); // true
+ * isNil(undefined); // true
+ * isNil(1); // false
  */
 export const isNil = (value: any): value is null | undefined => {
 	return value === null || value === undefined;

package/src/network.ts

@@ -75,6 +75,11 @@ export const fetcher = (baseURL = "", baseOptions: RequestInit = {}) => {
 		// 发送请求
 		const response = await fetch(url, options);
 		if (!response.ok) {
+			// 如果后端给了报错详情，则先解析再抛出
+			const contentType = response.headers.get("Content-Type");
+			if (contentType?.startsWith("application/json")) {
+				throw await response.json();
+			}
 			throw new Error(response.statusText);
 		}
 
@@ -111,13 +116,12 @@ export const fetcher = (baseURL = "", baseOptions: RequestInit = {}) => {
  * @example
  * const [error, response] = await to(fetcher().get<Blog>("/blogs/hello-world"));
  */
-export const to = async <T, U = Error>(
+export const to = async <T, E = Error>(
 	promise: Promise<T>,
-): Promise<[null, T] | [U, undefined]> => {
+): Promise<[null, T] | [E, undefined]> => {
 	try {
-		const response = await promise;
-		return [null, response];
-	} catch (error) {
-		return [error as U, undefined];
+		return [null, await promise];
+	} catch (e) {
+		return [e as E, undefined];
 	}
 };

package/src/string.ts

@@ -40,3 +40,20 @@ export const capitalize = (s: string) => {
 export const decapitalize = (s: string) => {
 	return s.charAt(0).toLowerCase() + s.slice(1);
 };
+
+/**
+ * 图片地址转 base64 数据
+ *
+ * @example
+ * imageUrlToBase64("https://example.com/image.jpg"); // "data:image/jpeg;base64,..."
+ */
+export const imageUrlToBase64 = async (imageUrl: string) => {
+	if (!imageUrl.startsWith("http")) {
+		throw new Error("图片地址必须以http或https开头");
+	}
+
+	const response = await fetch(imageUrl);
+	const arrayBuffer = await response.arrayBuffer();
+	const base64 = Buffer.from(arrayBuffer).toString("base64");
+	return `data:image/jpeg;base64,${base64}`;
+};