# wx.cloud.downloadFile
Downloads files from cloud storage.
Request parameters
| Field | Description | Data Type | Default | Required |
|---|---|---|---|---|
| fileID | Cloud file ID | String | - | Y |
| config | Configuration | Object | - | N |
| success | Callback succeeds | |||
| fail | Callback fails | |||
| complete | Callback completes |
config object definition
| Field | Description | Data Type |
|---|---|---|
| env | ID of the used environment. Ignore the environment specified by init if this parameter is specified. | String |
success return parameter
| Field | Description | Data Type |
|---|---|---|
| tempFilePath | Temporary file path | String |
| statusCode | HTTP status code returned by the server | Number |
fail return parameter
| Field | Description | Data Type |
|---|---|---|
| errCode | Error code | Number |
| errMsg | Error message, in the format of apiName:fail msg | String |
# Use Case
Callback style
wx.cloud.downloadFile({
fileID: 'a7xzcb',
success: res => {
// get temp file path
console.log(res.tempFilePath)
},
fail: err => {
// handle error
}
})
Promise style
wx.cloud.downloadFile({
fileID: 'a7xzcb'
}).then(res => {
// get temp file path
console.log(res.tempFilePath)
}).catch(error => {
// handle error
})
Return value If a callback of success/fail/complete is included in the request parameter, an downloadTask object is returned. Upload progress events can be monitored and upload tasks can be canceled via the downloadTask object.