util-helpers 5.2.0 → 5.2.2

package/esm/VERSION.js

@@ -1,4 +1,4 @@
-var VERSION = "5.2.0";
+var VERSION = "5.2.2";
 var VERSION$1 = VERSION;
 
 export { VERSION$1 as default };

package/esm/checkFileType.js

@@ -2,7 +2,9 @@ import { isFile, isString, toString } from 'ut2';
 import { isUploadFile, testExt } from './utils/file.util.js';
 
 function checkFileType(file, accept) {
-    if (!isFile(file) && !isUploadFile(file)) {
+    var _a, _b;
+    var isFileType = isFile(file);
+    if (!isFileType && !isUploadFile(file)) {
         return false;
     }
     if (!isString(accept)) {
@@ -14,9 +16,9 @@ function checkFileType(file, accept) {
     }
     var ret = false;
     var types = accept.toLowerCase().split(/,(?:\s+)?/);
-    var fileName = file.name.toLowerCase();
-    var fileType = file.type || '';
-    var fileUrl = file.url || '';
+    var fileName = (file.name || (!isFileType && (file.fileName || ((_a = file.originFileObj) === null || _a === void 0 ? void 0 : _a.name))) || '').toLowerCase();
+    var fileType = file.type || (!isFileType && ((_b = file.originFileObj) === null || _b === void 0 ? void 0 : _b.type)) || '';
+    var fileUrl = (!isFileType && file.url) || '';
     types.some(function (type) {
         if (type === '*' || fileType === type || (type.indexOf('.') === 0 && (testExt(fileName, type) || testExt(fileUrl, type)))) {
             ret = true;

package/esm/getFileType.js

@@ -3,9 +3,9 @@ import checkFileType from './checkFileType.js';
 import { isUploadFile } from './utils/file.util.js';
 
 var config = {
-    image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp',
+    image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp,.svg,.apng,.avif,.ico,.tif,.tiff',
     audio: 'audio/*,.mp3,.wav,.aac,.flac',
-    video: 'video/*,.mp4,.webm,.ogg',
+    video: 'video/*,.mp4,.webm,.ogg,.mov',
     pdf: 'application/pdf,.pdf',
     word: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document,.doc,.docx',
     excel: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel,.xls,.xlsx'

package/esm/getMimeType.js

@@ -1,5 +1,5 @@
-import { isString, nth } from 'ut2';
 import { nativeUndefined } from './utils/native.js';
+import { getFileNameExt } from './utils/file.util.js';
 
 var mimeTypes = [
     ['text/plain', ['txt']],
@@ -36,7 +36,7 @@ var mimeTypes = [
 ];
 function getMimeType(fileName) {
     var _a;
-    var ext = isString(fileName) ? nth(fileName.split('.'), -1) : '';
+    var ext = getFileNameExt(fileName).slice(1);
     return ext ? (_a = mimeTypes.find(function (item) { return item[1].includes(ext); })) === null || _a === void 0 ? void 0 : _a[0] : nativeUndefined;
 }
 

package/esm/index.js

@@ -26,8 +26,6 @@ export { default as replaceChar } from './replaceChar.js';
 export { default as numberToChinese } from './numberToChinese.js';
 export { default as bytesToSize } from './bytesToSize.js';
 export { default as parseIdCard } from './parseIdCard.js';
-export { default as fileReader } from './fileReader.js';
-export { default as dataURLToBlob } from './dataURLToBlob.js';
 export { default as setDataURLPrefix } from './setDataURLPrefix.js';
 export { default as safeDate } from './safeDate.js';
 export { default as formatMobile } from './formatMobile.js';
@@ -41,10 +39,11 @@ export { default as round } from './round.js';
 export { default as gcd } from './gcd.js';
 export { default as lcm } from './lcm.js';
 export { default as ajax } from './ajax.js';
-export { default as calculateCursorPosition } from './calculateCursorPosition.js';
 export { default as checkFileType } from './checkFileType.js';
 export { default as compressImage } from './compressImage.js';
+export { default as dataURLToBlob } from './dataURLToBlob.js';
 export { default as download } from './download.js';
+export { default as fileReader } from './fileReader.js';
 export { default as getFileBlob } from './getFileBlob.js';
 export { default as getFileType } from './getFileType.js';
 export { default as getImageInfo } from './getImageInfo.js';
@@ -52,6 +51,7 @@ export { default as getMimeType } from './getMimeType.js';
 export { default as loadImage } from './loadImage.js';
 export { default as loadImageWithBlob } from './loadImageWithBlob.js';
 export { default as loadScript } from './loadScript.js';
+export { default as calculateCursorPosition } from './calculateCursorPosition.js';
 export { default as randomString } from './randomString.js';
 export { default as strlen } from './strlen.js';
 export { default as transformFieldNames } from './transformFieldNames.js';

package/esm/utils/file.util.js

@@ -1,13 +1,16 @@
-import { isObjectLike, isString } from 'ut2';
+import { isString, nth, isObjectLike } from 'ut2';
 
+function getFileNameExt(name) {
+    return isString(name) && name.indexOf('.') > 0 ? '.' + nth(name.split('.'), -1) : '';
+}
 function testExt(name, ext) {
-    return !!name && name.slice(-ext.length) === ext;
+    return !!name && getFileNameExt(name) === ext;
 }
 function isUploadFile(fileObj) {
-    if (isObjectLike(fileObj) && isString(fileObj.uid) && isString(fileObj.name)) {
+    if (isObjectLike(fileObj) && isString(fileObj.name)) {
         return true;
     }
     return false;
 }
 
-export { isUploadFile, testExt };
+export { getFileNameExt, isUploadFile, testExt };

package/lib/VERSION.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var VERSION = "5.2.0";
+var VERSION = "5.2.2";
 var VERSION$1 = VERSION;
 
 module.exports = VERSION$1;

package/lib/checkFileType.js

@@ -4,7 +4,9 @@ var ut2 = require('ut2');
 var file_util = require('./utils/file.util.js');
 
 function checkFileType(file, accept) {
-    if (!ut2.isFile(file) && !file_util.isUploadFile(file)) {
+    var _a, _b;
+    var isFileType = ut2.isFile(file);
+    if (!isFileType && !file_util.isUploadFile(file)) {
         return false;
     }
     if (!ut2.isString(accept)) {
@@ -16,9 +18,9 @@ function checkFileType(file, accept) {
     }
     var ret = false;
     var types = accept.toLowerCase().split(/,(?:\s+)?/);
-    var fileName = file.name.toLowerCase();
-    var fileType = file.type || '';
-    var fileUrl = file.url || '';
+    var fileName = (file.name || (!isFileType && (file.fileName || ((_a = file.originFileObj) === null || _a === void 0 ? void 0 : _a.name))) || '').toLowerCase();
+    var fileType = file.type || (!isFileType && ((_b = file.originFileObj) === null || _b === void 0 ? void 0 : _b.type)) || '';
+    var fileUrl = (!isFileType && file.url) || '';
     types.some(function (type) {
         if (type === '*' || fileType === type || (type.indexOf('.') === 0 && (file_util.testExt(fileName, type) || file_util.testExt(fileUrl, type)))) {
             ret = true;

package/lib/getFileType.js

@@ -5,9 +5,9 @@ var checkFileType = require('./checkFileType.js');
 var file_util = require('./utils/file.util.js');
 
 var config = {
-    image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp',
+    image: 'image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp,.svg,.apng,.avif,.ico,.tif,.tiff',
     audio: 'audio/*,.mp3,.wav,.aac,.flac',
-    video: 'video/*,.mp4,.webm,.ogg',
+    video: 'video/*,.mp4,.webm,.ogg,.mov',
     pdf: 'application/pdf,.pdf',
     word: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document,.doc,.docx',
     excel: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel,.xls,.xlsx'

package/lib/getMimeType.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var ut2 = require('ut2');
 var native = require('./utils/native.js');
+var file_util = require('./utils/file.util.js');
 
 var mimeTypes = [
     ['text/plain', ['txt']],
@@ -38,7 +38,7 @@ var mimeTypes = [
 ];
 function getMimeType(fileName) {
     var _a;
-    var ext = ut2.isString(fileName) ? ut2.nth(fileName.split('.'), -1) : '';
+    var ext = file_util.getFileNameExt(fileName).slice(1);
     return ext ? (_a = mimeTypes.find(function (item) { return item[1].includes(ext); })) === null || _a === void 0 ? void 0 : _a[0] : native.nativeUndefined;
 }
 

package/lib/index.js

@@ -28,8 +28,6 @@ var replaceChar = require('./replaceChar.js');
 var numberToChinese = require('./numberToChinese.js');
 var bytesToSize = require('./bytesToSize.js');
 var parseIdCard = require('./parseIdCard.js');
-var fileReader = require('./fileReader.js');
-var dataURLToBlob = require('./dataURLToBlob.js');
 var setDataURLPrefix = require('./setDataURLPrefix.js');
 var safeDate = require('./safeDate.js');
 var formatMobile = require('./formatMobile.js');
@@ -43,10 +41,11 @@ var round = require('./round.js');
 var gcd = require('./gcd.js');
 var lcm = require('./lcm.js');
 var ajax = require('./ajax.js');
-var calculateCursorPosition = require('./calculateCursorPosition.js');
 var checkFileType = require('./checkFileType.js');
 var compressImage = require('./compressImage.js');
+var dataURLToBlob = require('./dataURLToBlob.js');
 var download = require('./download.js');
+var fileReader = require('./fileReader.js');
 var getFileBlob = require('./getFileBlob.js');
 var getFileType = require('./getFileType.js');
 var getImageInfo = require('./getImageInfo.js');
@@ -54,6 +53,7 @@ var getMimeType = require('./getMimeType.js');
 var loadImage = require('./loadImage.js');
 var loadImageWithBlob = require('./loadImageWithBlob.js');
 var loadScript = require('./loadScript.js');
+var calculateCursorPosition = require('./calculateCursorPosition.js');
 var randomString = require('./randomString.js');
 var strlen = require('./strlen.js');
 var transformFieldNames = require('./transformFieldNames.js');
@@ -97,8 +97,6 @@ exports.replaceChar = replaceChar;
 exports.numberToChinese = numberToChinese;
 exports.bytesToSize = bytesToSize;
 exports.parseIdCard = parseIdCard;
-exports.fileReader = fileReader;
-exports.dataURLToBlob = dataURLToBlob;
 exports.setDataURLPrefix = setDataURLPrefix;
 exports.safeDate = safeDate;
 exports.formatMobile = formatMobile;
@@ -112,10 +110,11 @@ exports.round = round;
 exports.gcd = gcd;
 exports.lcm = lcm;
 exports.ajax = ajax;
-exports.calculateCursorPosition = calculateCursorPosition;
 exports.checkFileType = checkFileType;
 exports.compressImage = compressImage;
+exports.dataURLToBlob = dataURLToBlob;
 exports.download = download;
+exports.fileReader = fileReader;
 exports.getFileBlob = getFileBlob;
 exports.getFileType = getFileType;
 exports.getImageInfo = getImageInfo;
@@ -123,6 +122,7 @@ exports.getMimeType = getMimeType;
 exports.loadImage = loadImage;
 exports.loadImageWithBlob = loadImageWithBlob;
 exports.loadScript = loadScript;
+exports.calculateCursorPosition = calculateCursorPosition;
 exports.randomString = randomString;
 exports.strlen = strlen;
 exports.transformFieldNames = transformFieldNames;

package/lib/utils/file.util.js

@@ -2,15 +2,19 @@
 
 var ut2 = require('ut2');
 
+function getFileNameExt(name) {
+    return ut2.isString(name) && name.indexOf('.') > 0 ? '.' + ut2.nth(name.split('.'), -1) : '';
+}
 function testExt(name, ext) {
-    return !!name && name.slice(-ext.length) === ext;
+    return !!name && getFileNameExt(name) === ext;
 }
 function isUploadFile(fileObj) {
-    if (ut2.isObjectLike(fileObj) && ut2.isString(fileObj.uid) && ut2.isString(fileObj.name)) {
+    if (ut2.isObjectLike(fileObj) && ut2.isString(fileObj.name)) {
         return true;
     }
     return false;
 }
 
+exports.getFileNameExt = getFileNameExt;
 exports.isUploadFile = isUploadFile;
 exports.testExt = testExt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "5.2.0",
+  "version": "5.2.2",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/AsyncMemo.d.ts

@@ -25,7 +25,7 @@ import { Cache, CacheOptions } from 'cache2';
 declare class AsyncMemo<DataType = any> {
     private promiseCache;
     /**
-     * cache2 实例，用于管理缓存
+     * @summary cache2 实例，用于管理缓存
      */
     cache: Cache<DataType>;
     constructor(options?: Partial<CacheOptions>);

package/types/VERSION.d.ts

@@ -1,7 +1,5 @@
 /**
- * util-helpers 版本号
- *
- * @static
+ * @summary util-helpers 版本号。
  * @since 4.18.0
  */
 declare const VERSION: string;

package/types/ajax.d.ts

@@ -44,13 +44,29 @@ type AjaxOptions = {
  *
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
- * @static
- * @alias module:Other.ajax
+ * @alias module:Browser.ajax
  * @since 4.16.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest | XMLHttpRequest}
  * @param {string} url 地址
  * @param {AjaxOptions} [options] 配置项
- * @returns {Promise<object>} XHR 事件对象
+ * @param {string} [options.method="get"] 创建请求时使用的方法。默认 `'get'`。
+ * @param {boolean} [options.async=true] 是否异步执行操作。默认 `true`。
+ * @param {string|null} [options.user=null] 用户名，用于认证用途。默认 `null`。
+ * @param {string|null} [options.password=null] 密码，用于认证用途。默认 `null`。
+ * @param {Object} [options.headers] 自定义请求头。
+ * @param {string} [options.responseType] 响应类型。
+ * @param {number} [options.timeout] 请求超时的毫秒数。
+ * @param {boolean} [options.withCredentials=false] 跨域请求时是否需要使用凭证。默认 `false`。
+ * @param {*} [options.data=null] 请求体被发送的数据。默认 `null`。
+ * @param {function} [options.onReadyStateChange] 当 readyState 属性发生变化时触发。
+ * @param {function} [options.onLoadStart] 接收到响应数据时触发。
+ * @param {function} [options.onProgress] 请求接收到更多数据时，周期性地触发。
+ * @param {function} [options.onAbort] 当 request 被停止时触发，例如当程序调用 XMLHttpRequest.abort() 时。
+ * @param {function} [options.onTimeout] 在预设时间内没有接收到响应时触发。
+ * @param {function} [options.onError] 当 request 遭遇错误时触发。
+ * @param {function} [options.onLoad] 请求成功完成时触发。
+ * @param {function} [options.onLoadEnd] 请求结束时触发，无论请求成功 (load) 还是失败 (abort 或 error)。
+ * @returns {Promise<object>} XHR 事件对象。
  * @example
  * ajax('/somefile').then(res=>{
  *   // do something

package/types/bytesToSize.d.ts

@@ -5,7 +5,6 @@ type BytesToSizeOptions = {
 /**
  * 字节转换存储单位
  *
- * @static
  * @alias module:Processor.bytesToSize
  * @since 3.8.0
  * @param {number} bytes 字节大小

package/types/calculateCursorPosition.d.ts

@@ -6,7 +6,6 @@ type CalculateCursorPositionOptions = {
 /**
  * 计算输入框的值格式化后光标位置
  *
- * @static
  * @alias module:Other.calculateCursorPosition
  * @since 4.6.0
  * @see {@link https://2950v9.csb.app/ | h5示例}

package/types/checkFileType.d.ts

@@ -2,8 +2,9 @@ import { UploadFile } from './utils/file.util';
 /**
  * 检查文件是否符合 `accept` 类型说明符。
  *
- * @static
- * @alias module:Other.checkFileType
+ * 通过 `file.type` `file.name` `file.url` 与 `accept` 进行匹配。
+ *
+ * @alias module:Browser.checkFileType
  * @since 5.1.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/input/file#唯一文件类型说明符 | 唯一文件类型说明符}
  * @see {@link https://www.iana.org/assignments/media-types/media-types.xhtml | Media Types}

package/types/compressImage.d.ts

@@ -35,7 +35,7 @@ interface CompressImage {
  * <em style="font-weight: bold;">如果是半透明图片并且导出 `image/png` 格式，建议将背景变成透明 `background=transparent`，避免出现白边。注意正常图片压缩导出 `image/png` 格式后文件可能会比原图大。</em>
  *
  * @function
- * @alias module:Other.compressImage
+ * @alias module:Browser.compressImage
  * @since 4.20.0
  * @see {@link https://sytpwg.csb.app/ | 在线示例}
  * @param {string | Blob} img 图片地址或 blob 对象

package/types/dataURLToBlob.d.ts

@@ -1,8 +1,7 @@
 /**
  * 将 DataURL 转为 Blob 对象
  *
- * @static
- * @alias module:Processor.dataURLToBlob
+ * @alias module:Browser.dataURLToBlob
  * @since 4.1.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64 | Base64}
  * @param {string} data data: 协议的URL

package/types/divide.d.ts

@@ -1,7 +1,6 @@
 /**
  * 精确除法，支持多个数相除，除数默认为 1 。
  *
- * @static
  * @alias module:Math.divide
  * @since 3.1.0
  * @param {...(number|string)} nums 被除数和除数

package/types/download.d.ts

@@ -10,24 +10,6 @@ type DownloadOptions = {
     transformRequest?: TransformRequest;
     transformResponse?: TransformResponse;
 };
-/**
- * @callback TransformRequest
- * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions | Promise<AjaxOptions>}
- */
-/**
- * @callback TransformResponse
- * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob | Promise<Blob>}
- */
-/**
- * @typedef {Object} DownloadOptions 下载配置项
- * @property {string} [fileName] 文件名称
- * @property {string} [type] MIME 类型
- * @property {'url'|'text'} [dataType] 手动设置数据类型，默认会根据传入的数据判断类型，主要是为了区分 url 和 text 。<br/>如果你要下载的文本是 url ，请设置 'text' ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
- * @property {TransformRequest} [transformRequest] 请求前触发，XHR 对象或配置调整
- * @property {TransformResponse} [transformResponse] 请求成功后触发，在传递给 then/catch 前，允许修改响应数据
- */
 /**
  * 下载
  *
@@ -37,14 +19,18 @@ type DownloadOptions = {
  *
  * <em>响应头中有 "Content-Disposition" 字段，客户端获取不到？</em> 请参考查阅 [Access-Control-Expose-Headers](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers) 。
  *
- * @static
- * @alias module:Other.download
+ * @alias module:Browser.download
  * @since 4.16.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers | Access-Control-Expose-Headers}
  * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展 | MIME}
  * @see {@link https://9ykc9s.csb.app/ | 在线示例}
  * @param {string|Blob|ArrayBuffer|TypedArray} data 字符串、blob数据或url地址
- * @param {string|DownloadOptions} [options] 文件名称 或 配置项
+ * @param {string|Object} [options] 文件名称 或 配置项。
+ * @param {string} [options.fileName] 文件名称。
+ * @param {string} [options.type] MIME 类型。
+ * @param {'url'|'text'} [options.dataType] 手动设置数据类型，主要是为了区分 `url` 和 `text`，默认会根据传入的数据判断类型。<br/>如果你要下载的文本是 `url` ，请设置 `'text'` ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
+ * @param {Function} [options.transformRequest] 请求前触发，XHR 对象或配置调整。
+ * @param {Function} [options.transformResponse] 请求成功后触发，在传递给 then/catch 前，允许修改响应数据。
  * @returns {Promise<void>}
  * @example
  * // 文本

package/types/fileReader.d.ts

@@ -15,7 +15,7 @@ interface FileReader {
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
  * @function
- * @alias module:Processor.fileReader
+ * @alias module:Browser.fileReader
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader | FileReader}
  * @since 4.16.0
  * @param {Blob} blob Blob 或 File 对象

package/types/filterTree.d.ts

@@ -4,7 +4,6 @@ type NodeAssign = 'spread' | 'self';
  *
  * 如果某节点被过滤掉，它的子节点也一并抛弃。
  *
- * @static
  * @alias module:Tree.filterTree
  * @since 4.15.0
  * @param {Object[]} tree 树结构数据

package/types/findTreeNode.d.ts

@@ -1,7 +1,6 @@
 /**
  * 查找树结构数据节点
  *
- * @static
  * @alias module:Tree.findTreeNode
  * @since 4.14.0
  * @param {Object[]} tree 树结构数据

package/types/findTreeNodes.d.ts

@@ -1,7 +1,6 @@
 /**
  * 查找树结构数据多个节点
  *
- * @static
  * @alias module:Tree.findTreeNodes
  * @since 4.15.0
  * @param {Object[]} tree 树结构数据

package/types/findTreeSelect.d.ts

@@ -1,7 +1,6 @@
 /**
  * 查找包含当前节点的所有父级节点
  *
- * @static
  * @alias module:Tree.findTreeSelect
  * @since 4.14.0
  * @param {Object[]} tree 树结构数据

package/types/formatBankCard.d.ts

@@ -5,7 +5,6 @@ type Options = {
 /**
  * 格式化银行卡号
  *
- * @static
  * @alias module:Processor.formatBankCard
  * @since 1.1.0
  * @param {string} bankCardNo 要处理的字符串

package/types/formatMobile.d.ts

@@ -4,7 +4,6 @@ type Options = {
 /**
  * 格式化手机号码
  *
- * @static
  * @alias module:Processor.formatMobile
  * @since 4.5.0
  * @param {string} mobileNo 手机号码

package/types/formatMoney.d.ts

@@ -8,7 +8,6 @@ type Options = {
 /**
  * 格式化金额
  *
- * @static
  * @alias module:Processor.formatMoney
  * @since 1.1.0
  * @param {string | number} num 需转换金额 (最大：9007199254740991 最小： -9007199254740991)

package/types/gcd.d.ts

@@ -9,7 +9,6 @@
  * 4. 如果参数为负数，将转为绝对值的正数。
  * 5. 如果参数包含小数点，将转为四舍五入的整数。
  *
- * @static
  * @alias module:Math.gcd
  * @since 4.20.0
  * @see {@link https://baike.baidu.com/item/最大公约数 | 最大公约数}

package/types/getFileBlob.d.ts

@@ -2,8 +2,7 @@ import ajax from './ajax';
 /**
  * 获取文件 Blob 。
  *
- * @static
- * @alias module:Other.getFileBlob
+ * @alias module:Browser.getFileBlob
  * @since 4.21.0
  * @param {string | Blob} file 文件地址或对象。
  * @param {AjaxOptions} [ajaxOptions] ajax 请求配置项，当传入的图片为字符串时才会触发请求。

package/types/getFileType.d.ts

@@ -1,9 +1,7 @@
 import { UploadFile } from './utils/file.util';
 /**
- * 获取文件类型。
- *
- * @static
- * @alias module:Other.getFileType
+ * @summary 获取文件类型。
+ * @alias module:Browser.getFileType
  * @since 5.1.0
  * @requires Other.checkFileType
  * @param {File} file 文件对象。支持 antd `UploadFile` 对象。
@@ -16,6 +14,17 @@ import { UploadFile } from './utils/file.util';
  * getFileType(pdf); // 'pdf'
  * getFileType(jpeg); // 'image'
  *
+ * @description 内置文件类型和文件类型说明符
+ *
+ * | 类型 | 说明符 |
+ * |---|---|
+ * | `image` | `image/*,.jpeg,.jpg,.gif,.bmp,.png,.webp,.svg,.apng,.avif,.ico,.tif,.tiff` |
+ * | `audio` | `audio/*,.mp3,.wav,.aac,.flac` |
+ * | `video` | `video/*,.mp4,.webm,.ogg,.mov` |
+ * | `pdf` | `application/pdf,.pdf` |
+ * | `word` | `application/vnd.openxmlformats-officedocument.wordprocessingml.document,.doc,.docx` |
+ * | `excel` | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.ms-excel,.xls,.xlsx` |
+ *
  */
 declare function getFileType(file: File | UploadFile): "image" | "audio" | "video" | "pdf" | "word" | "excel" | undefined;
 export default getFileType;

package/types/getImageInfo.d.ts

@@ -15,16 +15,25 @@ import loadImageWithBlob from './loadImageWithBlob';
  *
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
- * @static
- * @alias module:Other.getImageInfo
+ * @alias module:Browser.getImageInfo
  * @since 4.20.0
- * @param {string | Blob} img 图片地址或 blob 对象
+ * @param {string | Blob} img 图片地址或 blob 对象。
  * @param {AjaxOptions} [ajaxOptions] ajax 请求配置项，当传入的图片为字符串时才会触发请求。
- * @returns {Promise<ImageInfo>} 图片信息
+ * @returns {Promise<ImageInfo>} 图片信息。
  * @example
  *
  * getImageInfo(file).then(imageInfo=>{
- *    // do something
+ *   console.log(imageInfo);
+ *   // {
+ *   //   width: 100,
+ *   //   height: 100,
+ *   //   contrast: '1:1',
+ *   //   measure: '100 × 100 px',
+ *   //   size: '11 B',
+ *   //   bytes: 11,
+ *   //   image: HTMLImageElement {},
+ *   //   blob: Blob {}
+ *   // }
  * });
  *
  * getImageInfo('https://dummyimage.com/200x300').then(imageInfo=>{

package/types/getMimeType.d.ts

@@ -1,9 +1,7 @@
 /**
- * 获取常用的 MIME 类型。
+ * @summary 获取常用的 MIME 类型。通过文件名后缀查找对应的 MIME 类型。
  *
- * 通过文件名后缀查找对于的 MIME 类型。
- *
- * @alias module:Other.getMimeType
+ * @alias module:Browser.getMimeType
  * @since 5.2.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/MIME_types | MIME 类型（IANA 媒体类型）}
  * @see {@link https://www.iana.org/assignments/media-types/media-types.xhtml | Media Types}
@@ -20,6 +18,45 @@
  *
  * // 不常用或未知类型
  * getMimeTye('xxx.ci'); // undefined
+ *
+ * // 非法文件名
+ * getMimeType('.zip'); // undefined
+ *
+ * @description 内置常用的 MIME 类型和文件名后缀映射
+ *
+ * | MIME 类型 | 文件名后缀 |
+ * |---|---|
+ * | `text/plain` | `txt` |
+ * | `text/css` | `css` |
+ * | `text/html` | `htm` `html` |
+ * | `text/javascript` | `js` `mjs` |
+ * | `text/csv` | `csv` |
+ * | `text/markdown` | `md` `markdown` |
+ * | `image/gif` | `gif` |
+ * | `image/jpeg` | `jpg` `jpeg` `jfif` `pjpeg` `pjp` |
+ * | `image/png` | `png` |
+ * | `image/svg+xml` | `svg` |
+ * | `image/webp` | `webp` |
+ * | `image/apng` | `apng` |
+ * | `image/avif` | `avif` |
+ * | `image/bmp` | `bmp` |
+ * | `image/x-icon` | `ico` `cur` |
+ * | `image/tiff` | `tif` `tiff` |
+ * | `application/xml` | `xml` |
+ * | `application/zip` | `zip` |
+ * | `application/pdf` | `pdf` |
+ * | `application/json` | `json` |
+ * | `application/yaml` | `yaml` `yml` |
+ * | `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | `doc` `docx` |
+ * | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | `xls` `xlsx` |
+ * | `audio/mp3` | `mp3` |
+ * | `audio/wav` | `wav` |
+ * | `audio/aac` | `aac` |
+ * | `audio/flac` | `flac` |
+ * | `video/mp4` | `mp4` |
+ * | `video/ogg` | `ogg` |
+ * | `video/webm` | `webm` |
+ * | `video/quicktime` | `mov` |
  */
 declare function getMimeType(fileName: string): string | undefined;
 export default getMimeType;