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 diesem zu kommunizieren, der die Präsentation kontrolliert. Diese Eigenschaft ist immer null, wenn sie von außerhalb eines Browser-Kontextes zugegriffen wird, der eine Präsentation empfängt.

Wert

Wenn der Code in einem Kontext ausgeführt wird, 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

Bestimmen, ob der Kontext eine Präsentation empfängt oder nicht

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

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

Zugriff auf die Verbindungs-Liste

Dieses Beispiel nutzt 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 der Zugriff auf das Ausgabelisten-Element in der Variablen connectionView hergestellt wurde, wird navigator.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 Hilfe von forEach(), indem wir ein neues Element zur connectionView-Listenkomponente für jede Verbindung hinzufügen.

Spezifikationen

Specification
Presentation API # dom-presentation-receiver

Browser-Kompatibilität

BCD tables only load in the browser