preventSleep
preventSleep inhibe la suspensión automática del sistema/pantalla hasta que se llame a allowSleep.
Firma
preventSleep(): 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 infinityy mantiene vivo el proceso hijo. - macOS, inicia
caffeinate -dims. - Windows, llama a
SetThreadExecutionStateconES_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
| Campo | Tipo | Significado |
|---|---|---|
code | string | Un identificador estable y legible por máquina (ej.: "ERR_OS_SLEEP_INHIBIT_FAILED"). |
message | string | Una descripción legible de lo que salió mal. |
