在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

userHandle 只读特性在 AuthenticatorAssertionResponse interface is an ArrayBuffer object which is an opaque identifier for the given user. Such an identifier can be used by the relying party's server to link the user account with its corresponding credentials and other data.

The same value may be found on the id 特性为 options.user object (used for the creation of the PublicKeyCredential 实例)。

注意： An AuthenticatorAssertionResponse instance is available on PublicKeyCredential.response after calling navigator.credentials.get() .

注意： This property may only be used in top-level contexts and will not be available in an <iframe> 例如。

句法

userHandle = authenticatorAssertionResponse.userHandle
					

值

ArrayBuffer object which is an opaque identifier for the current user. This is not human-readable and does not contain any personally identifying information (e.g. username, e-mail, phone number, etc.)

范例

var options = {
  challenge: new Uint8Array(26), // will be another value, provided by the relying party server
  timeout: 60000
};
navigator.credentials.get({  publickey: options })
  .then(function (assertionPKCred) {
    var userHandle = assertionPKCred.response.userHandle;
    // Send response and client extensions to the server so that it can
    // go on with the authentication
}).catch(function (err) {
   console.error(err);
});
					

规范

规范	状态	注释
Web Authentication: An API for accessing Public Key Credentials Level 1 The definition of 'userHandle' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
userHandle	Chrome 67 67 65 Disabled Only supports USB U2F tokens. Disabled ). To change preferences in Chrome, visit	Edge 18	Firefox 60 60 Only supports USB U2F tokens.	IE No	Opera No	Safari 13	WebView Android 70	Chrome Android 70	Firefox Android 60 60 Only supports USB U2F tokens.	Opera Android No	Safari iOS 13.3	Samsung Internet Android No

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

• PublicKeyCredentialCreationOptions.user 及其 id property which contains the same data

元数据

• 最后修改： Mar 18, 2019

相关话题

1. Web 身份验证 API
2. AuthenticatorAssertionResponse
3. 特性

   1. authenticatorData
   2. signature
   3. userHandle
4. Related pages for Web Authentication API

   1. AuthenticatorAttestationResponse
   2. AuthenticatorResponse
   3. CredentialsContainer
   4. PublicKeyCredential