网络状态

接口声明

  1. { "name": "system.network" }

导入模块

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

接口定义

network.getType(OBJECT)

获取网络类型

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调，可能是因为缺乏权限
completeFunction否执行结束后的回调
success 返回值：
参数名类型说明
meteredBoolean是否按照流量计费
typeString网络类型，可能的值为 2g，3g，4g，wifi，none

示例：

  1. network.getType({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.type}`)
  4.   }
  5. })

network.subscribe(OBJECT)

监听网络连接状态。如果多次调用，仅最后一次调用生效

参数：

参数名类型必填说明
reserved 1050+Boolean否是否持久化订阅，默认为false。机制：设置为true，页面跳转，不会自动取消订阅，需手动取消订阅
callbackFunction否每次网络发生变化，都会被回调
failFunction否失败回调，可能是因为缺乏权限
callback 返回值：
参数名类型说明
meteredBoolean是否按照流量计费
typeString网络类型，可能的值为 2g，3g，4g，wifi，none

示例：

  1. network.subscribe({
  2.   callback: function(data) {
  3.     console.log('handling callback')
  4.   }
  5. })

network.unsubscribe()

取消监听网络连接状态

参数：

无

示例：

  1. network.unsubscribe()

后台运行限制

无限制。后台运行详细用法参见后台运行 脚本。