RTCPeerConnection.peerIdentity

只读属性 RTCPeerConnection peerIdentity ,返回Promise 对象,成功时返回 RTCIdentityAssertion ,该结构 DOMString 标识了远端的 ID。这个身份标识在连接过程中将不会改变(直到连接结束).

一个 JavaScript Promise,会被兑现为描述远程对等方身份的 RTCIdentityAssertion

当验证远程的身份 ID 出错时,promise 将返回拒绝。如果目标节点身份不存在,peerIdentity 将被设为 一个 promise 对象,并重启验证过程(一个断言), 直到成功或者不再想继续。

备注: setRemoteDescription() 返回的 promise 将不会成功返回,除非目标节点身份信息可用。如不可用,则setRemoteDescription() 将被拒绝。若无目标节点 ID,就不不需要等setRemoteDescription() 这个返回验证成功了。

示例

本示例创建了一个 getIdentityAssertion() 函数,该函数异步等待对等方的身份得到验证,然后将其身份返回给调用者。如果发生错误且 promise 被拒绝,则将错误记录到控制台并将 null 返回给调用者。

js
let pc = new RTCPeerConnection();

// …

async function getIdentityAssertion(pc) {
  try {
    const identity = await pc.peerIdentity;
    return identity;
  } catch (err) {
    console.log("验证远程对等方的身份时出现错误:", err);
    return null;
  }
}

规范

Specification
Identity for WebRTC 1.0
# dom-rtcpeerconnection-peeridentity

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
peerIdentity

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

参见