react-util-tools 1.0.28 → 1.0.29

package/dist/index.cjs

@@ -151,6 +151,7 @@ __export(index_exports, {
   maskIdCard: () => maskIdCard,
   maskName: () => maskName,
   maskPhone: () => maskPhone,
+  maskString: () => maskString,
   multiply: () => multiply,
   negate: () => negate,
   normalizeSpaces: () => normalizeSpaces,
@@ -1374,6 +1375,15 @@ function maskName(name) {
   }
   return name.charAt(0) + "*".repeat(name.length - 2) + name.charAt(name.length - 1);
 }
+function maskString(str, visibleChars = 3, mask = "...") {
+  if (!str) return "";
+  if (str.length <= visibleChars * 2) {
+    return str;
+  }
+  const start = str.slice(0, visibleChars);
+  const end = str.slice(-visibleChars);
+  return `${start}${mask}${end}`;
+}
 function isValidPhone(phone) {
   if (!phone) return false;
   return /^1[3-9]\d{9}$/.test(phone);
@@ -1557,6 +1567,7 @@ function fromBase64(base64) {
   maskIdCard,
   maskName,
   maskPhone,
+  maskString,
   multiply,
   negate,
   normalizeSpaces,

package/dist/index.d.cts

@@ -240,6 +240,7 @@ declare function maskPhone(phone: string): string;
 declare function maskIdCard(idCard: string): string;
 declare function maskBankCard(cardNumber: string): string;
 declare function maskName(name: string): string;
+declare function maskString(str: string, visibleChars?: number, mask?: string): string;
 declare function isValidPhone(phone: string): boolean;
 declare function isValidEmail(email: string): boolean;
 declare function isValidUrl(url: string): boolean;
@@ -247,4 +248,4 @@ declare function isValidIdCard(idCard: string): boolean;
 declare function toBase64(str: string): string;
 declare function fromBase64(base64: string): string;
 
-export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };
+export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, maskString, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.d.ts

@@ -240,6 +240,7 @@ declare function maskPhone(phone: string): string;
 declare function maskIdCard(idCard: string): string;
 declare function maskBankCard(cardNumber: string): string;
 declare function maskName(name: string): string;
+declare function maskString(str: string, visibleChars?: number, mask?: string): string;
 declare function isValidPhone(phone: string): boolean;
 declare function isValidEmail(email: string): boolean;
 declare function isValidUrl(url: string): boolean;
@@ -247,4 +248,4 @@ declare function isValidIdCard(idCard: string): boolean;
 declare function toBase64(str: string): string;
 declare function fromBase64(base64: string): string;
 
-export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };
+export { type AmountNum, type CookieOptions, abs, add, addDaysToDate, addDaysUTC, addMonthsToDate, addMonthsUTC, aoaToSheet, camelCase, capitalize, ceil, clearAllCookies, countOccurrences, debounceFn as debounce, divide, endsWith, equals, escapeHtml, exportExcelFile, exportJSONToExcel, extractNumbers, floor, formatDate, formatDateOnly, formatMoney, formatMoneyToChinese, formatNumber, formatPercent, formatRelativeTime, formatTimeOnly, formatUTC, formatUTCDateOnly, formatUTCTimeOnly, formateAmount, formateFaitAmount, formatePrecision, fromBase64, fromUTC, getAllCookies, getAllQueryParams, getBrowser, getBrowserEngine, getBrowserVersion, getCookie, getDaysDiff, getDeviceInfo, getDevicePixelRatio, getDeviceType, getEndOfDay, getEndOfMonth, getEndOfWeek, getEndOfYear, getHoursDiff, getMinutesDiff, getOS, getQueryParam, getQueryParamAll, getScreenResolution, getSheet, getSheetNames, getStartOfDay, getStartOfMonth, getStartOfWeek, getStartOfYear, getTimestamp, getTimestampInSeconds, getTimezoneOffset, getTimezoneOffsetHours, getUTCAllWeeksInYear, getUTCDaysDiff, getUTCEndOfDay, getUTCEndOfMonth, getUTCHoursDiff, getUTCMinutesDiff, getUTCNow, getUTCStartOfDay, getUTCStartOfMonth, getUTCTimestamp, getUTCTimestampInSeconds, getUTCWeekEnd, getUTCWeekNumber, getUTCWeekStart, getUTCWeeksInYear, getUTCYearEnd, getUTCYearEndTimestamp, getUTCYearStart, getUTCYearStartTimestamp, getViewportSize, greaterThan, greaterThanOrEqual, hasCookie, includes, integerTokenArr, isAfterDate, isAndroid, isBeforeDate, isDesktop, isEmpty, isIOS, isMobile, isNotEmpty, isSameDayDate, isTablet, isTouchDevice, isValidDate, isValidEmail, isValidIdCard, isValidPhone, isValidUrl, isWeChat, jsonToWorkbook, kebabCase, length, lessThan, lessThanOrEqual, maskBankCard, maskEmail, maskIdCard, maskName, maskPhone, maskString, multiply, negate, normalizeSpaces, padEnd, padStart, parseDate, parseMoney, pascalCase, randomString, read, readExcelFile, readExcelToJSON, readFile, removeCookie, removeInvalidZero, removeSpaces, repeat, replaceAll, reverse, round, setCookie, sheetToAOA, sheetToCSV, sheetToHTML, snakeCase, split, startsWith, stripHtml, subDaysFromDate, subDaysUTC, subMonthsFromDate, subMonthsUTC, subtract, tableToSheet, throttleFn as throttle, titleCase, toBase64, toISOString, toLocalString, toLowerCase, toUTC, toUpperCase, trim, trimEnd, trimStart, truncate, tryRun, unescapeHtml, unmaskEmail, utils, uuid, workbookToJSON, write, writeFile, writeFileXLSX };

package/dist/index.js

@@ -1206,6 +1206,15 @@ function maskName(name) {
   }
   return name.charAt(0) + "*".repeat(name.length - 2) + name.charAt(name.length - 1);
 }
