Skip to content

Commit

Permalink
Add suggested prompt message for includeSensitive: true
Browse files Browse the repository at this point in the history
eligrey authored Jun 21, 2024

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
1 parent eb2afa7 commit 0ea3fbe
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -31,7 +31,7 @@ The Fragment Directives API exposes a new `requestFragmentDirectives` method on

The `navigation.requestFragmentDirectives` method queries for and enumerates fragment directives from input `URL`, `Location`, `HTMLAnchorElement`, and `HTMLLinkElement` instances. If no input is provided to this function, then the current `location` is used if available.

This method takes an optional options object with an optional `includeSensitive` field. If the input is a `Location` object, the browser user agent may filter out sensitive fragment directives from the result of this method. Additionally, the browser user agent may require a secure context and prompt the user to allow access to sensitive fragment directives from the website calling this method.
This method takes an optional options object with an optional `includeSensitive` field. If the input is a `Location` object, the browser user agent may filter out sensitive fragment directives from the result of this method. Additionally, the browser user agent may require a secure context and prompt the user to allow access to sensitive fragment directives from the website calling this method. As there is only one known privacy-sensitive fragment directive, browser user agents may choose to prompt with the user with a message equivalent to "\[website\] wants to access in-page scroll-to-text search terms" in the user's configured language.

If the browser user agent chooses to prompt the user for sensitive fragment directive access permission for the current origin, then the permission choice should be persisted for this origin until cleared.

0 comments on commit 0ea3fbe

Please sign in to comment.