Skip to content

Add isProtocolSupportedByClient static method #221

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Add isProtocolSupportedByClient static method #221

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
bba14f5
initial text for static method isProtocolSupportByClient
timcappalli Apr 18, 2025
aec59fe
tweak text
timcappalli Apr 21, 2025
0ca736c
Update index.html
timcappalli Apr 22, 2025
c9da7aa
Ted feedback
timcappalli Apr 22, 2025
102782e
Update index.html
timcappalli Apr 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -400,6 +400,28 @@ <h3>
<dfn class="export" data-dfn-for="DigitalCredential">[[\discovery]]</dfn>
whose value is "remote".
</p>
<h3>
`isProtocolSupportedByClient()` Method
</h3>
<p>
Digital credential verifiers and issuers use this static method to
determine which [=digital credential/exchange protocols=] the client
supports for interactions with credential providers.
</p>
<p>
This method does not convey protocol support in the underlying platform
or credential provider.
</p>
<p>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p>
<p>
User agents SHOULD NOT vary the response value based on any information about availability of hardware, presence or configuration of software, wallets or credentials, or user configuration or preferences. If the response value varied, the user agent would introduce risks both of fingerprinting and of silently revealing other details about user behavior or configuration. The response value SHOULD vary only by user agent major version and indicate whether the browser supports distributing requests with that protocol to underlying platform or provider.
</p>
<p>

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just a starting point proposed text for trying to capture the idea that this is just a convenience method indicating browser version support, rather than details to the site about what the user has configured.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That sounds great @npdoty. thanks!

This method accepts a [=DOMString=] that uniquely specifies the
[=digital credential/exchange protocol=] and returns a [=Promise=] that
resolves to a Boolean value.
</p>
<pre class="idl">
partial interface DigitalCredential {
static Promise<boolean> isProtocolSupportedByClient(DOMString protocol);
};
</pre>
<section class="informative">
<h3>
User consent
Expand Down