idle.queryState()

Возвращает "locked" если система заблокирована, "idle" если пользователь не вводил данные определённое количество секунд, или "active" в противном случае.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let querying = browser.idle.queryState(
  detectionIntervalInSeconds // integer
)

Параметры

detectionIntervalInSeconds: integer. Система считается неактивной, если detectionIntervalInSeconds секунд прошло с момента последнего ввода пользователя.

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

A Promise, который будет выполнен со строкой idle.IdleState, указывающей текущее состояние.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`queryState`	Да	15	45 До версии 51 Firefox всегда сообщал 'активный'. После версии 51 Firefox сообщает 'активный' или 'неактивный' в соответствии с ситуацией.	?	Да	Нет	?	?	48 До версии 51 Firefox всегда сообщал 'активный'. После версии 51 Firefox сообщает 'активный' или 'неактивный' в соответствии с ситуацией.	?	Нет	?
`locked`	Да	79	Нет	?	Да	Нет	?	?	Нет	?	Нет	?

Примеры

В этом простом фрагменте кода мы вызываем queryState() и затем проверяем, является ли возвращённое newState значение idle или active, выводим соответствующее сообщение. Поскольку мы задали интервал detectionIntervalInSeconds в 15 секунд, состояние idle будет сообщено только в случае отсутствия активности пользователя в течение как минимум 15 секунд.

function onGot(newState) {
  if (newState === 'idle') {
    console.log('Please come back — we miss you!');
  } else if (newState === 'active') {
    console.log('Glad to still have you with us!');
  }
}

let querying = browser.idle.queryState(15);
querying.then(onGot);

Примечание: Этот API основан на API chrome.idle Chromium. Данная документация взята из idle.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/idle/queryState