跳转到内容
WebView AllWebView All
这是 1.2.x 版本的文档,最新接口请切换至 latest。

JavaScript

JavaScript 能力包括执行脚本、返回值、channel、console 和浏览器对话框。

await controller.setJavaScriptMode(JavaScriptMode.unrestricted);
await controller.setJavaScriptMode(JavaScriptMode.disabled);

Web 平台禁用 JavaScript 时会应用更严格的 iframe sandbox。

await controller.runJavaScript('document.body.classList.add("ready")');
final value = await controller.runJavaScriptReturningResult('1 + 2');

返回值说明:

平台行为
Android使用 Android WebView evaluate。
iOS/macOS使用 WebKit evaluate,不能桥接的值会失败。
Windows使用 WebView2 script execution。
Linux使用 WebKitGTK,并按需要解码 JSON。
OHOS使用 ArkWeb evaluateJavascript。
Web同源 iframe eval,结果需可 JSON 序列化。
await controller.addJavaScriptChannel(
'Checkout',
onMessageReceived: (JavaScriptMessage message) {
debugPrint('Checkout event: ${message.message}');
},
);

页面侧:

Checkout.postMessage(JSON.stringify({ type: 'loaded' }));

不再需要时移除:

await controller.removeJavaScriptChannel('Checkout');
await controller.setOnConsoleMessage((JavaScriptConsoleMessage message) {
debugPrint('[${message.level.name}] ${message.message}');
});

所有 native 平台都支持 console 回调;Web 需要同源内容才能安装 hook。

await controller.setOnJavaScriptAlertDialog((request) async {});
await controller.setOnJavaScriptConfirmDialog((request) async {
return true;
});
await controller.setOnJavaScriptTextInputDialog((request) async {
return request.defaultText ?? '';
});
平台alertconfirmprompt
Android支持支持支持
iOS/macOS支持支持支持
Windows支持支持支持
Linux支持支持支持
OHOS支持支持支持
Web同源支持同源且同步返回同源且同步返回

Web 的 confirm 和 prompt 是浏览器同步 API,回调应返回 SynchronousFuture:

await controller.setOnJavaScriptConfirmDialog((request) {
return SynchronousFuture<bool>(true);
});