目录

Class (WebSchemeHandlerRequest)

WebSchemeHandlerRequest类模块定义了通过WebSchemeHandler拦截到的资源请求的封装对象。当开发者注册自定义协议处理器（WebSchemeHandler）后，Web内核在拦截到匹配协议的请求时会创建WebSchemeHandlerRequest实例并传递给回调方法。该对象提供以下请求信息查询方法：获取请求头信息、请求URL、请求方法、来源URL、判断是否为主框架请求、是否关联用户手势、获取请求体流、资源类型以及触发该请求的Frame URL，从而据此决定是否拦截该请求并构造相应响应。

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

  • 本Class首批接口从API version 12开始支持。

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

getHeader12+

getHeader(): Array<WebHeader>

获取资源请求头信息。

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

返回值：

类型 说明
Array<WebHeader> 返回资源请求头信息。

示例：

完整示例代码参考onRequestStart。

getRequestUrl12+

getRequestUrl(): string

获取资源请求的URL信息。

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

返回值：

类型 说明
string 返回资源请求的URL信息。

示例：

完整示例代码参考onRequestStart。

getRequestMethod12+

getRequestMethod(): string

获取请求方法。

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

返回值：

类型 说明
string 返回请求方法。

示例：

完整示例代码参考onRequestStart。

getReferrer12+

getReferrer(): string

获取referrer。

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

返回值：

类型 说明
string 获取到的referrer。

示例：

完整示例代码参考onRequestStart。

isMainFrame12+

isMainFrame(): boolean

判断资源请求是否为主Frame。

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

返回值：

类型 说明
boolean 判断资源请求是否为主Frame，如果资源请求是主Frame则返回true，否则返回false。

示例：

完整示例代码参考onRequestStart。

hasGesture12+

hasGesture(): boolean

获取资源请求是否与手势（如点击）相关联。

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

返回值：

类型 说明
boolean 返回资源请求是否与手势（如点击）相关联，如果资源请求与手势相关联则返回true，否则返回false。

示例：

完整示例代码参考onRequestStart。

getHttpBodyStream12+

getHttpBodyStream(): WebHttpBodyStream | null

获取资源请求中的WebHttpBodyStream。

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

返回值：

类型 说明
WebHttpBodyStream | null 返回资源请求中的WebHttpBodyStream，如果没有则返回null。

示例：

完整示例代码参考onRequestStart。

getRequestResourceType12+

getRequestResourceType(): WebResourceType

获取资源请求的资源类型。

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

返回值：

类型 说明
WebResourceType 返回资源请求的资源类型。

示例：

完整示例代码参考onRequestStart。

getFrameUrl12+

getFrameUrl(): string

获取触发此请求的Frame的URL。

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

返回值：

类型 说明
string 返回触发此请求的Frame的URL。

示例：

完整示例代码参考onRequestStart。