Skip to content

preventSleep ​

preventSleep inhibe la suspensión automática del sistema/pantalla hasta que se llame a allowSleep.

FirmapreventSleep(): Result<void, OsError>
tyrus
import { OsError, allowSleep, preventSleep } from "tyrus:os";

match (preventSleep()) {
    Ok() => print("Sleep prevention enabled"); // Sleep prevention enabled
    Err(error) => printError(`${error.code}: ${error.message}`); // ERR_OS_SLEEP_INHIBIT_FAILED: platform sleep prevention is unavailable
}

match (allowSleep()) {
    Ok() => print("Sleep prevention disabled"); // Sleep prevention disabled
    Err(error) => printError(`${error.code}: ${error.message}`); // ERR_OS_SLEEP_ALLOW_FAILED: platform sleep prevention could not be released
}

Idempotente: llamar a esto de nuevo mientras la suspensión ya está inhibida es un éxito sin efecto.

Implementado por plataforma:

  • Linux, inicia systemd-inhibit --mode=block sleep infinity y mantiene vivo el proceso hijo.
  • macOS, inicia caffeinate -dims.
  • Windows, llama a SetThreadExecutionState con ES_SYSTEM_REQUIRED | ES_DISPLAY_REQUIRED; no hay proceso hijo involucrado.

Devuelve Err(OsError) (code: "ERR_OS_SLEEP_INHIBIT_FAILED") si el mecanismo de la plataforma no está disponible, por ejemplo, systemd-inhibit ausente en una distribución Linux sin systemd.

Campos de OsError ​

CampoTipoSignificado
codestringUn identificador estable y legible por máquina (ej.: "ERR_OS_SLEEP_INHIBIT_FAILED").
messagestringUna descripción legible de lo que salió mal.