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 25395c310c362dd9e69fd7901e6de7de7e9fafdc..c937a4134769c145b6c9a6a6995e398eb67d0ce9 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 @@ -75,6 +75,7 @@ | onShowFileSelector(callback: (event?: { result: [FileSelectorResult](#fileselectorresult对象说明), fileSelector: [FileSelectorParam](#fileselectorparam对象说明) }) => void) |

调用此函数以处理具有“文件”输入类型的HTML表单,以响应用户按下的“选择文件”按钮
- result:用于通知Web组件文件选择的结果。
- fileSelector:文件选择器的相关信息。

| | onUrlLoadIntercept(callback: (event?: { data:string \| [WebResourceRequest](#webresourcerequest对象说明) }) => boolean) |

当Web组件加载url之前触发该回调,用于是否阻止此次访问。callback返回true表示阻止此次加载,否则允许此次加载。
- data:url的相关信息。

| | onInterceptRequest9+(callback: (event?: { request: [WebResourceRequest](#webresourcerequest对象说明)}) => [WebResourceResponse](#webresourceresponse对象说明)) |

当Web组件加载url之前触发该回调,用于拦截url并返回响应数据。callback返回响应数据为空表示按原来方式加载,否则加载响应数据。
- request:url请求的相关信息。

| +| onHttpAuthRequest9+(callback: (event?: { handler: [HttpAuthHandler](#httpAuthHandler对象说明), host: string, realm: string}) => boolean) |

通知收到http auth认证请求。callback返回false表示此次认证失败,否则成功。
- handler:通知Web组件用户操作行为。
- host:HTTP身份验证凭据应用的主机。
- realm:HTTP身份验证凭据应用的领域。

| ## ConsoleMessage对象说明 @@ -200,6 +201,16 @@ onRenderExited接口返回的渲染进程退出的具体原因。 | FileOpenFolderMode | 打开上传文件夹模式。 | | FileSaveMode | 文件保存模式。 | +## HttpAuthHandler对象说明 + +Web组件返回的http auth认证请求确认或取消和使用缓冲密码认证功能对象。 + +| 接口名称 | 功能描述 | +| -------------------------------------------------| ------------------------------------------------------ | +| cancel(): void |

通知Web组件用户取消HTTP认证操作。

| +| confirm(userName: string, pwd: string): boolean |

通知Web组件用户使用userName和pwd进行HTTP认证操作。

| +| isHttpAuthInfoSaved(): boolean |

通知Web组件用户使用服务器缓存的账号密码认证,若没有缓存返回false。

| + ## WebController 通过WebController可以控制Web组件各种行为。一个WebController对象只能控制一个Web组件,且必须在Web组件和WebController绑定后,才能调用WebController上的方法。 @@ -411,6 +422,59 @@ saveCookieSync(): boolean | 参数类型 | 说明 | | -------- | ---------------------------------- | | boolean | 同步内存cookie到磁盘操作是否成功。 | + +## WebDataBase9+ +web组件数据库管理对象。 + +### existHttpAuthCredentials9+ + +static existHttpAuthCredentials(): boolean + +判断是否存在任何已保存的HTTP身份验证凭据,该方法为同步方法。存在返回true,否则返回false。 + +- 返回值 + | 参数类型 | 说明 | + | -------- | ----------------------------------- | + | boolean | 是否存在任何已保存的HTTP身份验证凭据。存在返回true,不存在返回false | + +### deleteHttpAuthCredentials9+ + +static deleteHttpAuthCredentials(): void + +清除所有已保存的HTTP身份验证凭据,该方法为同步方法。 + +### getHttpAuthCredentials9+ + +static getHttpAuthCredentials(host: string, realm: string): Array\ + +检索给定主机和领域的HTTP身份验证凭据,该方法为同步方法。检索成功返回一个包含用户名和密码的组数,检索不成功返回空数组。 + +- 参数说明 + + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | ------ | -------- | ---- | ------ | -------------------------- | + | host | string | 是 | - | HTTP身份验证凭据应用的主机。 | + | realm | string | 是 | - | HTTP身份验证凭据应用的领域。 | +- 返回值 + | 参数类型 | 说明 | + | ---------------- | --------------------------------------------- | + | Array\ | 包含用户名和密码的组数,检索失败返回空数组。 | + +### saveHttpAuthCredentials9+ + +static saveHttpAuthCredentials(host: string, realm: string, username: string, password: string): void + +保存给定主机和领域的HTTP身份验证凭据,该方法为同步方法。 + +- 参数说明 + + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | ---- | ------ | -------------------------- | + | host | string | 是 | - | HTTP身份验证凭据应用的主机。 | + | realm | string | 是 | - | HTTP身份验证凭据应用的领域。 | + | username | string | 是 | - | 用户名。 | + | password | string | 是 | - | 密码。 | + ## 示例 ```ts