@d-matrix/utils 1.4.0 → 1.5.0

package/dist/file.d.ts

@@ -27,4 +27,13 @@ export declare const validateImageSize: (file: BlobPart | FileURL, limitSize: {
  * @returns Promise<boolean>
  */
 export declare function isImageExists(src: string, img?: HTMLImageElement): Promise<boolean>;
+/**
+ * 从Content-Disposition中获取文件名
+ * @param header 包含Content-Disposition, 值为'attachment;filename=%E5%A4%A7%E8%A1%8C%E6%8C%87%E5%AF%BC2024-06-27-2024-06-28.xlsx'
+ * @returns string
+ *
+ */
+export declare function getFilenameFromContentDispositionHeader(header: {
+    ['content-disposition']: string;
+}): string;
 export {};

package/dist/file.js

@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
     }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isImageExists = exports.validateImageSize = exports.toImage = void 0;
+exports.getFilenameFromContentDispositionHeader = exports.isImageExists = exports.validateImageSize = exports.toImage = void 0;
 /**
  * 转换BlobPart或者文件地址为图片对象
  * @param file 传入文件 或者 url
@@ -108,3 +108,17 @@ function isImageExists(src, img) {
     });
 }
 exports.isImageExists = isImageExists;
+/**
+ * 从Content-Disposition中获取文件名
+ * @param header 包含Content-Disposition, 值为'attachment;filename=%E5%A4%A7%E8%A1%8C%E6%8C%87%E5%AF%BC2024-06-27-2024-06-28.xlsx'
+ * @returns string
+ *
+ */
+function getFilenameFromContentDispositionHeader(header) {
+    var contentDisposition = header['content-disposition'];
+    if (!contentDisposition)
+        return '';
+    var filename = contentDisposition.split('filename=')[1].split(';')[0];
+    return decodeURIComponent(filename);
+}
+exports.getFilenameFromContentDispositionHeader = getFilenameFromContentDispositionHeader;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-matrix/utils",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A dozen of utils for Front-End Development",
   "main": "dist/index.js",
   "scripts": {
@@ -9,7 +9,8 @@
     "clean": "rimraf dist",
     "cy:open": "cypress open",
     "cy:run": "cypress run",
-    "test:tsd": "tsd"
+    "test:tsd": "tsd",
+    "postversion": "git push && git push --tags"
   },
   "engines": {
     "node": ">=16.20.0"

package/readme.md

@@ -137,6 +137,20 @@ const $img = document.getElementById('img');
 const res = await file.isImageExists(url, $img);
 ```
 
+- `getFilenameFromContentDispositionHeader(header: { ['content-disposition']: string }): string`
+
+从`Content-Disposition` response header中获取`filename`
+
+```ts
+import { file } from '@d-matrix/utils';
+
+const header = {
+  'content-disposition': 'attachment;filename=%E5%A4%A7%E8%A1%8C%E6%8C%87%E5%AF%BC2024-06-27-2024-06-28.xlsx'
+};
+const filename = file.getFilenameFromContentDispositionHeader(header);
+// '大行指导2024-06-27-2024-06-28.xlsx'
+```
+
 ## support
 
 - `isBrowserEnv(): boolean`