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 a74b3e94787735c17a2b0c79bf312ba9ccd4b84f..2cc6753eaa71fe6436ebb6b7f19e868ca2735160 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 @@ -1186,6 +1186,45 @@ onHttpAuthRequest(callback: (event?: { handler: HttpAuthHandler, host: string, r } } ``` +### onPermissionRequest9+ + +onPermissionRequest(callback: (event?: { request: PermissionRequest }) => void) + +通知收到获取权限请求。 + +**参数:** +| 参数名 | 参数类型 | 参数描述 | +| ------- | ------------------------------------ | ---------------- | +| request | [PermissionRequest](#permissionrequest9) | 通知Web组件用户操作行为。 | + + **示例:** + ```ts + // xxx.ets + @Entry + @Component + struct WebComponent { + controller:WebController = new WebController(); + build() { + Column() { + Web({ src:'www.example.com', controller:this.controller }) + .onPermissionRequest((event) => { + AlertDialog.show({ + title: 'title', + message: 'text', + confirm: { + value: 'onConfirm', + action: () => { + event.request.grant(event.request.getAccessibleResource()); + } + }, + cancel: () => { + event.request.deny(); + } + }) + }) + } + } + ``` ## ConsoleMessage @@ -1595,6 +1634,52 @@ isHttpAuthInfoSaved(): boolean | ------- | ------------------------- | | boolean | 存在密码认证成功返回true,其他返回false。 | +## PermissionRequest9+ + +Web组件返回授权或拒绝权限功能的对象。示例代码参考[onPermissionRequest事件](#onpermissionrequest9)。 + +### deny9+ + +deny(): void + +拒绝网页所请求的权限。 + +### getOrigin9+ + +getOrigin(): string + +获取网页来源。 + +**返回值:** + +| 类型 | 说明 | +| ------- | --------------------- | +| string | 当前请求权限网页的来源。 | + +### getAccessibleResource9+ + +getAccessibleResource(): Array\ + +获取网页所请求的权限资源列表,资源列表类型参考[ProtectedResourceType](#protectedresourcetype9枚举说明)。 + +**返回值:** + +| 类型 | 说明 | +| --------------- | ----------------------- | +| Array\ | 网页所请求的权限资源列表。 | + +### grant9+ + +grant(resources: Array\): void + +对网页访问的给定权限进行授权。 + +**参数:** + +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| --------- | --------------- | ---- | ----- | ---------------------- | +| resources | Array\ | 是 | - | 网页所请求的权限资源列表。| + ## WebController 通过WebController可以控制Web组件各种行为。一个WebController对象只能控制一个Web组件,且必须在Web组件和WebController绑定后,才能调用WebController上的方法。 @@ -3076,4 +3161,10 @@ onRenderExited接口返回的渲染进程退出的具体原因。 | HttpAnchorImg | 带有超链接的图片,其中超链接的src为http。 | | Img | HTML::img标签。 | | Map | 地理地址。 | -| Unknown | 未知内容。 | \ No newline at end of file +| Unknown | 未知内容。 | + +## ProtectedResourceType9+枚举说明 + +| 名称 | 描述 | 备注 | +| --------- | -------------- | -------------- | +| MidiSysex | MIDI SYSEX资源。| 目前仅支持权限事件上报,MIDI设备的使用还未支持。| \ No newline at end of file