a2bei4-utils 1.0.2 → 1.0.4

package/dist/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sources":["../src/source/date.js"],"sourcesContent":["/**\n * 将任意值安全转换为 Date 对象。\n * - 数字／数字字符串：视为时间戳\n * - 字符串：尝试按 ISO/RFC 格式解析\n * - 对象：优先 valueOf()，再 toString()\n * - null / undefined / 无效值：返回 null\n *\n * @param {*} val - 待转换值\n * @returns {Date | null} 有效 Date 或 null\n */\nexport function toDate(val) {\n    if (val == null) return null; // null / undefined\n    if (val instanceof Date) return isNaN(val) ? null : val; // 已是 Date，但需排除 Invalid Date\n\n    // 1. 数字或数字字符串 → 时间戳\n    if (typeof val === \"number\" || (typeof val === \"string\" && /^-?\\d+(\\.\\d+)?$/.test(val.trim()))) {\n        const d = new Date(+val);\n        return isNaN(d) ? null : d;\n    }\n\n    // 2. 标准 ISO 8601 / RFC 2825 等合法字符串\n    if (typeof val === \"string\") {\n        const d = new Date(val);\n        return isNaN(d) ? null : d; // 非法格式返回 null\n    }\n\n    // 3. 对象带 valueOf / toString\n    if (typeof val === \"object\") {\n        // 优先调用 valueOf（期望返回数字时间戳）\n        const prim = val.valueOf ? val.valueOf() : Object.prototype.valueOf.call(val);\n        if (typeof prim === \"number\" && !isNaN(prim)) {\n            const d = new Date(prim);\n            return isNaN(d) ? null : d;\n        }\n        // 兜底用字符串\n        const str = val.toString ? val.toString() : String(val);\n        const d = new Date(str);\n        return isNaN(d) ? null : d;\n    }\n\n    // 4. 其余情况\n    return null;\n}\n\n/**\n * 在闭区间 [date1, date2] 内随机生成一个日期（含首尾）。\n * 若顺序相反则自动交换。\n *\n * @param {Date} date1 - 起始日期\n * @param {Date} date2 - 结束日期\n * @returns {Date} 随机日期\n */\nexport function randomDateInRange(date1, date2) {\n    let v1 = date1.getTime(),\n        v2 = date2.getTime();\n    if (v1 > v2) [v1, v2] = [v2, v1];\n    return new Date(v1 + Math.floor(Math.random() * (v2 - v1 + 1)));\n}\n\n/**\n * 计算两个时间之间的剩余/已过时长（天-时-分-秒），返回带补零的展示对象。\n *\n * @param {string|number|Date} originalTime - 原始时间（可转 Date 的任意值）\n * @param {Date} [currentTime=new Date()] - 基准时间，默认当前\n * @returns {{days:number,hours:string,minutes:string,seconds:string}}\n */\nexport function calcTimeDifference(originalTime, currentTime = new Date()) {\n    // 计算时间差（毫秒）\n    const diffMs = currentTime - new Date(originalTime);\n\n    // 转换为天、小时、分钟、秒\n    const diffSeconds = Math.floor(diffMs / 1000);\n    const days = Math.floor(diffSeconds / (3600 * 24));\n    const hours = Math.floor((diffSeconds % (3600 * 24)) / 3600);\n    const minutes = Math.floor((diffSeconds % 3600) / 60);\n    const seconds = diffSeconds % 60;\n\n    const padZero = (num) => String(num).padStart(2, \"0\");\n\n    return {\n        days,\n        hours: padZero(hours),\n        minutes: padZero(minutes),\n        seconds: padZero(seconds)\n    };\n}\n\n/**\n * 将总秒数格式化成人类可读的时间段文本。\n * 固定进制：1 年=365 天，1 月=30 天。\n *\n * @param {number} totalSeconds - 非负总秒数\n * @param {object} [options] - 格式化选项\n * @param {Partial<{year:string,month:string,day:string,hour:string,minute:string,second:string}>} [options.labels] - 各单位的自定义文本\n * @param {('year'|'month'|'day'|'hour'|'minute'|'second')} [options.maxUnit] - 最大输出单位\n * @param {('year'|'month'|'day'|'hour'|'minute'|'second')} [options.minUnit] - 最小输出单位\n * @param {boolean} [options.showZero] - 是否强制显示 0 秒\n * @returns {string} 拼接后的时长文本，如“1天 02小时 30分钟”\n * @throws {TypeError} 当 totalSeconds 为非数字或负数时抛出\n */\nexport function formatDuration(totalSeconds, options = {}) {\n    if (typeof totalSeconds !== \"number\" || totalSeconds < 0 || !isFinite(totalSeconds)) {\n        throw new TypeError(\"totalSeconds 必须是非负数字\");\n    }\n\n    // 1. 默认中文单位\n    const DEFAULT_LABELS = {\n        year: \"年\",\n        month: \"月\",\n        day: \"天\",\n        hour: \"小时\",\n        minute: \"分钟\",\n        second: \"秒\"\n    };\n\n    // 2. 固定进制表（秒）\n    const UNIT_TABLE = [\n        { key: \"year\", seconds: 365 * 24 * 3600 },\n        { key: \"month\", seconds: 30 * 24 * 3600 },\n        { key: \"day\", seconds: 24 * 3600 },\n        { key: \"hour\", seconds: 3600 },\n        { key: \"minute\", seconds: 60 },\n        { key: \"second\", seconds: 1 }\n    ];\n\n    // 3. 合并用户自定义文本\n    const labels = Object.assign({}, DEFAULT_LABELS, options.labels);\n\n    // 4. 根据 maxUnit / minUnit 截取\n    let start = 0,\n        end = UNIT_TABLE.length;\n    if (options.maxUnit) {\n        const idx = UNIT_TABLE.findIndex((u) => u.key === options.maxUnit);\n        if (idx !== -1) start = idx;\n    }\n    if (options.minUnit) {\n        const idx = UNIT_TABLE.findIndex((u) => u.key === options.minUnit);\n        if (idx !== -1) end = idx + 1;\n    }\n    const units = UNIT_TABLE.slice(start, end);\n    if (!units.length) units.push(UNIT_TABLE[UNIT_TABLE.length - 1]); // 保底秒\n\n    // 5. 逐级计算\n    let rest = Math.floor(totalSeconds);\n    const parts = [];\n\n    for (const { key, seconds } of units) {\n        const val = Math.floor(rest / seconds);\n        rest %= seconds;\n\n        const shouldShow = val > 0 || (options.showZero && key === \"second\");\n        if (shouldShow || (parts.length === 0 && rest === 0)) {\n            parts.push(`${val}${labels[key]}`);\n        }\n    }\n\n    // 6. 兜底\n    if (parts.length === 0) {\n        parts.push(`0${labels[units[units.length - 1].key]}`);\n    }\n\n    return parts.join(\"\");\n}\n\n/**\n * 快捷调用 {@link formatDuration}，最大单位到“天”。\n *\n * @param {number} totalSeconds\n * @param {Omit<Parameters<typeof formatDuration>[1],'maxUnit'>} [options]\n * @returns {string}\n */\nexport function formatDurationMaxDay(totalSeconds, options = {}) {\n    return formatDuration(totalSeconds, { ...options, maxUnit: \"day\" });\n}\n\n/**\n * 快捷调用 {@link formatDuration}，最大单位到“小时”。\n *\n * @param {number} totalSeconds\n * @param {Omit<Parameters<typeof formatDuration>[1],'maxUnit'>} [options]\n * @returns {string}\n */\nexport function formatDurationMaxHour(totalSeconds, options = {}) {\n    return formatDuration(totalSeconds, { ...options, maxUnit: \"hour\" });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"date.js","sources":["../src/source/date.js"],"sourcesContent":["function getLocales_TimePeriod() {\r\n    return {\r\n        earlyMorning: \"凌晨\",\r\n        morning: \"上午\",\r\n        noon: \"中午\",\r\n        afternoon: \"下午\",\r\n        evening: \"晚上\"\r\n    };\r\n}\r\n\r\n/**\r\n * 将任意值安全转换为 Date 对象。\r\n * - 数字／数字字符串：视为时间戳\r\n * - 字符串：尝试按 ISO/RFC 格式解析\r\n * - 对象：优先 valueOf()，再 toString()\r\n * - null / undefined / 无效值：返回 null\r\n *\r\n * @param {*} val - 待转换值\r\n * @returns {Date | null} 有效 Date 或 null\r\n */\r\nexport function toDate(val) {\r\n    if (val == null) return null; // null / undefined\r\n    if (val instanceof Date) return isNaN(val) ? null : val; // 已是 Date，但需排除 Invalid Date\r\n\r\n    // 1. 数字或数字字符串 → 时间戳\r\n    if (typeof val === \"number\" || (typeof val === \"string\" && /^-?\\d+(\\.\\d+)?$/.test(val.trim()))) {\r\n        const d = new Date(+val);\r\n        return isNaN(d) ? null : d;\r\n    }\r\n\r\n    // 2. 标准 ISO 8601 / RFC 2825 等合法字符串\r\n    if (typeof val === \"string\") {\r\n        const d = new Date(val);\r\n        return isNaN(d) ? null : d; // 非法格式返回 null\r\n    }\r\n\r\n    // 3. 对象带 valueOf / toString\r\n    if (typeof val === \"object\") {\r\n        // 优先调用 valueOf（期望返回数字时间戳）\r\n        const prim = val.valueOf ? val.valueOf() : Object.prototype.valueOf.call(val);\r\n        if (typeof prim === \"number\" && !isNaN(prim)) {\r\n            const d = new Date(prim);\r\n            return isNaN(d) ? null : d;\r\n        }\r\n        // 兜底用字符串\r\n        const str = val.toString ? val.toString() : String(val);\r\n        const d = new Date(str);\r\n        return isNaN(d) ? null : d;\r\n    }\r\n\r\n    // 4. 其余情况\r\n    return null;\r\n}\r\n\r\n/**\r\n * 在闭区间 [date1, date2] 内随机生成一个日期（含首尾）。\r\n * 若顺序相反则自动交换。\r\n *\r\n * @param {Date} date1 - 起始日期\r\n * @param {Date} date2 - 结束日期\r\n * @returns {Date} 随机日期\r\n */\r\nexport function randomDateInRange(date1, date2) {\r\n    let v1 = date1.getTime(),\r\n        v2 = date2.getTime();\r\n    if (v1 > v2) [v1, v2] = [v2, v1];\r\n    return new Date(v1 + Math.floor(Math.random() * (v2 - v1 + 1)));\r\n}\r\n\r\n//#region   持续时间相关\r\n\r\n/**\r\n * 时间持续对象（完整版本，包含年月日时分秒毫秒）\r\n * @typedef {Object} DurationObject\r\n * @property {number} years - 年数\r\n * @property {number} months - 月数（0-11）\r\n * @property {number} days - 天数（0-29，取决于 monthDays）\r\n * @property {number} hours - 小时数（0-23）\r\n * @property {number} minutes - 分钟数（0-59）\r\n * @property {number} seconds - 秒数（0-59）\r\n * @property {number} milliseconds - 毫秒数（0-999）\r\n */\r\n\r\n/**\r\n * 时间持续对象（最大单位为天）\r\n * @typedef {Object} DurationMaxDayObject\r\n * @property {number} days - 天数\r\n * @property {number} hours - 小时数（0-23）\r\n * @property {number} minutes - 分钟数（0-59）\r\n * @property {number} seconds - 秒数（0-59）\r\n * @property {number} milliseconds - 毫秒数（0-999）\r\n */\r\n\r\n/**\r\n * 时间持续对象（最大单位为小时）\r\n * @typedef {Object} DurationMaxHourObject\r\n * @property {number} hours - 小时数\r\n * @property {number} minutes - 分钟数（0-59）\r\n * @property {number} seconds - 秒数（0-59）\r\n * @property {number} milliseconds - 毫秒数（0-999）\r\n */\r\n\r\n/**\r\n * 将毫秒转换为时间持续对象。\r\n *\r\n * @param {number} milliseconds - 毫秒数（非负整数）\r\n * @param {Object} [options] - 选项对象。\r\n * @param {number} [options.yearDays=365] - 一年的天数。\r\n * @param {number} [options.monthDays=30] - 一月的天数。\r\n * @returns {DurationObject} 时间持续对象\r\n * @throws {TypeError} 当 milliseconds 不是有效数字\r\n * @throws {RangeError} 当 milliseconds 为负数\r\n * @throws {RangeError} 当 yearDays 或 monthDays 不是正整数\r\n *\r\n * @example\r\n * // 基本用法\r\n * millisecond2Duration(42070000500);\r\n * // 返回: { years: 1, months: 4, days: 1, hours: 22, minutes: 6, seconds: 40, milliseconds: 500 }\r\n */\r\nexport function millisecond2Duration(milliseconds, options = { yearDays: 365, monthDays: 30 }) {\r\n    // 参数验证\r\n    if (typeof milliseconds !== \"number\" || isNaN(milliseconds)) {\r\n        throw new TypeError(\"milliseconds must be a valid number\");\r\n    }\r\n    if (milliseconds < 0) {\r\n        throw new RangeError(\"milliseconds must be a non-negative number\");\r\n    }\r\n\r\n    // 默认选项\r\n    const { yearDays = 365, monthDays = 30 } = options;\r\n\r\n    // 选项验证\r\n    if (!Number.isInteger(yearDays) || yearDays <= 0) {\r\n        throw new RangeError(\"yearDays must be a positive integer\");\r\n    }\r\n    if (!Number.isInteger(monthDays) || monthDays <= 0) {\r\n        throw new RangeError(\"monthDays must be a positive integer\");\r\n    }\r\n\r\n    const totalMilliseconds = Math.floor(milliseconds);\r\n    const ms = totalMilliseconds % 1000;\r\n    const diffSeconds = Math.floor(totalMilliseconds / 1000);\r\n\r\n    const seconds = diffSeconds % 60;\r\n    const minutes = Math.floor(diffSeconds / 60) % 60;\r\n    const hours = Math.floor(diffSeconds / 3600) % 24;\r\n\r\n    // 计算年、月、日\r\n    const totalDays = Math.floor(diffSeconds / 3600 / 24);\r\n    const years = Math.floor(totalDays / yearDays);\r\n    const remainingDays = totalDays % yearDays;\r\n    const months = Math.floor(remainingDays / monthDays);\r\n    const days = remainingDays % monthDays;\r\n\r\n    return { years, months, days, hours, minutes, seconds, milliseconds: ms };\r\n}\r\n\r\n/**\r\n * 将毫秒转换为时间持续对象（最大单位为天）。\r\n * @param {number} milliseconds - 毫秒数（非负整数）\r\n * @returns {DurationMaxDayObject} 包含天、小时、分钟、秒、毫秒的时间持续对象\r\n * @throws {TypeError} 当 milliseconds 不是有效数字时抛出\r\n * @throws {RangeError} 当 milliseconds 为负数时抛出\r\n * @example\r\n * // 返回 { days: 486, hours: 22, minutes: 6, seconds: 40, milliseconds: 500 }\r\n * millisecond2DurationMaxDay(42070000500);\r\n */\r\nexport function millisecond2DurationMaxDay(milliseconds) {\r\n    if (typeof milliseconds !== \"number\" || isNaN(milliseconds)) {\r\n        throw new TypeError(\"milliseconds must be a valid number\");\r\n    }\r\n    if (milliseconds < 0) {\r\n        throw new RangeError(\"milliseconds must be a non-negative number\");\r\n    }\r\n\r\n    const totalMilliseconds = Math.floor(milliseconds);\r\n    const ms = totalMilliseconds % 1000;\r\n    const diffSeconds = Math.floor(totalMilliseconds / 1000);\r\n\r\n    const seconds = diffSeconds % 60;\r\n    const minutes = Math.floor(diffSeconds / 60) % 60;\r\n    const hours = Math.floor(diffSeconds / 3600) % 24;\r\n    const days = Math.floor(diffSeconds / 3600 / 24);\r\n\r\n    return { days, hours, minutes, seconds, milliseconds: ms };\r\n}\r\n\r\n/**\r\n * 将毫秒转换为时间持续对象（最大单位为小时）。\r\n * @param {number} milliseconds - 毫秒数（非负整数）\r\n * @returns {DurationMaxHourObject} 包含小时、分钟、秒、毫秒的时间持续对象\r\n * @throws {TypeError} 当 milliseconds 不是有效数字时抛出\r\n * @throws {RangeError} 当 milliseconds 为负数时抛出\r\n * @example\r\n * // 返回 { hours: 11686, minutes: 6, seconds: 40, milliseconds: 500 }\r\n * millisecond2DurationMaxHour(42070000500);\r\n */\r\nexport function millisecond2DurationMaxHour(milliseconds) {\r\n    if (typeof milliseconds !== \"number\" || isNaN(milliseconds)) {\r\n        throw new TypeError(\"milliseconds must be a valid number\");\r\n    }\r\n    if (milliseconds < 0) {\r\n        throw new RangeError(\"milliseconds must be a non-negative number\");\r\n    }\r\n\r\n    const totalMilliseconds = Math.floor(milliseconds);\r\n    const ms = totalMilliseconds % 1000;\r\n    const diffSeconds = Math.floor(totalMilliseconds / 1000);\r\n\r\n    const seconds = diffSeconds % 60;\r\n    const minutes = Math.floor(diffSeconds / 60) % 60;\r\n    const hours = Math.floor(diffSeconds / 3600);\r\n\r\n    return { hours, minutes, seconds, milliseconds: ms };\r\n}\r\n\r\n/**\r\n * 将秒转换为时间持续对象。\r\n *\r\n * @param {number} seconds - 秒数（非负整数）\r\n * @param {Object} [options] - 选项对象。\r\n * @param {number} [options.yearDays=365] - 一年的天数。\r\n * @param {number} [options.monthDays=30] - 一月的天数。\r\n * @returns {DurationObject} 时间持续对象\r\n * @throws {TypeError} 当 seconds 不是有效数字\r\n * @throws {RangeError} 当 seconds 为负数\r\n * @throws {RangeError} 当 yearDays 或 monthDays 不是正整数\r\n *\r\n * @example\r\n * // 基本用法\r\n * second2Duration(42070000.5);\r\n * // 返回: { years: 1, months: 4, days: 1, hours: 22, minutes: 6, seconds: 40, milliseconds: 500 }\r\n */\r\nexport function second2Duration(seconds, options = { yearDays: 365, monthDays: 30 }) {\r\n    if (typeof seconds !== \"number\" || isNaN(seconds)) {\r\n        throw new TypeError(\"seconds must be a valid number\");\r\n    }\r\n    if (seconds < 0) {\r\n        throw new RangeError(\"seconds must be a non-negative number\");\r\n    }\r\n    return millisecond2Duration(seconds * 1000, options);\r\n}\r\n\r\n/**\r\n * 将秒转换为时间持续对象（最大单位为天）。\r\n * @param {number} seconds - 秒数（非负整数）\r\n * @returns {DurationMaxDayObject} 包含天、小时、分钟、秒、毫秒的时间持续对象\r\n * @throws {TypeError} 当 seconds 不是有效数字时抛出\r\n * @throws {RangeError} 当 seconds 为负数时抛出\r\n * @example\r\n * // 返回 { days: 486, hours: 22, minutes: 6, seconds: 40, milliseconds: 500 }\r\n * second2DurationMaxDay(42070000.5);\r\n */\r\nexport function second2DurationMaxDay(seconds) {\r\n    if (typeof seconds !== \"number\" || isNaN(seconds)) {\r\n        throw new TypeError(\"seconds must be a valid number\");\r\n    }\r\n    if (seconds < 0) {\r\n        throw new RangeError(\"seconds must be a non-negative number\");\r\n    }\r\n    return millisecond2DurationMaxDay(seconds * 1000);\r\n}\r\n\r\n/**\r\n * 将秒转换为时间持续对象（最大单位为小时）。\r\n * @param {number} seconds - 秒数（非负整数）\r\n * @returns {DurationMaxHourObject} 包含小时、分钟、秒、毫秒的时间持续对象\r\n * @throws {TypeError} 当 seconds 不是有效数字时抛出\r\n * @throws {RangeError} 当 seconds 为负数时抛出\r\n * @example\r\n * // 返回 { hours: 11686, minutes: 6, seconds: 40, milliseconds: 500 }\r\n * second2DurationMaxHour(42070000.5);\r\n */\r\nexport function second2DurationMaxHour(seconds) {\r\n    if (typeof seconds !== \"number\" || isNaN(seconds)) {\r\n        throw new TypeError(\"seconds must be a valid number\");\r\n    }\r\n    if (seconds < 0) {\r\n        throw new RangeError(\"seconds must be a non-negative number\");\r\n    }\r\n    return millisecond2DurationMaxHour(seconds * 1000);\r\n}\r\n\r\n//#endregion\r\n\r\n/**\r\n * 根据小时数返回对应的时间段名称。\r\n *\r\n * @param {number} hour - 24 小时制的小时（0-23）\r\n * @param {object} [locales] - 自定义时段文案\r\n * @param {string} [locales.earlyMorning=\"凌晨\"] - 00-05\r\n * @param {string} [locales.morning=\"上午\"] - 06-11\r\n * @param {string} [locales.noon=\"中午\"] - 12-13\r\n * @param {string} [locales.afternoon=\"下午\"] - 14-17\r\n * @param {string} [locales.evening=\"晚上\"] - 18-23\r\n * @returns {string} 时段名称\r\n * @throws {RangeError} 当 hour 不在 0-23 范围时抛出\r\n */\r\nexport function getTimePeriodName(hour, locales = getLocales_TimePeriod()) {\r\n    if (!Number.isInteger(hour) || hour < 0 || hour > 23) {\r\n        throw new RangeError(\"hour 必须是 0-23 的整数\");\r\n    }\r\n    if (hour >= 0 && hour < 6) return locales.earlyMorning;\r\n    if (hour < 12) return locales.morning;\r\n    if (hour < 14) return locales.noon;\r\n    if (hour < 18) return locales.afternoon;\r\n    return locales.evening;\r\n}\r\n\r\n/**\r\n * 格式化时间戳为本地化的时间字符串。\r\n *\r\n * @param {number} timestamp - 要格式化的时间戳（毫秒）。\r\n * @param {Object} [locales] - 本地化配置对象，包含时间相关的本地化字符串。\r\n * @param {string} [locales.justNow='刚刚'] - 表示刚刚过去的时间。\r\n * @param {string} [locales.today='今天'] - 表示今天。\r\n * @param {string} [locales.yesterday='昨天'] - 表示昨天。\r\n * @param {string} [locales.beforeYesterday='前天'] - 表示前天。\r\n * @param {string} [locales.year='年'] - 年的单位。\r\n * @param {string} [locales.month='月'] - 月的单位。\r\n * @param {string} [locales.day='日'] - 日的单位。\r\n * @param {Object} [locales.timePeriod] - 一天中不同时间段的本地化字符串。\r\n * @param {string} [locales.timePeriod.earlyMorning='凌晨'] - 凌晨。\r\n * @param {string} [locales.timePeriod.morning='上午'] - 上午。\r\n * @param {string} [locales.timePeriod.noon='中午'] - 中午。\r\n * @param {string} [locales.timePeriod.afternoon='下午'] - 下午。\r\n * @param {string} [locales.timePeriod.evening='晚上'] - 晚上。\r\n * @param {Array<string>} [locales.weekDays=['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六']] - 星期几的本地化字符串数组。\r\n *\r\n * @returns {string} - 格式化后的时间字符串。\r\n */\r\nexport function formatTimeForLocale(\r\n    timestamp,\r\n    locales = {\r\n        justNow: \"刚刚\",\r\n        today: \"今天\",\r\n        yesterday: \"昨天\",\r\n        beforeYesterday: \"前天\",\r\n        year: \"年\",\r\n        month: \"月\",\r\n        day: \"日\",\r\n        timePeriod: getLocales_TimePeriod(),\r\n        weekDays: [\"星期日\", \"星期一\", \"星期二\", \"星期三\", \"星期四\", \"星期五\", \"星期六\"]\r\n    }\r\n) {\r\n    const now = new Date();\r\n    const messageDate = new Date(timestamp);\r\n\r\n    const nowTime = now.getTime();\r\n    const msgTime = messageDate.getTime();\r\n    const diff = nowTime - msgTime;\r\n    const diffMinutes = Math.floor(diff / (1000 * 60));\r\n\r\n    const year = messageDate.getFullYear();\r\n    const month = messageDate.getMonth() + 1;\r\n    const day = messageDate.getDate();\r\n    const hour = messageDate.getHours();\r\n    const minute = messageDate.getMinutes().toString().padStart(2, \"0\");\r\n\r\n    // 刚刚：1分钟内\r\n    if (diffMinutes < 1) {\r\n        return locales.justNow;\r\n    }\r\n\r\n    // 计算自然天数差（按日期而非时间差）\r\n    const nowDate = new Date(now.getFullYear(), now.getMonth(), now.getDate());\r\n    const msgDate = new Date(year, month - 1, day);\r\n    const diffDays = Math.floor((nowDate.getTime() - msgDate.getTime()) / (1000 * 60 * 60 * 24));\r\n\r\n    const period = getTimePeriodName(hour, locales.timePeriod);\r\n    const timeStr = `${hour}:${minute}`;\r\n\r\n    // 今天\r\n    if (diffDays === 0) {\r\n        return `${locales.today} ${period}${timeStr}`;\r\n    }\r\n\r\n    // 昨天\r\n    if (diffDays === 1) {\r\n        return `${locales.yesterday} ${period}${timeStr}`;\r\n    }\r\n\r\n    // 前天\r\n    if (diffDays === 2) {\r\n        return `${locales.beforeYesterday} ${period}${timeStr}`;\r\n    }\r\n\r\n    // 本周内（周一到周日，且不是今天/昨天/前天）\r\n    // 获取本周一的日期\r\n    const nowDay = now.getDay() || 7; // 周日转为7\r\n    const msgDay = messageDate.getDay() || 7;\r\n    const mondayOfThisWeek = new Date(nowDate.getTime() - (nowDay - 1) * 24 * 60 * 60 * 1000);\r\n    const mondayOfThatWeek = new Date(msgDate.getTime() - (msgDay - 1) * 24 * 60 * 60 * 1000);\r\n\r\n    if (mondayOfThisWeek.getTime() === mondayOfThatWeek.getTime() && diffDays < 7) {\r\n        const weekDayName = locales.weekDays[messageDate.getDay()];\r\n        return `${weekDayName}${period} ${timeStr}`;\r\n    }\r\n\r\n    // 本月内（非本周）\r\n    const nowYear = now.getFullYear();\r\n    const nowMonth = now.getMonth();\r\n    if (year === nowYear && messageDate.getMonth() === nowMonth) {\r\n        return `${month}${locales.month}${day}${locales.day} ${period}${timeStr}`;\r\n    }\r\n\r\n    // 本年内（非本月）\r\n    if (year === nowYear) {\r\n        return `${month}${locales.month}${day}${locales.day} ${period}${timeStr}`;\r\n    }\r\n\r\n    // 其他（非本年）\r\n    return `${year}${locales.year}${month}${locales.month}${day}${locales.day} ${period}${timeStr}`;\r\n}\r\n"],"names":[],"mappings":"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"}

package/dist/download.cjs

@@ -1,107 +1,107 @@
 'use strict';
 
-/**
- * 通过动态创建 `<a>` 标签触发浏览器下载。
- * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。
- *
- * @param {string} url - 任意可下载地址（同源或允许跨域）
- * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
- */
-function downloadByUrl(url, fileName) {
-    const a = document.createElement("a");
-    a.style.display = "none";
-    a.rel = "noopener";
-    a.href = url;
-    a.download = fileName || Date.now();
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-}
-
-/**
- * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。
- *
- * @param {Blob} blob - 待下载的 Blob（含 File）
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadByBlob(blob, fileName) {
-    const url = URL.createObjectURL(blob);
-    downloadByUrl(url, fileName);
-    setTimeout(() => URL.revokeObjectURL(url), 0);
-}
-
-/**
- * 将任意数据包装成 Blob 并下载。
- *
- * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据
- * @param {string} [fileName] - 保存到本地的文件名
- * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`
- */
-function downloadByData(data, fileName, mimeType = "application/octet-stream") {
-    downloadByBlob(new Blob([data], { type: mimeType }), fileName);
-}
-
-/**
- * 快捷下载 Excel 文件（MIME 已固定）。
- *
- * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadExcel(data, fileName) {
-    downloadByData(data, fileName, "application/vnd.ms-excel");
-}
-
-/**
- * 快捷下载 JSON 文件（MIME 已固定）。
- * 若传入非字符串数据，会自行 `JSON.stringify`。
- *
- * @param {any} data - 要序列化的 JSON 数据
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadJSON(data, fileName) {
-    // downloadByData(typeof data === "string" ? data : JSON.stringify(data, null, 4), fileName, "application/json");
-    downloadByData(data, fileName, "application/json");
-}
-
-/**
- * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。
- * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。
- * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。
- *
- * @param {string} url - 文件的 URL 地址
- * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取
- * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve
- */
-async function fetchOrDownloadByUrl(url, fileName) {
-    // 如果未提供文件名，尝试从 URL 路径中提取
-    if (!fileName) {
-        try {
-            const urlPathname = new URL(url).pathname;
-            // 获取路径的最后一部分作为文件名，并移除可能的查询参数
-            fileName = urlPathname.substring(urlPathname.lastIndexOf("/") + 1).split("?")[0];
-        } catch (e) {}
-        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳
-        if (!fileName) {
-            fileName = Date.now().toString();
-        }
-    }
-
-    try {
-        const response = await fetch(url, {
-            method: "GET",
-            mode: "cors",
-            cache: "no-cache"
-        });
-
-        if (!response.ok) {
-            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);
-        }
-
-        const blob = await response.blob();
-        downloadByBlob(blob, fileName);
-    } catch (error) {
-        downloadByUrl(url, fileName);
-    }
+/**
+ * 通过动态创建 `<a>` 标签触发浏览器下载。
+ * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。
+ *
+ * @param {string} url - 任意可下载地址（同源或允许跨域）
+ * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
+ */
+function downloadByUrl(url, fileName) {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    a.rel = "noopener";
+    a.href = url;
+    a.download = fileName || Date.now();
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+}
+
+/**
+ * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。
+ *
+ * @param {Blob} blob - 待下载的 Blob（含 File）
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadByBlob(blob, fileName) {
+    const url = URL.createObjectURL(blob);
+    downloadByUrl(url, fileName);
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+
+/**
+ * 将任意数据包装成 Blob 并下载。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`
+ */
+function downloadByData(data, fileName, mimeType = "application/octet-stream") {
+    downloadByBlob(new Blob([data], { type: mimeType }), fileName);
+}
+
+/**
+ * 快捷下载 Excel 文件（MIME 已固定）。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadExcel(data, fileName) {
+    downloadByData(data, fileName, "application/vnd.ms-excel");
+}
+
+/**
+ * 快捷下载 JSON 文件（MIME 已固定）。
+ * 若传入非字符串数据，会自行 `JSON.stringify`。
+ *
+ * @param {any} data - 要序列化的 JSON 数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadJSON(data, fileName) {
+    // downloadByData(typeof data === "string" ? data : JSON.stringify(data, null, 4), fileName, "application/json");
+    downloadByData(data, fileName, "application/json");
+}
+
+/**
+ * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。
+ * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。
+ * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。
+ *
+ * @param {string} url - 文件的 URL 地址
+ * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取
+ * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve
+ */
+async function fetchOrDownloadByUrl(url, fileName) {
+    // 如果未提供文件名，尝试从 URL 路径中提取
+    if (!fileName) {
+        try {
+            const urlPathname = new URL(url).pathname;
+            // 获取路径的最后一部分作为文件名，并移除可能的查询参数
+            fileName = urlPathname.substring(urlPathname.lastIndexOf("/") + 1).split("?")[0];
+        } catch (e) {}
+        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳
+        if (!fileName) {
+            fileName = Date.now().toString();
+        }
+    }
+
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            mode: "cors",
+            cache: "no-cache"
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);
+        }
+
+        const blob = await response.blob();
+        downloadByBlob(blob, fileName);
+    } catch (error) {
+        downloadByUrl(url, fileName);
+    }
 }
 
 exports.downloadByBlob = downloadByBlob;

