sendEvent

将任意一个自定义事件广播出去,该事件可在任意页面通过 addEventListener 监听收到。

sendEvent({params})

params

name

  • 类型:字符串
  • 默认值:无
  • 描述:任意自定义事件的名称,比如:apprunning、appover等

extra

  • 类型:字符串或 JSON 对象
  • 默认值:无
  • 描述:(可选项)附带的参数。在监听页面的回调里面通过 ret.value 获取。

示例代码

  1. api.sendEvent({
  2. name: 'myEvent',
  3. extra: {
  4. key1: 'value1',
  5. key2: 'value2'
  6. }
  7. });
  8. //html页面a:
  9. api.addEventListener({
  10. name: 'myEvent'
  11. }, function(ret, err) {
  12. alert(JSON.stringify(ret.value));
  13. });
  14. //html页面b:
  15. api.addEventListener({
  16. name: 'myEvent'
  17. }, function(ret, err) {
  18. alert(JSON.stringify(ret.value));
  19. });
  20. //a、b页面都将收到 myEvent 事件

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本