harmony 鸿蒙@system.request (Upload and Download)

2025-06-12
浏览 (5)

@system.request (Upload and Download)

The system.request module provides applications with basic upload and download capabilities.

NOTE - The APIs of this module are deprecated since API version 9. You are advised to use @ohos.request instead.

The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import request from '@system.request';

request.upload^(deprecated)

upload(options: UploadRequestOptions): void

Uploads a file. This API returns no value.

System capability: SystemCapability.MiscServices.Upload

Parameters

Name	Type	Mandatory	Description
options	UploadRequestOptions	Yes	Upload configurations.

Example

  import request, { UploadRequestOptions } from '@system.request';

  let uploadRequestOptions: UploadRequestOptions = {
    url: 'http://www.path.com',
    method: 'POST',
    files: [{
      filename: "test",
      name: "test",
      uri: "internal://cache/test.jpg",
      type: "jpg"
    }],
    data: [{
      name: "name123",
      value: "123"
    }],
    success: (data: object) => {
      console.info(' upload success, code:' + JSON.stringify(data));
    },
    fail: (data:string, code:number) => {
      console.info(' upload fail data: ' + data + 'code: ' + code);
    },
    complete: () => {
      console.info(' upload complete');
    }
  }

  try {
    request.upload(uploadRequestOptions);
    console.info('upload start ');
  } catch (err) {
    console.info(' upload err:' + err);
  }

UploadRequestOptions^(deprecated)

System capability: SystemCapability.MiscServices.Upload

Name	Type	Mandatory	Description
url	string	Yes	URL of the upload server.
data	Array<RequestData>	No	Form data in the request body.
files	Array<RequestFile>	Yes	List of files to upload, which is submitted through multipart/form-data.
header	Object	No	Request header.
method	string	No	Request method, which can be ‘POST’ or ‘PUT’. The default value is POST.
success	Function	No	Called when API call is successful.
fail	Function	No	Called when API call has failed.
complete	Function	No	Called when API call is complete.

fail parameters |Name|Type|Mandatory|Description| |——–|——–|——–|——–| |data|any|Yes|Header information returned when the upload task fails.| |code|number|Yes|HTTP status code returned when the upload task fails.|

UploadResponse^(deprecated)

System capability: SystemCapability.MiscServices.Upload

Name	Type	Mandatory	Description
code	number	Yes	HTTP status code returned by the server.
data	string	Yes	Content returned by the server. The value type is determined by the type in the returned headers.
headers	Object	Yes	Headers returned by the server.

RequestFile^(deprecated)

System capability: SystemCapability.MiscServices.Upload

Name	Type	Mandatory	Description
filename	string	No	File name in the header when multipart is used.
name	string	No	Name of a form item when multipart is used. The default value is file.
uri	string	Yes	Local path for storing files.
type	string	No	Type of the file content. By default, the type is obtained based on the extension of the file name or URI.

RequestData^(deprecated)

System capability: SystemCapability.MiscServices.Upload

Name	Type	Mandatory	Description
name	string	Yes	Name of the form element.
value	string	Yes	Value of the form element.