该组件从API version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
本Class从API version 9开始支持。
示例效果请以真机运行为准。
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
Class (SslErrorHandler)
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
复制页面
SslErrorHandler是Web组件中处理SSL证书验证错误的类。当加载安全页面时遇到SSL证书错误（如证书过期、主机名不匹配、不受信任的CA），应用可通过onSslErrorEvent回调获取SslErrorHandler实例，并决定是否继续加载或取消导航。示例代码参考onSslErrorEvent事件。
说明
constructor9+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
constructor()
SslErrorHandler的构造函数。
系统能力： SystemCapability.Web.Webview.Core
handleCancel9+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
handleCancel(): void
通知Web组件取消此请求，并停止当前SSL证书验证流程。
系统能力： SystemCapability.Web.Webview.Core
handleConfirm9+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
handleConfirm(): void
忽略SSL证书验证错误，继续加载页面。
系统能力： SystemCapability.Web.Webview.Core
handleCancel20+
Phone20+PC/2in120+Tablet20+TV20+Wearable20+
handleCancel(abortLoading: boolean): void
通知Web组件取消此请求，并根据参数abortLoading决定是否停止加载。
系统能力： SystemCapability.Web.Webview.Core
参数：
展开
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| abortLoading | boolean | 是 | SSL错误页场景，拒绝错误证书后是否终止页面加载；abortLoading为false时表示不终止，为true时表示终止。 |
华为开发者联盟 版权所有 ©2026