NavigatorLogin: метод setStatus()

Безопасный контекст: Данная функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Экспериментальная функция: Это экспериментальная технология
Тщательно проверьте таблицу совместимости браузеров перед использованием в продуктовой среде.

Метод setStatus() интерфейса NavigatorLogin устанавливает состояние входа пользователя в федеративный поставщик идентификации (IdP), при вызове из источника IdP. Это означает «есть ли какие-либо пользователи, вошедшие в систему IdP в текущем браузере или нет». Данный метод должен вызываться сайтом IdP после входа или выхода пользователя.

Браузер хранит это состояние для каждого IdP; API FedCM API затем использует его для уменьшения количества запросов, отправляемых IdP (потому что ему не нужно тратить время на запрос учетных записей, когда нет пользователей, вошедших в IdP). Это также смягчает возможные атаки по таймингу.

См. Обновление состояния входа с использованием API состояния входа для получения дополнительной информации о состоянии входа FedCM.

Синтаксис

setStatus(status)

Параметры

status

Строка, представляющая состояние входа, которое нужно установить для IdP. Возможные значения:

"logged-in": В IdP авторизован как минимум один пользователь.
"logged-out": Все учетные записи пользователей IdP в настоящее время выведены из системы.

Возвращаемое значение

Promise объект, который завершается успешно с undefined.

Исключения

SecurityError DOMException: Выбрасывается, если вызывающий домен не находится в фрейме, где вся иерархия вложенности имеет одинаковый источник. Независимо от того, вызывается ли он из основного фрейма, <iframe> вложенного внутри основного фрейма или другого <iframe> вложенного на один или несколько уровней глубже внутри первого <iframe>, все уровни иерархии вложенности должны иметь одинаковый источник для успешного вызова.

Примеры

/* Set logged-in status */
navigator.login.setStatus("logged-in");

/* Set logged-out status */
navigator.login.setStatus("logged-out");

Спецификации

Спецификация
API состояния входа # dom-navigatorlogin-setstatus

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`setStatus`	120	120	Нет	106	Нет	120	Нет	80	Нет	25.0	Нет

См. также

API управления федеративными данными (FedCM)

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NavigatorLogin/setStatus