AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Barcode - 条码
- QR Code - 二维码
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Shizuku
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- WebSocket
- EventEmitter - 事件发射器
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpencvPoint
- OpencvRect
- OpencvSize

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# 万维网 (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 } - 请求的 URL 地址
- returns { WebSocket }

构建一个 WebSocket 实例.

相当于 `new WebSocket(url)`.

> 参阅: WebSocket 章节