webBrowser2018

来自于：开发者

openWin hide close setRect historyForward getUserAgent getPageInfo removeEventListener reload clearCache filterResource setDayOrNight

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

使用升级环境编译

openWin

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

openWin({params}，callback(ret))

url：

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

dayOrNight：

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

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：

示例代码

  2.     webBrowser2018.openWin({
  3.         "url": "http://www.baidu.com"
  4.     }, function(ret){
  5.         alert(JSON.stringify(ret));

可用性

Android系统

openFrame

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

openFrame({params}, callback(ret))

params

url：

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

rect：

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

fixedOn：

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

fixed：

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

showAlert：

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

backgroundTransparent：

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

callback(ret)

ret：

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

示例代码

  1.     var webBrowser2018 = api.require('webBrowser2018');
  2.     webBrowser2018.openFrame({
  3.        "rect":{
  4.             x: 160,
  5.             y: 20,
  6.             w: 200,
  7.             h: 200
  8.        },
  9.       "url": "http://www.baidu.com",
  10.       "fixed": true
  11.     }, function(ret){
  12.         alert(JSON.stringify(ret));
  13.     });

可用性

Android系统

hide

隐藏。

hide()

示例代码

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

可用性

Android系统

show

显示窗口。

show()

示例代码

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

可用性

Android系统

close

关闭窗口。

close()

示例代码

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

可用性

Android系统

loadUrl

加载网页。(openFrame才有效)

loadUrl({params}，callback(ret))

params

url：

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

callback(ret)

ret：

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

示例代码

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

可用性

Android系统

setRect

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

params

rect：

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

fixedOn：

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

fixed：

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

callback(ret)

ret：

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

示例代码

可用性

Android系统

historyBack

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

historyBack()

示例代码

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

Android系统

historyForward

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

historyForward()

示例代码

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

可用性

Android系统

canGoBack

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

canGoBack(callback(ret))

callback(ret)

ret：

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

示例代码

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

可用性

Android系统

getUserAgent

获取userAgent信息。

getUserAgent(callback(ret))

callback(ret)

ret：

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

示例代码

  1.     var webBrowser2018 = api.require('webBrowser2018');
  2.     webBrowser2018.getUserAgent(function(ret){
  3.     });

可用性

Android系统

setUserAgent

设置userAgent。

setUserAgent({params}，callback(ret))

params

userAgent：

  • 类型：字符串
  • 描述：（必填）userAgent。

callback(ret)

ret：

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

示例代码

  1.     var webBrowser2018 = api.require('webBrowser2018');
  2.     webBrowser2018.setUserAgent({
  3.         "userAgent": "APICloud"
  4.     }, function(ret){
  5.         alert(JSON.stringify(ret));
  6.     });

可用性

Android系统

getPageInfo

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

getPageInfo(callback(ret))

callback(ret)

ret：

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

示例代码

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

可用性

Android系统

setEventListener

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

setEventListener(callback(ret))

callback(ret)

ret：

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

示例代码

可用性

Android系统

removeEventListener

移除事件监听。

removeEventListener()

示例代码

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

可用性

Android系统

loadScript

loadScript({params}，callback(ret))

params

script

  • 类型：字符串
  • 描述：（必填）javaScript脚本。

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     code: 0 ,   //0正常，-1错误
  3.     msg : "" ,  //提示信息
  4.     value : ""  //函数的返回值，没有为null
  5. }
  1.     var webBrowser2018 = api.require('webBrowser2018');
  2.     webBrowser2018.loadScript({"script":'javascript:function abc(){return {"name":"ken"};};abc();'},function(ret){
  3.         alert(JSON.stringify(ret));
  4.     });

可用性

Android系统

reload

重新加载。

reload()

示例代码

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

可用性

Android系统

getProgress

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

getProgress()

示例代码

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

可用性

Android系统

clearCache

清缓存。

clearCache()

示例代码

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

可用性

Android系统

filter

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

filter({params}，callback(ret))

params

urls:

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

callback(ret)

ret：

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

示例代码

  1.     //测试url=https://angelshelter.cn:8443/test2.html
  2.     var webBrowser2018 = api.require('webBrowser2018');
  3.     webBrowser2018.filter({
  4.         "urls": [
  5.             "http://www.qq.com/",
  6.             "http://www.163.com/",
  7.         ]
  8.     }, function(ret){
  9.         alert(JSON.stringify(ret));
  10.     });

可用性

Android系统

filterResource

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

filterResource({params}，callback(ret))

params

urls:

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

report:

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

callback(ret)

ret：

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

示例代码

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

可用性

Android系统

setShowAlert

设置是否显示alert。

setShowAlert({params})

params

showAlert:

  • 类型：布尔
  • 描述：（必填）设置是否显示alert。

示例代码

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

可用性

Android系统

setDayOrNight

设置白天/夜间模式。

setDayOrNight({params})

params

dayOrNight:

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

示例代码

可用性

Android系统

setBackgroundTransparent

设置背景透明。

setBackgroundTransparent({params})

params

backgroundTransparent:

  • 类型：布尔
  • 描述：（选填）true透明,false不透明
  • 默认值：false
  1.     var webBrowser2018 = api.require('webBrowser2018');
  2.     webBrowser2018.setBackgroundTransparent({
  3.         backgroundTransparent: true

可用性