openharmony 鸿蒙 arkts-apis-webview-WebResourceHandler

2025-06-12 浏览 (1)

Class (WebResourceHandler)

通过WebResourceHandler,可以提供自定义的返回头以及返回体给Web组件。

说明:

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

  • 示例效果请以真机运行为准,当前IDE预览器不支持。

didReceiveResponse12+

didReceiveResponse(response: WebSchemeHandlerResponse): void

将构造的响应头传递给被拦截的请求。

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

参数:

参数名类型必填说明
responseWebSchemeHandlerResponse该拦截请求的响应。

错误码:

以下错误码的详细介绍请参见webview错误码

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
17100021The resource handler is invalid.

示例:

示例请参考OnRequestStart

didReceiveResponseBody12+

didReceiveResponseBody(data: ArrayBuffer): void

将构造的响应体传递给被拦截的请求。

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

参数:

参数名类型必填说明
dataArrayBuffer响应体数据。

错误码:

以下错误码的详细介绍请参见webview错误码

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified.
17100021The resource handler is invalid.

示例:

示例请参考OnRequestStart

didFinish12+

didFinish(): void

通知Web组件被拦截的请求已经完成,并且没有更多的数据可用,调用前需要优先调用didReceiveResponse将构造的响应头传递给被拦截的请求。

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

错误码:

以下错误码的详细介绍请参见webview错误码

错误码ID错误信息
17100021The resource handler is invalid.

示例:

示例请参考OnRequestStart

didFail12+

didFail(code: WebNetErrorList): void

通知ArkWeb内核被拦截请求应该返回失败,调用前需要优先调用didReceiveResponse将构造的响应头传递给被拦截的请求。

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

参数:

参数名类型必填说明
codeWebNetErrorList网络错误码。

错误码:

以下错误码的详细介绍请参见webview错误码

错误码ID错误信息
401Parameter error. Possible causes: 1. Incorrect parameter types.
17100021The resource handler is invalid.

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

示例:

示例请参考OnRequestStart

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkWeb(方舟Web)

harmony 鸿蒙ArkWeb_AnyNativeAPI

harmony 鸿蒙ArkWeb_ComponentAPI

harmony 鸿蒙ArkWeb_ControllerAPI

harmony 鸿蒙ArkWeb_CookieManagerAPI

harmony 鸿蒙ArkWeb_JavaScriptBridgeData

harmony 鸿蒙ArkWeb_JavaScriptObject

harmony 鸿蒙ArkWeb_JavaScriptValueAPI

harmony 鸿蒙ArkWeb_ProxyMethod

harmony 鸿蒙ArkWeb_ProxyMethodWithResult

  • 所属分类: 后端技术
  • 本文标签: 软件 鸿蒙
  • 版权声明: 本文链接 https://seaxiang.com/blog/Qn8dBx