NavigatorLogin: setStatus() Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die setStatus() Methode der NavigatorLogin Schnittstelle setzt den Anmeldestatus eines föderierten Identitätsanbieters (IdP), wenn sie von der Herkunft des IdP aufgerufen wird. Damit meinen wir "ob irgendwelche Benutzer im aktuellen Browser beim IdP angemeldet sind oder nicht". Dies sollte von der IdP-Website nach einer Benutzeranmeldung oder -abmeldung aufgerufen werden.
Der Browser speichert diesen Status für jeden IdP; die FedCM API nutzt ihn dann, um die Anzahl der Anfragen an den IdP zu reduzieren (weil es nicht nötig ist, Konten anzufordern, wenn keine Benutzer beim IdP angemeldet sind). Es mildert auch potenzielle Timing-Angriffe ab.
Weitere Informationen über den FedCM-Anmeldestatus finden Sie unter Aktualisieren des Anmeldestatus mit der Login Status API.
Syntax
setStatus(status)
Parameter
status-
Ein String, der den Anmeldestatus für den IdP festlegt. Mögliche Werte sind:
"logged-in": Der IdP hat mindestens ein Benutzerkonto angemeldet."logged-out": Alle Benutzerkonten des IdP sind derzeit abgemeldet.
Rückgabewert
Ein Promise, der mit undefined erfüllt wird.
Ausnahmen
SecurityErrorDOMException-
Wird ausgelöst, wenn die aufrufende Domain sich nicht in einem Frame befindet, in dem die gesamte Verschachtelungshierarchie gleichberechtigt ist. Egal ob vom Hauptframe, einem im Hauptframe verschachtelten
<iframe>oder einem weiteren<iframe>, das ein oder mehrere Ebenen tiefer innerhalb des ersten<iframe>verschachtelt ist, alle Ebenen der Verschachtelungshierarchie müssen gleichberechtigt sein, damit der Aufruf erfolgreich ist.
Beispiele
/* Set logged-in status */
navigator.login.setStatus("logged-in");
/* Set logged-out status */
navigator.login.setStatus("logged-out");
Spezifikationen
| Specification |
|---|
| Login Status API # dom-navigatorlogin-setstatus |