xref: /docs/en/release-notes/changelogs/OpenHarmony_3.2.10.6/changelogs-request.md

# Upload and Download Subsystem Changelog


## cl.request.2 request API Change

Deleted the beta APIs in API version 9:

1. function download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback\<DownloadTask>): void;
2. function download(context: BaseContext, config: DownloadConfig): Promise\<DownloadTask>;
3. function upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback\<UploadTask>): void;
4. function upload(context: BaseContext, config: UploadConfig): Promise\<UploadTask>;

**Change Impact**

The application developed based on an earlier version in the stage model needs to be adapted to the new APIs. Otherwise, the original service logic will be affected.

**Key API/Component Changes**

| Module         | Class          | Method/Attribute/Enum/Constant                                                                                                      | Change Type|
|--------------|--------------|-------------------------------------------------------------------------------------------------------------------|------|
| ohos.request | request      | function download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback\<DownloadTask>): void;    | Deleted  |
| ohos.request | request      | function download(context: BaseContext, config: DownloadConfig): Promise\<DownloadTask>;                          | Deleted  |
| ohos.request | request      | function upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback\<UploadTask>): void;          | Deleted  |
| ohos.request | request      | function upload(context: BaseContext, config: UploadConfig): Promise\<UploadTask>;                                | Deleted  |

**Adaptation Guide**

Call the new APIs. The following uses **downloadFile** as an example to show how it is called in the new version:

```ts
try {
    request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap',
        filePath: 'xxx/xxxxx.hap'}, (err, data) => {
        if (err) {
            console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
            return;
        }
    });
} catch (err) {
    console.log("downloadFile callback fail." + "errCode:" + err.code + ",errMessage:" + err.message);
}
```