AutoJs6

AutoJs6 文档 - 6.3.3

索引 | 查看全部

万维网 (Web)#

在应用里显示网页内容, 而不是打开独立的浏览器, 此时可使用 WebView 类, 以实现在 activity 中显示网页内容.

web 模块主要用于 WebView 网页的 [ 注入 (Inject) / 构建客户端 ] 等.

注: 与 http 模块不同, http 模块主要用于网络的请求与响应.

web

[m] newInjectableWebView#

newInjectableWebView(url?)#

6.3.0 Global Overload [1-2]/3 UI

[ url ] { string } - 需要 WebView 加载的 URL
returns { InjectableWebView }

新建并返回一个 InjectableWebView (可注入的 WebView) 实例.

'ui';

ui.layout(<vertical>
    <frame id="main"/>
</vertical>);

/* 创建一个 InjectableWebView 实例. */
let webView = newInjectableWebView();
/* 加载指定的 URL, "https://" 也可省略. */
webView.loadUrl('https://www.github.com');
/* 注入 JavaScript 脚本, 显示 alert 消息框. */
webView.inject('alert("hello")');
/* 附加视图对象到 id 为 main 的视图上. */
ui.main.addView(webView);

上述示例也可使用 setContentView 实现更简单的内容加载 (但不包含代码注入):

'ui';
activity.setContentView(web.newInjectableWebView('www.github.com'));

除上述注入简单的 alert 消息框外, 还支持其他更多注入方式:

/* 以给定的 URL 来替换当前的资源. */
webView.inject('document.location.replace("https://www.jetbrains.com")');
/* 替换整个 document 的内容. */
webView.inject('document.write("hello")');
/* 替换 body 元素为指定的 HTML 内容. */
webView.inject('document.body.innerHTML = "<p>hello</p>"');
/* 指定 body 元素的字体颜色. */
webView.inject('document.body.style = "color:green"');
/* 在文档末尾附加一个自定义元素. */
webView.inject('let p = document.createElement("p"); p.innerHTML = "hello"; document.body.appendChild(p)');
/* 使用回调方法获取内部信息. */
webView.inject('navigator.userAgent', result => console.log(result));

如需对上述 webView 实例进行一些设置, 可通过 webView.getSettings() 获得 android.webkit.WebSettings 对象, 再进行个性化设置:

let settings = webView.getSettings();

/* 设置 WebView 默认字体大小, 默认值 16. */
settings.setDefaultFontSize(18);
/* 设置是否允许脚本自动弹出新窗口, 默认 false. */
settings.setJavaScriptCanOpenWindowsAutomatically(true);
/* 设置 WebView 是否支持使用屏幕控件或手势进行缩放, 默认 true. */
settings.setSupportZoom(false);

/* ... */

对于 InjectableWebView, 其内部已经对 WebView 进行了一些初始化设置, 包括:

settings.setUseWideViewPort(true);
settings.setBuiltInZoomControls(true);
settings.setLoadWithOverviewMode(true);
settings.setJavaScriptEnabled(true);
settings.setJavaScriptCanOpenWindowsAutomatically(true);
settings.setDomStorageEnabled(true);
settings.setDisplayZoomControls(false);

注: 上述设置参考自 Auto.js 4.1.1 Alpha2 源码.

此外, InjectableWebView 内部还初始化了一个默认的 WebChromeClient 客户端:

setWebChromeClient(new WebChromeClient());

注:
WebChromeClient 中的 "Chrome" 与 Google Chrome 浏览器中的 "Chrome" 不同.
WebView 中的 "Chrome" 指代 WebView 外面的装饰及 UI 部分.
WebChromeClient 是 HTML/JavaScript 与 Android 客户端交互的中间件, 它将 WebView 中 JavaScript 产生的事件封装后传递到 Android 客户端, 从而避免一些可能的安全问题.
同时 WebChromeClient 也可以辅助 WebView 处理 JavaScript 对话框, 显示加载进度, 上传文件等.

在 WebView 中访问了多个网页时, 按返回键会立即关闭整个页面, 而不是回退到上一个历史网页.
如果希望在 WebView 里浏览历史网页, 可参考如下代码:

ui.emitter.on('back_pressed', function (e) {
    if (webView.canGoBack()) {
        webView.goBack();
        e.consumed = true;
    }
});

newInjectableWebView(activity)#

6.3.0 Global Overload 3/3 UI

activity { ScriptExecuteActivity } - 上下文对象, 默认为 UI 模式下的全局 activity 对象
returns { InjectableWebView }

新建并返回一个 InjectableWebView (可注入的 WebView) 实例, 通过 activity 参数可传入不同的 org.mozilla.javascript.Context 上下文对象, 该对象主要用于执行 JavaScript 语句.

[m] newInjectableWebClient#

newInjectableWebClient()#

6.3.0 Global

returns { InjectableWebClient }

新建并返回一个 InjectableWebClient (可注入的 WebViewClient) 实例.

/* 为 webView 对象重新设置一个新的客户端. */
webView.setWebViewClient(newInjectableWebClient());

[m] newWebSocket#

newWebSocket(url)#

6.3.1 Global

url { string }
returns { WebSocket }

新建并返回一个 WebSocket 实例.

console.setExitOnClose(7e3).show();

let ws = web.newWebSocket('wss://echo.websocket.events');

ws
    .on('open', (res, ws) => {
        console.log('WebSocket 已连接');
    })
    .on('message', (message, ws) => {
        console.log('接收到消息');
        // if (message instanceof okio.ByteString) {
        //     console.log(`消息类型: ByteString`);
        // } else if (typeof message === 'string') {
        //     console.log(`消息类型: String`);
        // } else {
        //     throw TypeError('Should never happen');
        // }
    })
    .on('text', (text, ws) => {
        console.info('接收到文本消息:');
        console.info(`text: ${text}`);
    })
    .on('bytes', (bytes, ws) => {
        console.info('接收到字节数组消息:');
        console.info(`utf8: ${bytes.utf8()}`);
        console.info(`base64: ${bytes.base64()}`);
        console.info(`md5: ${bytes.md5()}`);
        console.info(`hex: ${bytes.hex()}`);
    })
    .on('closing', (code, reason, ws) => {
        console.log('WebSocket 关闭中');
    })
    .on('closed', (code, reason, ws) => {
        console.log('WebSocket 已关闭');
        console.log(`code: ${code}`);
        if (reason) console.log(`reason: ${reason}`);
    })
    .on('failure', (err, res, ws) => {
        console.error('WebSocket 连接失败');
        console.error(err);
    });

/* 发送文本消息. */
ws.send('Hello WebSocket');

/* 发送字节数组消息. */
ws.send(new okio.ByteString(new java.lang.String('Hello WebSocket').getBytes()));

setTimeout(() => {
    console.log('断开 WebSocket');

    /* code 支持的范围 [1000,5000). */
    /* 1000 表示成功操作或常规的 Socket 关闭操作. */
    /* 参阅 https://github.com/Luka967/websocket-close-codes */
    ws.close(1000, 'Closed by user');
}, 8e3);

setTimeout(() => console.log('Exit'), 9e3);

目录