webBrowser2018

/* Title: webBrowser2018 Description: webBrowser2018 */

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

使用升级环境编译

openWin

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

openWin({params}，callback(ret))

params

url：

类型：字符串
描述：（必填）网址。

dayOrNight：

类型：布尔
描述：（选填）true白天模式,false夜间模式
默认值：true

callback(ret)

ret：

类型：JSON对象
内部字段：

{
    code: 0 ,   //0正常，-1错误
    msg : ""   //提示信息
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.openWin({
        "url": "http://www.baidu.com"
    }, function(ret){
        api.alert({msg: 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

backgroundTransparent：

类型：布尔
描述：（选填）true透明,false不透明
默认值：false

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){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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": "YonBuilder移动开发"
    }, function(ret){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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){
        api.alert({msg: 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系统

setDayOrNight

设置白天/夜间模式。

setDayOrNight({params})

params

dayOrNight:

类型：布尔
描述：（选填）白天模式true,夜间模式false。
默认值：true

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setDayOrNight({
        dayOrNight: false
    });

可用性

Android系统

setBackgroundTransparent

设置背景透明。

setBackgroundTransparent({params})

params

backgroundTransparent:

类型：布尔
描述：（选填）true透明,false不透明
默认值：false

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.setBackgroundTransparent({
        backgroundTransparent: true
    });

可用性

Android系统

getProgressAsync

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

getProgressAsync(callback(ret))

callback(ret)

ret：

类型：JSON对象
内部字段：

{
    progress: 1   //进度值
}

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    webBrowser2018.getProgressAsync(function(ret){
        alert(ret.progress);
    });

可用性

Android系统

isX5Core

当前是不是x5内核

isX5Core()

示例代码

    var webBrowser2018 = api.require('webBrowser2018');
    boolean b = webBrowser2018.isX5Core();

可用性

Android系统

是否仍需要帮助？请保持联络！

最后更新于 2024/11/18