Präsentation: receiver Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das schreibgeschützte Presentation-Attribut receiver, das nur in Browser-Kontexten verfügbar ist, die eine Präsentation empfangen, gibt das PresentationReceiver-Objekt zurück, das verwendet werden kann, um auf den Browser-Kontext zuzugreifen und mit ihm zu kommunizieren, der die Präsentation steuert. Diese Eigenschaft ist immer null, wenn sie außerhalb eines Browser-Kontexts aufgerufen wird, der eine Präsentation empfängt.

Wert

Wenn der Code in einem Kontext läuft, der eine Präsentation empfängt, ist der zurückgegebene Wert ein PresentationReceiver, der dann verwendet werden kann, um mit dem Kontext zu kommunizieren, der die Quelle der Präsentation ist.

Wenn der aktuelle Kontext keine Präsentation empfängt, ist receiver null.

Beispiele

Feststellen, ob der Kontext eine Präsentation empfängt

Sie können leicht feststellen, ob der Kontext der Empfänger einer Präsentation ist, indem Sie den Wert von navigator.presentation.receiver überprüfen. Wenn es ein Wert ungleich null ist, dann empfängt der Kontext tatsächlich eine Präsentation. Wenn es null ist, gibt es keine eingehende Präsentation.

footer.textContent = navigator.presentation.receiver
  ? "Receiving presentation"
  : "(idle)";

Zugriff auf die Verbindungsliste

Dieses Beispiel verwendet receiver, um auf die Liste der eingehenden Verbindungen zuzugreifen und eine Liste der ID-Strings dieser Verbindungen zu erstellen und anzuzeigen.

const listElem = document.getElementById("connection-view");

navigator.presentation.receiver.connectionList.then((connections) => {
  connections.forEach((aConnection) => {
    listElem.appendChild(document.createElement("li")).textContent =
      aConnection.id;
  });
});

Nachdem das Ausgabe-Listenelement in der Variablen connectionView zugänglich gemacht wurde, wird navigator.presentation.receiver verwendet, um eine Referenz auf das PresentationReceiver-Objekt für diesen Kontext zu erhalten, und dessen connectionList wird verwendet, um ein Promise zu erhalten, das aufgerufen wird, wenn die Liste verfügbar ist.

Der Promise-Handler erhält als Eingabeparameter ein Array der eingehenden Verbindungen. Wir iterieren über diese mit forEach(), und fügen für jede Verbindung ein neues Element zur connectionView-Liste hinzu.

Spezifikationen

Specification
Presentation API # dom-presentation-receiver