AuthenticatorAssertionResponse：userHandle 属性

基线

广泛可用

自 2021年9月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

安全上下文: 此特性仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

AuthenticatorAssertionResponse 接口的只读属性 userHandle 返回一个能为给定用户提供不透明标识符的 ArrayBuffer 对象。依赖方服务器可以使用这类标识符将用户账户与其对应的凭据和其他数据相关联。

此值在传递给原始的 navigator.credentials.create() 调用的选项中指定为 user.id。

值

表示当前用户的标识符的 ArrayBuffer 对象。该标识符不应被人阅读。依赖方应确保传递到原始 create() 调用中的 user.id 不包含任何个人身份信息（例如用户名、电子邮件或电话号码）。

对于带有非空 allowCredentials 属性的 navigator.credentials.create() 调用，返回的 userHandle 可能为 null。

参见检索公钥凭据以获取详细示例。

规范
Web Authentication: An API for accessing Public Key Credentials - Level 3 # dom-authenticatorassertionresponse-userhandle

此页面最后更新于 2025年9月16日，由 MDN 贡献者更新。