webBrowser2018

来自于:开发者

概述

使用腾讯x5的内核,防广告植入。可以设置userAgent变量,以及加入获取网页title和url的方法,方便用户实现分享功能。

使用升级环境编译

openWin

打开一个全屏的浏览器窗口。

openWin({params},callback(ret))

params

url:

  • 类型:字符串
  • 描述:(必填)网址。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.openWin({
        "url": "http://www.baidu.com"
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

openFrame

以小窗口的形式打开网页。

openFrame({params}, callback(ret))

params

url:

  • 类型:字符串
  • 描述:(必填)网址。

rect:

  • 类型:JSON 对象
  • 描述:(选填)模块的位置及尺寸。
  • 内部字段:
{
    x: 0,   //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    y: 0,   //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
    h: 300  //(可选项)数字类型;模块的高度;默认:w的3/4
}

fixedOn:

  • 类型:字符串
  • 描述:(选填)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认值:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(选填)模块是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

showAlert:

  • 类型:布尔
  • 描述:(选填)是否显示alert对话框。(也可以调用setShowAlert动态调整)
  • 默认值:true

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.openFrame({
       "rect":{
            x: 160,
            y: 20,
            w: 200,
            h: 200
       },
      "url": "http://www.baidu.com",
      "fixed": true
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

hide

隐藏。

hide()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.hide();

可用性

Android系统

show

显示窗口。

show()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.show();

可用性

Android系统

close

关闭窗口。

close()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.close();

可用性

Android系统

loadUrl

加载网页。(openFrame才有效)

loadUrl({params},callback(ret))

params

url:

  • 类型:字符串
  • 描述:(必填)网址。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.loadUrl({
         "url": "http://www.qq.com"
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

setRect

调整窗口位置。(openFrame才有效)

setRect({params}, callback(ret))

params

rect:

  • 类型:JSON 对象
  • 描述:(选填)模块的位置及尺寸。
  • 内部字段:
{
    x: 0,   //(可选项)数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
    y: 0,   //(可选项)数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
    w: 320, //(可选项)数字类型;模块的宽度;默认:所属的 Window 或 Frame 的宽度
    h: 300  //(可选项)数字类型;模块的高度;默认:w的3/4
}

fixedOn:

  • 类型:字符串
  • 描述:(选填)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认值:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(选填)模块是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setRect({
        rect:{
            x:0,
            y:0,
            w:100,
            h:100
        }
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

historyBack

返回上一个page页面。(openFrame才有效)

historyBack()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.historyBack();

可用性

Android系统

historyForward

前进一个page页面。(openFrame才有效)

historyForward()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.historyForward();

可用性

Android系统

canGoBack

能否返回上一个page页面。(openFrame才有效)

canGoBack(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code : 0 ,   //0正常,-1错误
    msg : "" ,  //提示信息
    canGoBack: true  //是否可以返回上一个page页面
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.canGoBack(function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

getUserAgent

获取userAgent信息。

getUserAgent(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code : 0 ,   //0正常,-1错误
    msg : "" ,  //提示信息
    userAgent: ""  //userAgent信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.getUserAgent(function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

setUserAgent

设置userAgent。

setUserAgent({params},callback(ret))

params

userAgent:

  • 类型:字符串
  • 描述:(必填)userAgent。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setUserAgent({
        "userAgent": "APICloud"
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

getPageInfo

获取page网页信息,包括title、url。

getPageInfo(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code : 0 ,   //0正常,-1错误
    msg : "" ,  //提示信息
    title: "" ,  //网页标题
    url: ""      //网址
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.getPageInfo(function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

setEventListener

监听事件。(当网页加载完成时会回调,有时候输入一个地址,会有好几个页面加载事件)

setEventListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 1 ,   //页面加载完成事件
    msg : "pageFinished" ,   //事件名称
    title : "百度一下" ,      //网页标题
    url : "http://www.baidu.com" , //网址
    canGoBack : true ,         //网页是否可以后退
    canGoForward : false        //网页是否可以前进
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setEventListener(function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

removeEventListener

移除事件监听。

removeEventListener()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.removeEventListener();

可用性

Android系统

loadScript

执行javaScript。

loadScript({params},callback(ret))

params

script

  • 类型:字符串
  • 描述:(必填)javaScript脚本。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误
    msg : "" ,  //提示信息
    value : ""  //函数的返回值,没有为null
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.loadScript({"script":'javascript:function abc(){return {"name":"ken"};};abc();'},function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

reload

重新加载。

reload()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.reload();

可用性

Android系统

getProgress

获取当前的进度值,整数值,最高是100。

getProgress()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    alert(webBrowser2018.getProgress());

可用性

Android系统

clearCache

清缓存。

clearCache()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.clearCache();

可用性

Android系统

filter

过滤网址,被过滤了的网址就算点击了也打不开,主要是为了不让用户跳出活动页。

filter({params},callback(ret))

params

urls:

  • 类型:数组
  • 描述:(必填)里面填url地址,可以用正则表达式。

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误, 1被过滤掉的url
    msg : ""   //提示信息
}

示例代码

    //测试url=https://angelshelter.cn:8443/test2.html
    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.filter({
        "urls": [
            "http://www.qq.com/",
            "http://www.163.com/",
        ]
    }, function(ret){
        alert(JSON.stringify(ret));
    });

可用性

Android系统

filterResource

过滤资源加载,主要功能主动过滤广告js的植入。

filterResource({params},callback(ret))

params

urls:

  • 类型:数组
  • 描述:(必填)里面填资源 (比如图片、css、js) 的url地址,可以用正则表达式。

report:

  • 类型:布尔
  • 描述:(必填)如果拦截了,是否反馈回来,主要是为了调试,正式环境最好关闭 (默认关闭)。
  • 默认值: false

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    code: 0 ,   //0正常,-1错误, 1被过滤掉的url
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.filterResource({
        urls:["http://www.yuyue008.cn/7028.js"],
        report:false
    });

可用性

Android系统

setShowAlert

设置是否显示alert。

setShowAlert({params})

params

showAlert:

  • 类型:布尔
  • 描述:(必填)设置是否显示alert。

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setShowAlert({
        showAlert: false
    });

可用性

Android系统