package/dist/download.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"download.cjs","sources":["../src/source/download.js"],"sourcesContent":["/**\n * 通过动态创建 `<a>` 标签触发浏览器下载。\n * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。\n *\n * @param {string} url - 任意可下载地址（同源或允许跨域）\n * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳\n */\nexport function downloadByUrl(url, fileName) {\n    const a = document.createElement(\"a\");\n    a.style.display = \"none\";\n    a.rel = \"noopener\";\n    a.href = url;\n    a.download = fileName || Date.now();\n    document.body.appendChild(a);\n    a.click();\n    document.body.removeChild(a);\n}\n\n/**\n * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。\n *\n * @param {Blob} blob - 待下载的 Blob（含 File）\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadByBlob(blob, fileName) {\n    const url = URL.createObjectURL(blob);\n    downloadByUrl(url, fileName);\n    setTimeout(() => URL.revokeObjectURL(url), 0);\n}\n\n/**\n * 将任意数据包装成 Blob 并下载。\n *\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据\n * @param {string} [fileName] - 保存到本地的文件名\n * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`\n */\nexport function downloadByData(data, fileName, mimeType = \"application/octet-stream\") {\n    downloadByBlob(new Blob([data], { type: mimeType }), fileName);\n}\n\n/**\n * 快捷下载 Excel 文件（MIME 已固定）。\n *\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadExcel(data, fileName) {\n    downloadByData(data, fileName, \"application/vnd.ms-excel\");\n}\n\n/**\n * 快捷下载 JSON 文件（MIME 已固定）。\n * 若传入非字符串数据，会自行 `JSON.stringify`。\n *\n * @param {any} data - 要序列化的 JSON 数据\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadJSON(data, fileName) {\n    // downloadByData(typeof data === \"string\" ? data : JSON.stringify(data, null, 4), fileName, \"application/json\");\n    downloadByData(data, fileName, \"application/json\");\n}\n\n/**\n * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。\n * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。\n * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。\n *\n * @param {string} url - 文件的 URL 地址\n * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取\n * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve\n */\nexport async function fetchOrDownloadByUrl(url, fileName) {\n    // 如果未提供文件名，尝试从 URL 路径中提取\n    if (!fileName) {\n        try {\n            const urlPathname = new URL(url).pathname;\n            // 获取路径的最后一部分作为文件名，并移除可能的查询参数\n            fileName = urlPathname.substring(urlPathname.lastIndexOf(\"/\") + 1).split(\"?\")[0];\n        } catch (e) {}\n        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳\n        if (!fileName) {\n            fileName = Date.now().toString();\n        }\n    }\n\n    try {\n        const response = await fetch(url, {\n            method: \"GET\",\n            mode: \"cors\",\n            cache: \"no-cache\"\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);\n        }\n\n        const blob = await response.blob();\n        downloadByBlob(blob, fileName);\n    } catch (error) {\n        downloadByUrl(url, fileName);\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.cjs","sources":["../src/source/download.js"],"sourcesContent":["/**\r\n * 通过动态创建 `<a>` 标签触发浏览器下载。\r\n * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。\r\n *\r\n * @param {string} url - 任意可下载地址（同源或允许跨域）\r\n * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳\r\n */\r\nexport function downloadByUrl(url, fileName) {\r\n    const a = document.createElement(\"a\");\r\n    a.style.display = \"none\";\r\n    a.rel = \"noopener\";\r\n    a.href = url;\r\n    a.download = fileName || Date.now();\r\n    document.body.appendChild(a);\r\n    a.click();\r\n    document.body.removeChild(a);\r\n}\r\n\r\n/**\r\n * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。\r\n *\r\n * @param {Blob} blob - 待下载的 Blob（含 File）\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadByBlob(blob, fileName) {\r\n    const url = URL.createObjectURL(blob);\r\n    downloadByUrl(url, fileName);\r\n    setTimeout(() => URL.revokeObjectURL(url), 0);\r\n}\r\n\r\n/**\r\n * 将任意数据包装成 Blob 并下载。\r\n *\r\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`\r\n */\r\nexport function downloadByData(data, fileName, mimeType = \"application/octet-stream\") {\r\n    downloadByBlob(new Blob([data], { type: mimeType }), fileName);\r\n}\r\n\r\n/**\r\n * 快捷下载 Excel 文件（MIME 已固定）。\r\n *\r\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadExcel(data, fileName) {\r\n    downloadByData(data, fileName, \"application/vnd.ms-excel\");\r\n}\r\n\r\n/**\r\n * 快捷下载 JSON 文件（MIME 已固定）。\r\n * 若传入非字符串数据，会自行 `JSON.stringify`。\r\n *\r\n * @param {any} data - 要序列化的 JSON 数据\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadJSON(data, fileName) {\r\n    // downloadByData(typeof data === \"string\" ? data : JSON.stringify(data, null, 4), fileName, \"application/json\");\r\n    downloadByData(data, fileName, \"application/json\");\r\n}\r\n\r\n/**\r\n * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。\r\n * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。\r\n * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。\r\n *\r\n * @param {string} url - 文件的 URL 地址\r\n * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取\r\n * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve\r\n */\r\nexport async function fetchOrDownloadByUrl(url, fileName) {\r\n    // 如果未提供文件名，尝试从 URL 路径中提取\r\n    if (!fileName) {\r\n        try {\r\n            const urlPathname = new URL(url).pathname;\r\n            // 获取路径的最后一部分作为文件名，并移除可能的查询参数\r\n            fileName = urlPathname.substring(urlPathname.lastIndexOf(\"/\") + 1).split(\"?\")[0];\r\n        } catch (e) {}\r\n        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳\r\n        if (!fileName) {\r\n            fileName = Date.now().toString();\r\n        }\r\n    }\r\n\r\n    try {\r\n        const response = await fetch(url, {\r\n            method: \"GET\",\r\n            mode: \"cors\",\r\n            cache: \"no-cache\"\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);\r\n        }\r\n\r\n        const blob = await response.blob();\r\n        downloadByBlob(blob, fileName);\r\n    } catch (error) {\r\n        downloadByUrl(url, fileName);\r\n    }\r\n}\r\n"],"names":[],"mappings":"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"}

