webBrowser2018

来自于:开发者立即使用

来自于:开发者

openWin openFrame hide show close loadUrl setRect historyBack historyForward canGoBack getUserAgent setUserAgent getPageInfo setEventListener removeEventListener loadScript reload getProgress clearCache filter filterResource setShowAlert setDayOrNight setBackgroundTransparent

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

使用升级环境编译

openWin

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

openWin({params},callback(ret))

params

url:

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

dayOrNight:

  • 类型:布尔
  • 描述:(选填)true白天模式,false夜间模式
  • 默认值:true

callback(ret)

ret:

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

示例代码

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

可用性

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才有效)

setRect({params}, callback(ret))

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对象
  • 内部字段:
  1. {
  2. code: 0 , //0正常,-1错误
  3. msg : "" //提示信息
  4. }

示例代码

  1. var webBrowser2018 = api.require('webBrowser2018');
  2. webBrowser2018.setRect({
  3. rect:{
  4. x:0,
  5. y:0,
  6. w:100,
  7. h:100
  8. }
  9. }, function(ret){
  10. alert(JSON.stringify(ret));
  11. });

可用性

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. alert(JSON.stringify(ret));
  4. });

可用性

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" , //网址
  6. canGoBack : true , //网页是否可以后退
  7. canGoForward : false //网页是否可以前进
  8. }

示例代码

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

可用性

Android系统

removeEventListener

移除事件监听。

removeEventListener()

示例代码

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

可用性

Android系统

loadScript

执行javaScript。

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

示例代码

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

可用性

Android系统

setBackgroundTransparent

设置背景透明。

setBackgroundTransparent({params})

params

backgroundTransparent:

  • 类型:布尔
  • 描述:(选填)true透明,false不透明
  • 默认值:false

示例代码

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

可用性

Android系统