electron electron-dl 参数以及api 详细说明

electron-dl 是一个 Electron 模块，用于简化文件下载过程，它提供了一些参数和 API 来控制下载过程。以下是一些常用的参数和 API：

### 参数

- `options`: 一个对象，它包含有关下载的选项。它的值可以包含以下属性：
- `directory`: 下载文件的目录。如果未指定，则会使用操作系统的默认下载目录。
- `filename`: 下载文件的文件名。如果未指定，则会使用 URL 上的文件名。
- `showBadge`: 是否在 Dock 上显示下载进度的标记。默认为 true。
- `onProgress`: 一个回调函数，在下载过程中被调用以显示下载进度。它接收两个参数：状态对象和下载进度对象。
- `openFolderWhenDone`: 下载完成后是否打开所在文件夹。默认为 false。
- `errorTitle`: 下载出错时显示的标题。默认为 "Download Error"。
- `errorMessage`: 下载出错时显示的消息。默认为 "The download of {filename} was interrupted"。

### API

- `download(window: BrowserWindow, url: string, options?: object): Promise<DownloadItem>`：启动一个文件下载。它接收三个参数：窗口对象，要下载的文件的 URL，下载选项（可选）。它返回一个 Promise，该 Promise 在下载完成后被解决，并返回一个 DownloadItem 对象，该对象包含有关下载的信息，例如文件名和保存路径等。
- `DownloadItem`：表示一个文件下载项的类。它具有以下方法和属性：
- `getURL(): string`：获取文件的 URL。
- `getMimeType(): string`：获取文件的 MIME 类型。
- `getFilename(): string`：获取文件的文件名。
- `getReceivedBytes(): number`：获取已接收的字节数。
- `getTotalBytes(): number`：获取文件的总字节数。
- `getContentDisposition(): string`：获取文件的 Content-Disposition 标头的值。
- `getState(): string`：获取文件的当前状态。可能的值为 "progressing"、"completed" 和 "cancelled"。
- `getSavePath(): string`：获取文件的保存路径。
- `cancel(): void`：取消文件下载。
- `pause(): void`：暂停文件下载。
- `resume(): void`：恢复文件下载。

以上是一些常用的参数和 API，您可以根据实际需求使用它们来实现文件下载功能。