From c29b55831b42687e6111b48f75f31e394fa8db23 Mon Sep 17 00:00:00 2001 From: zhangb Date: Tue, 30 Aug 2022 08:18:50 +0000 Subject: [PATCH] update zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md. Signed-off-by: @i-am-a-little-bird Signed-off-by: zhangb --- .../arkui-ts/ts-basic-components-web.md | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md index c9dc3bdf1c..f5198c46f6 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -1411,6 +1411,56 @@ onHttpAuthRequest(callback: (event?: { handler: HttpAuthHandler, host: string, r } } ``` +### onSslErrorEventReceive9+ + +onSslErrorEventReceive(callback: (event: { handler: SslErrorHandler, error: SslError}) => boolean) + +通知发生SSL错误。 + +**参数:** +| 参数名 | 参数类型 | 参数描述 | +| ------- | ------------------------------------ | ---------------- | +| handler | [SslErrorHandler](#sslerrorhandler9) | 通知Web组件用户操作行为。 | +| error | [SslError](sslerror枚举说明) | 错误码。 | + +**返回值:** +| 类型 | 说明 | +| ------- | --------------------- | +| boolean | 返回false表示此次处理,否则成功。 | + + **示例:** + ```ts + // xxx.ets + @Entry + @Component + struct WebComponent { + controller: WebController = new WebController(); + + build() { + Column() { + Web({ src: 'www.example.com', controller: this.controller }) + .onHttpAuthRequest((event) => { + AlertDialog.show({ + title: 'title', + message: 'text', + confirm: { + value: 'onConfirm', + action: () => { + event.handler.handleConfirm(); + } + } + }, + cancel: () => { + event.handler.handleCancel(); + } + }) + return true; + }) + } + } + } + ``` + ### onPermissionRequest9+ onPermissionRequest(callback: (event?: { request: PermissionRequest }) => void) @@ -2017,6 +2067,23 @@ isHttpAuthInfoSaved(): boolean | ------- | ------------------------- | | boolean | 存在密码认证成功返回true,其他返回false。 | +## SslErrorHandler9+ + +Web组件返回的SSL错误通知用户处理功能对象。示例代码参考[onSslErrorEventReceive事件](#onsslerrorEventreceive9)。 + +### handleCancel9+ + +handleCancel(): void + +通知Web组件用户取消次请求。 + +### handleConfirm9+ + +handleConfirm(): void + +通知Web组件用户继续使用SSL证书。 + + ## PermissionRequest9+ Web组件返回授权或拒绝权限功能的对象。示例代码参考[onPermissionRequest事件](#onpermissionrequest9)。 @@ -4702,6 +4769,17 @@ onRenderExited接口返回的渲染进程退出的具体原因。 | Map | 地理地址。 | | Unknown | 未知内容。 | +## SslError枚举说明 + +onSslErrorEventReceive接口返回的SSL错误的具体原因。 + +| 名称 | 描述 | +| -------------- | ----------------- | +| Invalid | 一般错误。 | +| HostMismatch | 主机名不匹配。 | +| DataInvalid | 证书日志无效。 | +| Untrusted | 证书颁发机构不受信任。 | + ## ProtectedResourceType9+枚举说明 | 名称 | 描述 | 备注 | -- GitLab