@nickyzj2023/utils 1.0.24 → 1.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nickyzj2023/utils",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "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/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}`;
+};