86 lines
2.5 KiB
TypeScript
86 lines
2.5 KiB
TypeScript
// @ts-nocheck
|
||
// import assertString from './util/assertString';
|
||
|
||
/**
|
||
* 字节长度验证配置选项
|
||
*/
|
||
export type IsByteLengthOptions = {
|
||
/** 允许的最小字节长度 */
|
||
min ?: number;
|
||
/** 允许的最大字节长度 */
|
||
max ?: number;
|
||
}
|
||
|
||
/**
|
||
* 检查字符串字节长度是否在指定范围内
|
||
* @function
|
||
* @overload 使用配置对象
|
||
* @param str - 要检查的字符串
|
||
* @param options - 配置选项对象
|
||
* @returns 是否满足字节长度要求
|
||
*
|
||
* @overload 使用独立参数
|
||
* @param str - 要检查的字符串
|
||
* @param min - 最小字节长度
|
||
* @param max - 最大字节长度（可选）
|
||
* @returns 是否满足字节长度要求
|
||
*
|
||
* @example
|
||
* // 使用配置对象
|
||
* isByteLength('🇨🇳', { min: 4, max: 8 }); // true（unicode 国旗符号占 8 字节）
|
||
*
|
||
* @example
|
||
* // 旧式参数调用
|
||
* isByteLength('hello', 3, 7); // true（实际字节长度 5）
|
||
*
|
||
* @description
|
||
* 1. 使用 URL 编码计算字节长度（更准确处理多字节字符）
|
||
* 2. 同时支持两种参数格式：
|
||
* - 配置对象格式 { min, max }
|
||
* - 独立参数格式 (min, max)
|
||
* 3. 不传 max 参数时只验证最小长度
|
||
* 4. 严格空值处理，允许设置 0 值
|
||
*/
|
||
export function isByteLength(str : string, optionsOrMin ?: IsByteLengthOptions) : boolean;
|
||
export function isByteLength(str : string, optionsOrMin ?: number) : boolean;
|
||
export function isByteLength(str : string, optionsOrMin : number, maxParam : number | null) : boolean;
|
||
export function isByteLength(
|
||
str : string,
|
||
optionsOrMin ?: IsByteLengthOptions | number,
|
||
maxParam : number | null = null
|
||
) : boolean {
|
||
// assertString(str);
|
||
|
||
/** 最终计算的最小长度 */
|
||
let min: number;
|
||
|
||
/** 最终计算的最大长度 */
|
||
let max : number | null;
|
||
|
||
// 参数逻辑处理
|
||
if (optionsOrMin != null && typeof optionsOrMin == 'object') {
|
||
// 使用对象配置的情况
|
||
const options = optionsOrMin as IsByteLengthOptions;
|
||
min = Math.max(options.min ?? 0, 0); // 确保最小值为正整数
|
||
max = options.max;
|
||
} else {
|
||
// 使用独立参数的情况
|
||
min = Math.max(
|
||
typeof optionsOrMin == 'number' ? optionsOrMin : 0,
|
||
0
|
||
);
|
||
max = maxParam;
|
||
}
|
||
|
||
// URL 编码后的字节长度计算
|
||
const encoded = encodeURI(str);
|
||
const len = (encoded?.split(/%..|./).length ?? 0) - 1;
|
||
|
||
// 执行验证逻辑
|
||
// #ifndef APP-ANDROID
|
||
return len >= min && (typeof max == 'undefined' || len <= (max ?? 0));
|
||
// #endif
|
||
// #ifdef APP-ANDROID
|
||
return len >= min && (max == null || len <= max);
|
||
// #endif
|
||
} |