package/dist/download.js

@@ -1,105 +1,105 @@
-/**
- * 通过动态创建 `<a>` 标签触发浏览器下载。
- * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。
- *
- * @param {string} url - 任意可下载地址（同源或允许跨域）
- * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
- */
-function downloadByUrl(url, fileName) {
-    const a = document.createElement("a");
-    a.style.display = "none";
-    a.rel = "noopener";
-    a.href = url;
-    a.download = fileName || Date.now();
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-}
-
-/**
- * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。
- *
- * @param {Blob} blob - 待下载的 Blob（含 File）
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadByBlob(blob, fileName) {
-    const url = URL.createObjectURL(blob);
-    downloadByUrl(url, fileName);
-    setTimeout(() => URL.revokeObjectURL(url), 0);
-}
-
-/**
- * 将任意数据包装成 Blob 并下载。
- *
- * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据
- * @param {string} [fileName] - 保存到本地的文件名
- * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`
- */
-function downloadByData(data, fileName, mimeType = "application/octet-stream") {
-    downloadByBlob(new Blob([data], { type: mimeType }), fileName);
-}
-
-/**
- * 快捷下载 Excel 文件（MIME 已固定）。
- *
- * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadExcel(data, fileName) {
-    downloadByData(data, fileName, "application/vnd.ms-excel");
-}
-
-/**
- * 快捷下载 JSON 文件（MIME 已固定）。
- * 若传入非字符串数据，会自行 `JSON.stringify`。
- *
- * @param {any} data - 要序列化的 JSON 数据
- * @param {string} [fileName] - 保存到本地的文件名
- */
-function downloadJSON(data, fileName) {
-    // downloadByData(typeof data === "string" ? data : JSON.stringify(data, null, 4), fileName, "application/json");
-    downloadByData(data, fileName, "application/json");
-}
-
-/**
- * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。
- * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。
- * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。
- *
- * @param {string} url - 文件的 URL 地址
- * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取
- * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve
- */
-async function fetchOrDownloadByUrl(url, fileName) {
-    // 如果未提供文件名，尝试从 URL 路径中提取
-    if (!fileName) {
-        try {
-            const urlPathname = new URL(url).pathname;
-            // 获取路径的最后一部分作为文件名，并移除可能的查询参数
-            fileName = urlPathname.substring(urlPathname.lastIndexOf("/") + 1).split("?")[0];
-        } catch (e) {}
-        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳
-        if (!fileName) {
-            fileName = Date.now().toString();
-        }
-    }
-
-    try {
-        const response = await fetch(url, {
-            method: "GET",
-            mode: "cors",
-            cache: "no-cache"
-        });
-
-        if (!response.ok) {
-            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);
-        }
-
-        const blob = await response.blob();
-        downloadByBlob(blob, fileName);
-    } catch (error) {
-        downloadByUrl(url, fileName);
-    }
+/**
+ * 通过动态创建 `<a>` 标签触发浏览器下载。
+ * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。
+ *
+ * @param {string} url - 任意可下载地址（同源或允许跨域）
+ * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳
+ */
+function downloadByUrl(url, fileName) {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    a.rel = "noopener";
+    a.href = url;
+    a.download = fileName || Date.now();
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+}
+
+/**
+ * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。
+ *
+ * @param {Blob} blob - 待下载的 Blob（含 File）
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadByBlob(blob, fileName) {
+    const url = URL.createObjectURL(blob);
+    downloadByUrl(url, fileName);
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+
+/**
+ * 将任意数据包装成 Blob 并下载。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`
+ */
+function downloadByData(data, fileName, mimeType = "application/octet-stream") {
+    downloadByBlob(new Blob([data], { type: mimeType }), fileName);
+}
+
+/**
+ * 快捷下载 Excel 文件（MIME 已固定）。
+ *
+ * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadExcel(data, fileName) {
+    downloadByData(data, fileName, "application/vnd.ms-excel");
+}
+
+/**
+ * 快捷下载 JSON 文件（MIME 已固定）。
+ * 若传入非字符串数据，会自行 `JSON.stringify`。
+ *
+ * @param {any} data - 要序列化的 JSON 数据
+ * @param {string} [fileName] - 保存到本地的文件名
+ */
+function downloadJSON(data, fileName) {
+    // downloadByData(typeof data === "string" ? data : JSON.stringify(data, null, 4), fileName, "application/json");
+    downloadByData(data, fileName, "application/json");
+}
+
+/**
+ * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。
+ * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。
+ * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。
+ *
+ * @param {string} url - 文件的 URL 地址
+ * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取
+ * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve
+ */
+async function fetchOrDownloadByUrl(url, fileName) {
+    // 如果未提供文件名，尝试从 URL 路径中提取
+    if (!fileName) {
+        try {
+            const urlPathname = new URL(url).pathname;
+            // 获取路径的最后一部分作为文件名，并移除可能的查询参数
+            fileName = urlPathname.substring(urlPathname.lastIndexOf("/") + 1).split("?")[0];
+        } catch (e) {}
+        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳
+        if (!fileName) {
+            fileName = Date.now().toString();
+        }
+    }
+
+    try {
+        const response = await fetch(url, {
+            method: "GET",
+            mode: "cors",
+            cache: "no-cache"
+        });
+
+        if (!response.ok) {
+            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);
+        }
+
+        const blob = await response.blob();
+        downloadByBlob(blob, fileName);
+    } catch (error) {
+        downloadByUrl(url, fileName);
+    }
 }
 
 export { downloadByBlob, downloadByData, downloadByUrl, downloadExcel, downloadJSON, fetchOrDownloadByUrl };

