RTCPeerConnection: свойство peerIdentity

Свойство peerIdentity только для чтения интерфейса RTCPeerConnection возвращает JavaScript Promise, который разрешается в RTCIdentityAssertion содержащий строку, идентифицирующую удаленного участника. После успешного разрешения этой промисы, полученная информация об идентичности является идентичностью целевого участника и не может быть изменена в течение всего времени подключения.

JavaScript Promise, который разрешается в RTCIdentityAssertion, описывающий идентичность удаленного участника.

Если при попытке валидации входящего утверждения об идентичности (т. е. информации, описывающей идентичность участника) произошла ошибка, промис отклоняется. Если идентичность целевого участника еще не задана, peerIdentity устанавливается в новую промис, и процесс повторяется, пока он не завершится успешно или больше не будет попыток проверки подлинности.

В этом примере создается функция getIdentityAssertion(), которая асинхронно ожидает проверки идентичности участника, а затем возвращает эту идентичность вызывающей стороне. Если произойдет ошибка и промис будет отклонен, эта ошибка записывается в консоль, а null возвращается вызывающей стороне.

let pc = new RTCPeerConnection();

// …

async function getIdentityAssertion(pc) {
  try {
    const identity = await pc.peerIdentity;
    return identity;
  } catch (err) {
    console.log("Error identifying remote peer: ", err);
    return null;
  }
}

• API WebRTC