@base-web-kits/base-tools-ts 0.9.10 → 0.9.12

package/dist/string/other.d.ts

@@ -1,15 +1,17 @@
 /**
- * 计算字符串在 UTF-8 编码下的字节长度。
- * 使用场景：
- * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
- * 2) 评估网络传输、缓存（Redis/消息队列）开销
- * 3) 根据字节数截断或提示用户（而非按字符数）
- * @param str 输入的字符串
- * @returns 字符串的字节长度
+ * 获取字节长度 (支持字符串、Buffer/Uint8Array、File/Blob 等类型)
+ * - 字符串按 UTF-8 编码计算字节长度（每个字符 1-4 字节）
+ * - Buffer/Uint8Array 直接返回字节长度（每个元素 1 字节）
+ * - File/Blob 返回文件/Blob 大小（字节数）
+ * @param data 输入的数据
+ * @returns 数据的字节长度
  * @example
- * getStringByteLength('abc') // 3
- * getStringByteLength('中文') // 6
- * getStringByteLength('😊') // 4
+ * getByteLength('abc') // 3
+ * getByteLength('中文') // 6
+ * getByteLength('😊') // 4
+ * getByteLength(new Uint8Array([0x41, 0x42, 0x43])) // 3
+ * getByteLength(new File(['abc'], 'test.txt')) // 3
+ * getByteLength(new Blob(['中文'], { type: 'text/plain' })) // 6
  */
-export declare function getStringByteLength(str: string): number;
+export declare function getByteLength(data: string | ArrayBuffer | ArrayBufferView | File | Blob): number;
 //# sourceMappingURL=other.d.ts.map

package/dist/string/other.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../src/ts/string/other.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBvD"}
+{"version":3,"file":"other.d.ts","sourceRoot":"","sources":["../../src/ts/string/other.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CA6BhG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base-web-kits/base-tools-ts",
-  "version": "0.9.10",
+  "version": "0.9.12",
   "sideEffects": false,
   "description": "Independent TS utilities package built from src/ts.",
   "keywords": [

package/src/ts/day/index.ts

@@ -121,7 +121,7 @@ export function getDateRangeAfter(offset: number, fmt = 'YYYY-MM-DD') {
  * @returns 包含天、时、分、秒、毫秒的零填充对象
  * @example
  * const diff = toDayjs(t).diff(); // 毫秒差值
- * const parts = getCountdownParts(diff); // { d: '01', h: '02', m: '03', s: '04', ms: '567' }
+ * const parts = getCountdownParts(diff); // { d: '00', h: '00', m: '00', s: '00', ms: '000' }
  */
 export function getCountdownParts(diff: number) {
   if (diff <= 0) return { d: '00', h: '00', m: '00', s: '00', ms: '000' };

package/src/ts/string/other.ts

@@ -1,33 +1,45 @@
 /**
- * 计算字符串在 UTF-8 编码下的字节长度。
- * 使用场景：
- * 1) 按字节限制表单输入（避免超过后端/数据库字段上限）
- * 2) 评估网络传输、缓存（Redis/消息队列）开销
- * 3) 根据字节数截断或提示用户（而非按字符数）
- * @param str 输入的字符串
- * @returns 字符串的字节长度
+ * 获取字节长度 (支持字符串、Buffer/Uint8Array、File/Blob 等类型)
+ * - 字符串按 UTF-8 编码计算字节长度（每个字符 1-4 字节）
+ * - Buffer/Uint8Array 直接返回字节长度（每个元素 1 字节）
+ * - File/Blob 返回文件/Blob 大小（字节数）
+ * @param data 输入的数据
+ * @returns 数据的字节长度
  * @example
- * getStringByteLength('abc') // 3
- * getStringByteLength('中文') // 6
- * getStringByteLength('😊') // 4
+ * getByteLength('abc') // 3
+ * getByteLength('中文') // 6
+ * getByteLength('😊') // 4
+ * getByteLength(new Uint8Array([0x41, 0x42, 0x43])) // 3
+ * getByteLength(new File(['abc'], 'test.txt')) // 3
+ * getByteLength(new Blob(['中文'], { type: 'text/plain' })) // 6
  */
-export function getStringByteLength(str: string): number {
-  let byteLen = 0;
+export function getByteLength(data: string | ArrayBuffer | ArrayBufferView | File | Blob): number {
+  if (typeof data === 'string') {
+    let byteLen = 0;
 
-  for (let i = 0; i < str.length; i++) {
-    const code = str.charCodeAt(i);
+    for (let i = 0; i < data.length; i++) {
+      const code = data.charCodeAt(i);
 
-    if (code <= 0x7f) {
-      byteLen += 1; // （ASCII 基本拉丁）→ 包含数字 0-9、英文字母 A-Z/a-z、常见符号
-    } else if (code <= 0x7ff) {
-      byteLen += 2; // （拉丁扩展）→ 包含拉丁字母（含变音符）、希腊文、俄文/西里尔文、希伯来文、阿拉伯文等
-    } else if (code >= 0xd800 && code <= 0xdbff) {
-      byteLen += 4; // （UTF-16 代理项）→ 包含 emoji、稀有汉字（扩展区）、音乐符号等
-      i++;
-    } else {
-      byteLen += 3; // （BMP 绝大部分）→ 包含中文/日文/韩文的大多数字符（CJK 统一汉字）、以及大量其它脚本
+      if (code <= 0x7f) {
+        byteLen += 1; // （ASCII 基本拉丁）→ 包含数字 0-9、英文字母 A-Z/a-z、常见符号
+      } else if (code <= 0x7ff) {
+        byteLen += 2; // （拉丁扩展）→ 包含拉丁字母（含变音符）、希腊文、俄文/西里尔文、希伯来文、阿拉伯文等
+      } else if (code >= 0xd800 && code <= 0xdbff) {
+        byteLen += 4; // （UTF-16 代理项）→ 包含 emoji、稀有汉字（扩展区）、音乐符号等
+        i++;
+      } else {
+        byteLen += 3; // （BMP 绝大部分）→ 包含中文/日文/韩文的大多数字符（CJK 统一汉字）、以及大量其它脚本
+      }
     }
+
+    return byteLen;
   }
 
-  return byteLen;
+  // Buffer/Uint8Array
+  if ('byteLength' in data) return data.byteLength;
+
+  // File/Blob
+  if ('size' in data) return data.size;
+
+  throw new TypeError('getByteLength: Unsupported type');
 }