PresentationRequest: getAvailability() Methode
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.
Wenn die getAvailability()
Methode aufgerufen wird, MUSS der Benutzeragent die folgenden Schritte ausführen:
- Eingabe
-
presentationUrls, eine Liste von presentation request URLs
- Ausgabe
-
P, ein Promise
-
Wenn eine der folgenden Bedingungen zutrifft:
- Das Ergebnis des Ausführens des Algorithmus zur Verhinderung gemischter Sicherheitskontexte auf dem Einstellungsobjekt des Dokuments ist
"Prohibits Mixed Security Contexts"
und presentationUrl ist eine a priori nicht authentifizierte URL. - Das aktive Sandboxing-Flag-Set des Dokumentobjekts hat das sandboxed presentation browsing context flag gesetzt.
Führen Sie die folgenden Unterschritte aus:
- Geben Sie ein Promise zurück, das mit einem
SecurityError
DOMException
abgelehnt wird. - Diese Schritte abbrechen.
- Das Ergebnis des Ausführens des Algorithmus zur Verhinderung gemischter Sicherheitskontexte auf dem Einstellungsobjekt des Dokuments ist
-
Lassen Sie P ein neues Promise sein.
-
Geben Sie P zurück, führen Sie aber die folgenden Schritte parallel weiter aus.
-
Wenn der Benutzeragent nicht in der Lage ist, die Liste der verfügbaren Präsentationsdisplays zu überwachen für die gesamte Dauer des kontrollierenden Browsing-Kontexts (z.B. weil der Benutzer diese Funktion deaktiviert hat), dann:
- Lösen Sie P mit einem neuen
PresentationAvailability
Objekt auf, dessenvalue
Eigenschaft auffalse
gesetzt ist. - Alle weiteren Schritte abbrechen.
- Lösen Sie P mit einem neuen
-
Wenn der Benutzeragent nicht in der Lage ist, kontinuierlich die Liste der verfügbaren Präsentationsdisplays zu überwachen, aber Präsentationsdisplays finden kann, um eine Verbindung zu starten, dann:
- Lehnen Sie P mit einem
NotSupportedError
DOMException
ab. - Alle weiteren Schritte abbrechen.
- Lehnen Sie P mit einem
-
Wenn es ein Tupel (A, presentationUrls) in der Menge der Verfügbarkeitsobjekte gibt, dann:
- Lösen Sie P mit A auf.
- Alle weiteren Schritte abbrechen.
-
Lassen Sie A ein neues
PresentationAvailability
Objekt sein, dessenvalue
Eigenschaft wie folgt gesetzt ist:false
, wenn die Liste der verfügbaren Präsentationsdisplays leer ist.true
, wenn es mindestens ein kompatibles Präsentationsdisplay für ein Mitglied von presentationUrls gibt. Das bedeutet, es gibt einen Eintrag (presentationUrl, display) in der Liste der verfügbaren Präsentationsdisplays für ein presentationUrl in presentationUrls.false
andernfalls.
-
Erstellen Sie ein Tupel (A, presentationUrls) und fügen Sie es der Menge der Verfügbarkeitsobjekte hinzu.
-
Führen Sie den Algorithmus aus, um die Liste der verfügbaren Präsentationsdisplays zu überwachen.
-
Lösen Sie P mit A auf.
Spezifikationen
Specification |
---|
Presentation API # getting-the-presentation-displays-availability-information |