本模块首批接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
本Class首批接口从API version 12开始支持。
示例效果请以真机运行为准。
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
Class (WebSchemeHandlerRequest)
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
复制页面
本文导读
WebSchemeHandlerRequest类模块定义了通过WebSchemeHandler拦截到的资源请求的封装对象。当开发者注册自定义协议处理器（WebSchemeHandler）后，Web内核在拦截到匹配协议的请求时会创建WebSchemeHandlerRequest实例并传递给回调方法。该对象提供以下请求信息查询方法：获取请求头信息、请求URL、请求方法、来源URL、判断是否为主框架请求、是否关联用户手势、获取请求体流、资源类型以及触发该请求的Frame URL，从而据此决定是否拦截该请求并构造相应响应。
说明
getHeader12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getHeader(): Array<WebHeader>
获取资源请求头信息。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| Array<WebHeader> | 返回资源请求头信息。 |
示例：
完整示例代码参考onRequestStart。
getRequestUrl12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getRequestUrl(): string
获取资源请求的URL信息。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| string | 返回资源请求的URL信息。 |
示例：
完整示例代码参考onRequestStart。
getRequestMethod12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getRequestMethod(): string
获取请求方法。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| string | 返回请求方法。 |
示例：
完整示例代码参考onRequestStart。
getReferrer12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getReferrer(): string
获取referrer。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| string | 获取到的referrer。 |
示例：
完整示例代码参考onRequestStart。
isMainFrame12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
isMainFrame(): boolean
判断资源请求是否为主Frame。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| boolean | 判断资源请求是否为主Frame，如果资源请求是主Frame则返回true，否则返回false。 |
示例：
完整示例代码参考onRequestStart。
hasGesture12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
hasGesture(): boolean
获取资源请求是否与手势（如点击）相关联。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| boolean | 返回资源请求是否与手势（如点击）相关联，如果资源请求与手势相关联则返回true，否则返回false。 |
示例：
完整示例代码参考onRequestStart。
getHttpBodyStream12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getHttpBodyStream(): WebHttpBodyStream | null
获取资源请求中的WebHttpBodyStream。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| WebHttpBodyStream | null | 返回资源请求中的WebHttpBodyStream，如果没有则返回null。 |
示例：
完整示例代码参考onRequestStart。
getRequestResourceType12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getRequestResourceType(): WebResourceType
获取资源请求的资源类型。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| WebResourceType | 返回资源请求的资源类型。 |
示例：
完整示例代码参考onRequestStart。
getFrameUrl12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getFrameUrl(): string
获取触发此请求的Frame的URL。
系统能力： SystemCapability.Web.Webview.Core
返回值：
展开
| 类型 | 说明 |
|---|---|
| string | 返回触发此请求的Frame的URL。 |
示例：
完整示例代码参考onRequestStart。
华为开发者联盟 版权所有 ©2026