codecamp

快应用 上传下载

接口声明

{"name": "system.request"}

导入模块

import request from '@system.request'
或 
const request = require('@system.request')

接口定义

request.upload(OBJECT)

上传文件

参数:

参数名 类型 必填 说明
url String 资源 url
header Object 请求的 header,会将其所有属性设置到请求的 header 部分。User-Agent 设置在1040版本开始支持。
method String 默认为 POST,可以是: POST, PUT
files Array 需要上传的文件列表,使用 multipart/form-data 方式提交
data 1000+ Array HTTP 请求中其他额外的 form data
success Function 成功返回的回调函数
fail Function 失败的回调函数
complete Function 结束的回调函数(调用成功、失败都会执行
files参数 :

files参数是一个file对象的数组,file对象的结构如下:

参数名 类型 必填 说明
filename String multipart提交时,header中的文件名
name String multipart提交时,表单的项目名,默认file
uri String 文件的本地地址
type String 文件的Content-Type格式,默认会根据filename或者uri的后缀获取
data参数  1000+:
参数名 类型 必填 说明
name String form元素的名称。
value String form元素的值。
success返回值:
参数名 类型 说明
code Integer 服务器状态code
data String 如果服务器返回的header中type是text/*或application/json、application/javascript、application/xml,值是文本内容,否则是存储的临时文件的uri临时文件如果是图片或者视频内容,可以将图片设置到image或video控件上显示
headers Object 服务器response的所有header

示例:

request.upload({
  url: 'http://www.example.com',
  files: [
    {
      uri: 'internal://xxx/xxx/test',
      name: 'file1',
      filename: 'test.png'
    }
  ],
  data: [
    {
      name: 'param1',
      value: 'value1'
    }
  ],
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

request.download(OBJECT)

下载文件

参数:

参数名 类型 必填 说明
url String 资源 url
header String 请求的 header,会将其所有属性设置到请求的 header 部分。User-Agent 设置在 1040 版本开始支持。
description 1010+ String 下载描述,会用于通知栏标题。默认为文件名
filename 1010+ String 下载文件名。默认从网络请求或 url 中获取
success Function 成功返回的回调函数
fail Function 失败的回调函数
complete Function 结束的回调函数(调用成功、失败都会执行)
success返回值:
参数名 类型 说明
token String 下载的token,根据此token获取下载状态

示例:

request.download({
  url: 'http://www.example.com',
  success: function(data) {
    console.log(`handling success${data.token}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

request.onDownloadComplete(OBJECT)

监听下载任务

参数:

参数名 类型 必填 说明
token String download接口返回的token
success Function 成功返回的回调函数
fail Function 失败的回调函数
complete Function 结束的回调函数(调用成功、失败都会执行)
success返回值:
参数名 类型 说明
uri String 下载文件的Uri
fail返回错误代码:
错误码  说明
1000 下载失败
1001 下载任务不存在

示例:

request.onDownloadComplete({
  token: '123',
  success: function(data) {
    console.log(`handling success${data.uri}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

后台运行限制

manifest 中申请后可用。

后台运行详细用法参见 后台运行脚本


快应用 通知消息
快应用 数据请求
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

快应用 参考手册

快应用 安全

快应用 声音音频

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }