setFrameClient

设置指定 frame 的页面加载监听，仅在 window 中调用生效，可以对多个 frame 进行监听。

setFrameClient({params}, callback(ret, err))

params

frameName：

  • 类型：字符串
  • 默认值：无
  • 描述：frame 名字

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 描述：frame 加载状态、加载进度等发生变化时的回调
  • 内部字段：
  1. {
  2.     state:0,            //加载状态，数字类型，取值范围：0-开始加载；1-加载进度发生变化；2-结束加载；3-title发生变化；4-url发生变化
  3.     progress:0,         //state为1时，页面的加载进度，数字类型，取值范围 0-100
  4.     title:'',           //state为3时，页面当前的title，字符串类型
  5.     url:''              //state为0|2|4时，页面当前的url，字符串类型
  6. }

示例代码

  1. api.setFrameClient({
  2.     frameName: 'webpage'
  3. }, function(ret, err) {
  4.     switch (ret.state) {
  5.         case 0:
  6.             break;
  7.         case 1:
  8.             break;
  9.         case 2:
  10.             break;
  11.         case 3:
  12.             break;
  13.         case 4:
  14.             break;
  15.         default:
  16.             break;
  17.     }
  18. });

可用性

iOS系统，Android系统

可提供的1.2.0及更高版本