package/dist/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sources":["../src/source/download.js"],"sourcesContent":["/**\n * 通过动态创建 `<a>` 标签触发浏览器下载。\n * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。\n *\n * @param {string} url - 任意可下载地址（同源或允许跨域）\n * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳\n */\nexport function downloadByUrl(url, fileName) {\n    const a = document.createElement(\"a\");\n    a.style.display = \"none\";\n    a.rel = \"noopener\";\n    a.href = url;\n    a.download = fileName || Date.now();\n    document.body.appendChild(a);\n    a.click();\n    document.body.removeChild(a);\n}\n\n/**\n * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。\n *\n * @param {Blob} blob - 待下载的 Blob（含 File）\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadByBlob(blob, fileName) {\n    const url = URL.createObjectURL(blob);\n    downloadByUrl(url, fileName);\n    setTimeout(() => URL.revokeObjectURL(url), 0);\n}\n\n/**\n * 将任意数据包装成 Blob 并下载。\n *\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据\n * @param {string} [fileName] - 保存到本地的文件名\n * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`\n */\nexport function downloadByData(data, fileName, mimeType = \"application/octet-stream\") {\n    downloadByBlob(new Blob([data], { type: mimeType }), fileName);\n}\n\n/**\n * 快捷下载 Excel 文件（MIME 已固定）。\n *\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadExcel(data, fileName) {\n    downloadByData(data, fileName, \"application/vnd.ms-excel\");\n}\n\n/**\n * 快捷下载 JSON 文件（MIME 已固定）。\n * 若传入非字符串数据，会自行 `JSON.stringify`。\n *\n * @param {any} data - 要序列化的 JSON 数据\n * @param {string} [fileName] - 保存到本地的文件名\n */\nexport function downloadJSON(data, fileName) {\n    // downloadByData(typeof data === \"string\" ? data : JSON.stringify(data, null, 4), fileName, \"application/json\");\n    downloadByData(data, fileName, \"application/json\");\n}\n\n/**\n * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。\n * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。\n * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。\n *\n * @param {string} url - 文件的 URL 地址\n * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取\n * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve\n */\nexport async function fetchOrDownloadByUrl(url, fileName) {\n    // 如果未提供文件名，尝试从 URL 路径中提取\n    if (!fileName) {\n        try {\n            const urlPathname = new URL(url).pathname;\n            // 获取路径的最后一部分作为文件名，并移除可能的查询参数\n            fileName = urlPathname.substring(urlPathname.lastIndexOf(\"/\") + 1).split(\"?\")[0];\n        } catch (e) {}\n        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳\n        if (!fileName) {\n            fileName = Date.now().toString();\n        }\n    }\n\n    try {\n        const response = await fetch(url, {\n            method: \"GET\",\n            mode: \"cors\",\n            cache: \"no-cache\"\n        });\n\n        if (!response.ok) {\n            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);\n        }\n\n        const blob = await response.blob();\n        downloadByBlob(blob, fileName);\n    } catch (error) {\n        downloadByUrl(url, fileName);\n    }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.js","sources":["../src/source/download.js"],"sourcesContent":["/**\r\n * 通过动态创建 `<a>` 标签触发浏览器下载。\r\n * 注意：此方法可能无法强制下载浏览器原生支持的文件（如图片、PDF），浏览器可能会选择直接打开。\r\n *\r\n * @param {string} url - 任意可下载地址（同源或允许跨域）\r\n * @param {string} [fileName] - 保存到本地的文件名；不传时使用时间戳\r\n */\r\nexport function downloadByUrl(url, fileName) {\r\n    const a = document.createElement(\"a\");\r\n    a.style.display = \"none\";\r\n    a.rel = \"noopener\";\r\n    a.href = url;\r\n    a.download = fileName || Date.now();\r\n    document.body.appendChild(a);\r\n    a.click();\r\n    document.body.removeChild(a);\r\n}\r\n\r\n/**\r\n * 把 Blob 转成临时 URL 并触发下载，下载完成后立即释放内存。\r\n *\r\n * @param {Blob} blob - 待下载的 Blob（含 File）\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadByBlob(blob, fileName) {\r\n    const url = URL.createObjectURL(blob);\r\n    downloadByUrl(url, fileName);\r\n    setTimeout(() => URL.revokeObjectURL(url), 0);\r\n}\r\n\r\n/**\r\n * 将任意数据包装成 Blob 并下载。\r\n *\r\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - 要写入文件的数据\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n * @param {string} [mimeType] - MIME 类型；默认 `application/octet-stream`\r\n */\r\nexport function downloadByData(data, fileName, mimeType = \"application/octet-stream\") {\r\n    downloadByBlob(new Blob([data], { type: mimeType }), fileName);\r\n}\r\n\r\n/**\r\n * 快捷下载 Excel 文件（MIME 已固定）。\r\n *\r\n * @param {string | ArrayBufferView | ArrayBuffer | Blob} data - Excel 二进制或字符串内容\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadExcel(data, fileName) {\r\n    downloadByData(data, fileName, \"application/vnd.ms-excel\");\r\n}\r\n\r\n/**\r\n * 快捷下载 JSON 文件（MIME 已固定）。\r\n * 若传入非字符串数据，会自行 `JSON.stringify`。\r\n *\r\n * @param {any} data - 要序列化的 JSON 数据\r\n * @param {string} [fileName] - 保存到本地的文件名\r\n */\r\nexport function downloadJSON(data, fileName) {\r\n    // downloadByData(typeof data === \"string\" ? data : JSON.stringify(data, null, 4), fileName, \"application/json\");\r\n    downloadByData(data, fileName, \"application/json\");\r\n}\r\n\r\n/**\r\n * 通过 `fetch` 获取资源并强制下载，避免浏览器直接打开文件。\r\n * 此方法适用于下载图片、PDF 等浏览器默认会打开的文件类型。\r\n * 如果 `fetch` 失败（如 CORS 策略阻止），会回退到 `downloadByUrl` 方法作为备选方案。\r\n *\r\n * @param {string} url - 文件的 URL 地址\r\n * @param {string} [fileName] - 保存到本地的文件名。如果不提供，会尝试从 URL 中自动提取\r\n * @returns {Promise<void>} 返回一个 Promise，在下载开始或失败后 resolve\r\n */\r\nexport async function fetchOrDownloadByUrl(url, fileName) {\r\n    // 如果未提供文件名，尝试从 URL 路径中提取\r\n    if (!fileName) {\r\n        try {\r\n            const urlPathname = new URL(url).pathname;\r\n            // 获取路径的最后一部分作为文件名，并移除可能的查询参数\r\n            fileName = urlPathname.substring(urlPathname.lastIndexOf(\"/\") + 1).split(\"?\")[0];\r\n        } catch (e) {}\r\n        // 如果提取后文件名为空（例如 URL 以 '/' 结尾），也使用时间戳\r\n        if (!fileName) {\r\n            fileName = Date.now().toString();\r\n        }\r\n    }\r\n\r\n    try {\r\n        const response = await fetch(url, {\r\n            method: \"GET\",\r\n            mode: \"cors\",\r\n            cache: \"no-cache\"\r\n        });\r\n\r\n        if (!response.ok) {\r\n            throw new Error(`HTTP error! ${response.status}: ${response.statusText}`);\r\n        }\r\n\r\n        const blob = await response.blob();\r\n        downloadByBlob(blob, fileName);\r\n    } catch (error) {\r\n        downloadByUrl(url, fileName);\r\n    }\r\n}\r\n"],"names":[],"mappings":"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"}