chrome.app 库模块帮助文档

chrome 成员列表

chrome.app()

返回对象:processchromeappObject

chrome.app(父窗口,chrome启动程序路径)

调用系统已安装的chrome创建应用程序
所有参数可选，参数@2也可以指定CEF3启动程序cefclient.exe的路径
使用CEF3支持在参数@1指定父窗口并嵌入浏览器到该窗口,
原版Chrome嵌入父窗口会出现兼容性问题,

返回对象:processchromeappObject

chrome.app 成员列表

调用系统已安装的 Chrome 创建应用程序，
支持 Chrome 、 Edge（Chromium ）、Supermium 等浏览器，

如果没有找到可用的浏览器会下载安装 Microsoft Edge (Chromium)。
Win7 则自动安装 Chrome 109，XP 自动安装 Chrome 49

chrome.app.path

自定义Chrome.exe位置,
支持Chrome,兼容Chrome启动参数的Chrome内核浏览器,
也可以指定CEF3启动程序cefclient.exe

processchromeappObject 成员列表

processchromeappObject._form

创建chrome.app时指定的父窗口

返回对象:staticObject

processchromeappObject.accessControlAllowOrigin

允许写入 Access-Control-Allow-Headers 响应头的站点地址。
此属性必须为 null、字符串，或者指定为一个表对象,
表的键为允许跨域调用的站点地址,值必须为 true
站点地址应使用 https://host 格式，且结尾不要有斜杠，
新的浏览器已经禁止在非 HTTPS 协议下调用本机地址，
而老版浏览器则反之

processchromeappObject.accessControlRequestPrivateNetwork

自定义 Access-Control-Request-Private-Network 响应头的值，
默认为 "true"，可改为 null

processchromeappObject.addArguments()

添加一个或多个Chrome启动参数,
参数也可以是一个包含多个启动参数的数组
注意参数中不必要使用引号,多个参数应分开写不要拼接成一个参数
每个启动参数都是使用两个横杠开始的字符串
chrome启动参数大全

processchromeappObject.callback(name,callback)

processchromeappObject.callback("/*要接收返回值的JS函数名,  
回调叁数$为RPC客户端套接字句柄  
成功result为返回值,失败err为错误信息*/",function($,result,err){  

})

processchromeappObject.center

居中窗口,并调整以保证显示在可见范围内,
如果要调用此函数,建议在调用 start 函数前调用,
只有浏览器显示为独立窗口时才支持此函数

processchromeappObject.center(目标窗口句柄)

居中窗口,并调整以保证显示在可见范围内,
如果要调用此函数,建议在调用 start 函数前调用,
目标窗口句柄如果为空则取父窗口或所有者窗口,为0表示桌面

processchromeappObject.chromePath

chrome启动exe文件路径

processchromeappObject.chromeProcessId

chrome进程ID
注意chrome可能会使用一个进程启动多个独立的应用

processchromeappObject.chromeThreadId

chrome启动线程ID

processchromeappObject.close()

关闭chrome窗口

processchromeappObject.doScript($,js,...)

在chrome中执行javascript代码,忽略返回值,
在js参数后可选指定多个字符串格式化参数用于调用string.form格式化代码,

参数@1指定客户端套接字句柄,
RPC服务端远程回调函数名首字符为$时,
第一个回调$参数即为当前客户端套接字句柄,
除非熟悉 getActiveSocket 函数导致的潜在问题,请不要省略$参数

processchromeappObject.external

processchromeappObject.external = {
    /*可以在这里指定允许chrome访问的对象和函数  
在chrome里引用虚拟的"/aardio.js"导入aardio对象即可访问这里的成员函数,  
必须在调用start函数以前设置此对象才能生效*/
}

processchromeappObject.favicon

指定窗口图标路径
默认为/res/favicon.ico

processchromeappObject.getActiveSocket()

获取RPC服务端当前活动套接字句柄
,任何触发消息处理、异步套接字处理程序的代码都有可能改变这个函数的返回值
任何时候都不推荐使用此函数

更好的替代方案是在RPC函数名前添加$字符,用于通知aardio在回调参数中添加$参数
回调$参数可以稳定可靠的获取当前套接字

processchromeappObject.getUrl("/")

参数指定资源文件路径,
转换并返回为可以通过内嵌 HTTP 服务端访问的网址

如果使用 start 函数启动了单页应用，且启动文件名为 "index.html" 或 "index.aardio"，
chrome.app 会自动将启动路径的上级目录设为 http.documentBase。
此时 getUrl 的参数应当以 http.documentBase 为根目录

processchromeappObject.http

aardio创建的HTTP服务器

返回对象:asynHttpServerObject

processchromeappObject.httpHandler

processchromeappObject.httpHandler["/test.js" ] = function(response,request){
    /*自定义HTTP处理程序  
键为请求的路径,值为处理函数或者HTML代码*/
}

processchromeappObject.hwndChrome

chrome窗口句柄
如果在wine环境下运行，此窗口句柄为空值,依赖此句柄的部分chrome窗口操作函数将无效