+function maskString(str, visibleChars = 3, mask = "...") {
+  if (!str) return "";
+  if (str.length <= visibleChars * 2) {
+    return str;
+  }
+  const start = str.slice(0, visibleChars);
+  const end = str.slice(-visibleChars);
+  return `${start}${mask}${end}`;
+}
 function isValidPhone(phone) {
   if (!phone) return false;
   return /^1[3-9]\d{9}$/.test(phone);
@@ -1388,6 +1397,7 @@ export {
   maskIdCard,
   maskName,
   maskPhone,
+  maskString,
   multiply,
   negate,
   normalizeSpaces,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-util-tools",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "description": "A collection of useful utilities: throttle, debounce, date formatting, device detection, money formatting, decimal calculations, Excel processing and more",
   "type": "module",
   "main": "dist/index.cjs",

package/src/index.ts

@@ -195,6 +195,7 @@ export {
   maskIdCard,
   maskBankCard,
   maskName,
+  maskString,
   isValidPhone,
   isValidEmail,
   isValidUrl,

package/src/string/README.md

@@ -90,6 +90,7 @@ import {
   maskIdCard,
   maskBankCard,
   maskName,
+  maskString,
   maskEmail
 } from 'react-util-tools'
 
@@ -106,6 +107,22 @@ maskBankCard('6222021234567890') // '6222 **** **** 7890'
 maskName('张三') // '张*'
 maskName('李四光') // '李*光'
 
+// 通用字符串脱敏
+maskString('123wedwdwddwed567', 3) // '123...567'
+maskString('abcdefghijk', 2) // 'ab...jk'
+maskString('hello', 2, '***') // 'he***lo'
+
+// 邮箱脱敏（在 format 模块）
+maskEmail('test@example.com') // 'tes***@example.com'
+```
+
+// 银行卡号脱敏
+maskBankCard('6222021234567890') // '6222 **** **** 7890'
+
+// 姓名脱敏
+maskName('张三') // '张*'
+maskName('李四光') // '李*光'
+
 // 邮箱脱敏（在 format 模块）
 maskEmail('test@example.com') // 'tes***@example.com'
 ```
@@ -318,6 +335,7 @@ extractNumbers('abc123def456') // [123, 456]
 - `maskIdCard(idCard)` - 身份证号脱敏
 - `maskBankCard(cardNumber)` - 银行卡号脱敏
 - `maskName(name)` - 姓名脱敏
+- `maskString(str, visibleChars?, mask?)` - 通用字符串脱敏
 
 ### 格式验证
 

package/src/string/index.ts

@@ -428,6 +428,31 @@ export function maskName(name: string): string {
   return name.charAt(0) + '*'.repeat(name.length - 2) + name.charAt(name.length - 1)
 }
 
+/**
+ * 通用字符串脱敏：保留前后指定位数，中间用省略号替换
+ * @param str 字符串
+ * @param visibleChars 前后各保留的字符数，默认 3
+ * @param mask 脱敏符号，默认 '...'
+ * @returns 脱敏后的字符串
+ * @example
+ * maskString('123wedwdwddwed567', 3) // '123...567'
+ * maskString('abcdefghijk', 2) // 'ab...jk'
+ * maskString('hello', 2, '***') // 'he***lo'
+ */
+export function maskString(str: string, visibleChars = 3, mask = '...'): string {
+  if (!str) return ''
+  
+  // 如果字符串长度小于等于需要显示的字符数，直接返回原字符串
+  if (str.length <= visibleChars * 2) {
+    return str
+  }
+  
+  const start = str.slice(0, visibleChars)
+  const end = str.slice(-visibleChars)
+  
+  return `${start}${mask}${end}`
+}
+
 /**
  * 判断是否为有效的手机号（中国大陆）
  * @param phone 手机号