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

    接口 UploadFileData

    上传文件

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

    层级 (查看层级一览)

    索引
    contentType?: string

    文件的 contentType,默认从 fileName 的文件扩展名推断,如果推断失败则为 application/octet-stream

    dnsOverHttps?: string

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

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

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

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

    需要上传的文件内容

    • filePath 与 fileData 必须提供一个,如果都提供则以 fileData 优先
    fileName?: string

    开发者服务器取得的文件名称,默认从 filePath 中获取,如果无法获取名称则为 no-name

    filePath?: string

    要上传的 fs:// 或 file:// 路径格式的文件路径

    • filePath 与 fileData 必须提供一个,如果都提供则以 fileData 优先
    formData?: Record<string, string>

    HTTP 请求中其他额外的 form data

    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
    name?: string

    文件对应的 key, 开发者在服务器端通过这个 key 可以获取到文件二进制内容

    file
    
    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