Skip to content

Commit 04b1b94

Browse files
author
Wangsong Jin
committed
added more description for impacted API
1 parent 1fd53bc commit 04b1b94

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

specs/NestedFrame.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -170,8 +170,8 @@ namespace Microsoft.Web.WebView2.Core
170170
In the current case of nested iframes, the [PermissionRequested](https://learn.microsoft.com/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame#permissionrequested)
171171
and [ScreenCaptureStarting](https://learn.microsoft.com/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame#screencapturestarting)
172172
events will be raised from the top-level iframe. With the support
173-
of tracking nested iframes, this request can be handled directly
174-
by the nested iframe. Therefore, we now raise these requests to
173+
of tracking nested iframes, we can now handle these requests directly
174+
within the nested iframe. Specifically, these requests are raised to
175175
the nearest tracked frame, which is the `CoreWebView2Frame` closest
176176
to the frame that initiates the request (from bottom to top).
177177
```
@@ -197,6 +197,14 @@ subscribe to the `CoreWebView2Frame.FrameCreated` event.
197197
Therefore, requests originating from iframes will still be
198198
raised from the first-level iframe.
199199

200+
If the `PermissionRequested` event is not handled in the current
201+
tracked frame, the request will propagate to its parent
202+
`CoreWebView2Frame`, or to `CoreWebView2` if the parent frame
203+
is the main frame. For example, if frame D is tracked but does
204+
not handle the request, the request will bubble up to frame C.
205+
If frame C handles the request, it will not propagate further
206+
to its parent frame B.
207+
200208
### `CoreWebView2.ProcessFailed`
201209
With the support of tracking nested iframes, the processes
202210
which support these nested iframes will be also tracked by

0 commit comments

Comments
 (0)