Network:change 事件
change 事件在网络状态变了之后派发:isConnected、type、isExpensive 三项里有一项变了。
语法
application.network.addEventListener('change', (event) => { })事件对象
Event。只有 type 和 target(application.network),不带新的状态。不能取消。
什么时候派发
- 事件不说明是哪一项变了。 回调里读三个属性,得到的是变化之后的状态。
- 三项都没变时不派发。比如从一个 Wi-Fi 换到另一个 Wi-Fi,三项都没变,就没有事件。
- App 启动时拿到第一份网络状态,不算变化,不派发。
- 在事情发生之后、当前这段 JS 执行完之后派发。回调不会在一次读属性的中途被调用。
- 没有监听器时不派发。属性照样随时读得到最新的状态。
- 监听
change不报错,这一点在验收用例里验证过。断网、连上网络、换一种网络时事件来不来,未在模拟器验证:模拟器跟着运行它的 Mac 的网络走,验收改不了网络。
示例
js
const network = application.network;
const onChange = () => {
console.log('网络变了:', network.isConnected, network.type, network.isExpensive);
};
network.addEventListener('change', onChange);效果:关掉 Wi-Fi 改走蜂窝数据时,输出一行 网络变了: true cellular true。未在模拟器验证。
不再需要时用 network.removeEventListener('change', onChange) 移除。
对应的 iOS API
Network 框架的 nw_path_monitor_set_update_handler()。系统每给出一条新的网络路径就调一次那个回调;这里只在三项里有一项变了时才派发 change。