chrome.idle

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.idle pour détecter les changements d'état d'inactivité de la machine.

Autorisations

idle

Fichier manifeste

Vous devez déclarer l'autorisation "idle" dans le fichier manifeste de votre extension pour utiliser l'API Idle. Exemple :

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

Types

IdleState

Chrome 44 et versions ultérieures

Énumération

"active"

"idle"

"locked"

Méthodes

getAutoLockDelay()

Promise Chrome 73 et versions ultérieures ChromeOS uniquement 
chrome.idle.getAutoLockDelay(
  callback?: function,
): Promise<number>

Obtient le temps, en secondes, avant que l'écran ne se verrouille automatiquement en cas d'inactivité. Renvoie une durée nulle si l'écran n'est jamais verrouillé automatiquement. Actuellement disponible sur ChromeOS uniquement.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (delay: number) => void

    • delay

      nombre

      Temps en secondes avant le verrouillage automatique de l'écran en cas d'inactivité. Cette valeur est égale à zéro si l'écran ne se verrouille jamais automatiquement.

Renvoie

  • Promise<number>

    Chrome 116 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

queryState()

Promise 
chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback?: function,
): Promise<IdleState>

Renvoie "locked" si le système est verrouillé, "idle" si l'utilisateur n'a généré aucune entrée pendant un nombre de secondes spécifié, ou "active" dans le cas contraire.

Paramètres

  • detectionIntervalInSeconds

    nombre

    Le système est considéré comme inactif si detectionIntervalInSeconds secondes se sont écoulées depuis la dernière entrée utilisateur détectée.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (newState: IdleState) => void

Renvoie

  • Promise<IdleState>

    Chrome 116 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

setDetectionInterval()

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

Définit l'intervalle, en secondes, utilisé pour déterminer quand le système est en état d'inactivité pour les événements onStateChanged. L'intervalle par défaut est de 60 secondes.

Paramètres

  • intervalInSeconds

    nombre

    Seuil, en secondes, utilisé pour déterminer quand le système est en état d'inactivité.

Événements

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

Déclenché lorsque le système passe à l'état actif, inactif ou verrouillé. L'événement se déclenche avec "locked" si l'écran est verrouillé ou si l'économiseur d'écran s'active, avec "idle" si le système est déverrouillé et que l'utilisateur n'a généré aucune entrée pendant un nombre de secondes spécifié, et avec "active" lorsque l'utilisateur génère une entrée sur un système inactif.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (newState: IdleState) => void