模块描述

WebView模块是HarmonyOS ArkWeb框架提供的Web控制能力模块,用于在应用侧对Web组件的行为进行编程式控制。该模块不涉及网页的显示渲染(显示能力由Web组件提供),而是聚焦于Web组件运行过程中的控制逻辑,包括页面加载与导航、JavaScript脚本执行与双向消息通信、Cookie与存储管理、下载任务管理、网络请求拦截与自定义响应、代理配置、地理位置权限管理、广告过滤、前进后退缓存、媒体播放托管、PDF生成等能力。

开发者在使用Web组件展示网页内容时,如需在应用侧对网页行为进行干预、监听或扩展(例如:向网页发送消息、拦截特定Scheme请求并返回本地资源、管理下载流程、配置代理、控制缓存策略等),应通过本模块提供的Controller和各类Manager/Delegate来实现。

网页显示的能力请参考组件描述。

元服务中使用ArkWeb的说明,请参考Web组件概述。

  • 本模块首批接口从API version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

  • 示例效果请以真机运行为准。

  • 静态方法必须在用户界面(UI)线程上使用。

该模块提供以下Web控制相关的常用功能:

需要权限

访问在线网页时需添加网络权限:ohos.permission.INTERNET,具体申请方式请参考声明权限。

导入模块

import { webview } from '@kit.ArkWeb';

系统能力: SystemCapability.Web.Webview.Core