core
    正在准备搜索索引...

    接口 DownloadFileData

    下载文件

    interface DownloadFileData {
        dnsOverHttps?: string;
        dnsServers?: string[];
        filePath?: string;
        header?: Record<string, string>;
        method?:
            | "OPTIONS"
            | "GET"
            | "HEAD"
            | "POST"
            | "PUT"
            | "DELETE"
            | "TRACE"
            | "CONNECT";
        onDataReceiveProgress?: (progress: DataReceiveProgress) => void;
        onDataSendProgress?: (progress: DataSendProgress) => void;
        onNetworkTaskCreated?: (task: NetworkTask) => void;
        onReceiveResponseHeaders?: (
            responseHeaders: Record<string, string | string[]>,
        ) => void;
        timeout?: number;
        url: string;
    }

    层级 (查看层级一览)

    索引
    dnsOverHttps?: string

    设置使用 HTTPS 协议的服务器进行 DNS 解析。

    • 参数必须根据以下格式进行 URL 编码:"https:// host:port/path"。
    dnsServers?: string[]

    设置指定的 DNS 服务器进行 DNS 解析。

    • 最多可以设置 3 个 DNS 解析服务器。如果有 3 个以上,只取前 3 个。
    • 服务器必须是 IPV4 或者 IPV6 地址。
    filePath?: string

    指定 fs:// 路径格式的下载后存储的文件路径,如果文件已经存在则覆盖,如果目录不存在会自动创建。

    header?: Record<string, string>

    设置请求的 header,不能设置 Referer。

    • request 接口 content-type 默认为 application/json
    method?:
        | "OPTIONS"
        | "GET"
        | "HEAD"
        | "POST"
        | "PUT"
        | "DELETE"
        | "TRACE"
        | "CONNECT"

    方法,可选值 OPTIONS,GET,HEAD,POST,PUT,DELETE,TRACE,CONNECT

    • request 与 downloadFile 接口默认 GET
    • uploadFile 接口默认 POST
    onDataReceiveProgress?: (progress: DataReceiveProgress) => void

    数据接收(下传)进度

    onDataSendProgress?: (progress: DataSendProgress) => void

    数据发送(上传)进度

    onNetworkTaskCreated?: (task: NetworkTask) => void

    当网络任务创建成功时触发

    onReceiveResponseHeaders?: (
        responseHeaders: Record<string, string | string[]>,
    ) => void

    接收到服务器响应头

    • 鸿蒙:如果出现重定向(如 302)会收到多次回调响应
    timeout?: number

    超时时间,毫秒

    url: string

    资源 url