/** * @file 文件相关的 utils */ import { last } from './array' import { round } from './number' /** * 将文件大小从字节转化为用指定的或者最合适的单位来描述 * * @param bytes - 字节数 * @param unit - 可指定单位: B | KB | MB | GB | TB * @returns 转换单位后的文件大小描述 (数字部分最多保留两位小数) */ export function formatFileSize( bytes: number, unit?: 'B' | 'K' | 'M' | 'G' | 'T', ): string { const unitList = ['B', 'K', 'M', 'G', 'T'] let size = bytes let unitIndex = 0 while (size > 1024 && unitList[unitIndex] !== unit) { size /= 1024 unitIndex += 1 } return `${round(size, 2)}${unitList[unitIndex]}` } /** * 从 Blob, web url 或 data url (比如由 canvas.toDataURL 得到) 下载文件并指定文件名 * * @param name - 文件名 * @param src - Blob, web url 或 data url */ export function downloadFile(name: string, src: string | Blob) { const file = document.createElement('a') file.download = name file.href = src instanceof Blob ? window.URL.createObjectURL(src) : src file.dispatchEvent(new MouseEvent('click')) } /** * 从文件名或文件 URL 中获取扩展名 (统一转为小写), 若没有则返回空字符串 * * @param filenameOrURL - 文件名或文件 URL * * @returns 扩展名 */ export function getExtName(filenameOrURL: string) { const filename = last(filenameOrURL.split('/')) ?? '' const parts = filename.split('.') if (parts.length <= 1) return '' return (last(parts) ?? '').toLowerCase() }