Перейти к основному содержанию

powerMonitor

Отслеживает изменения состояния питания устройства.

Process: Main

События​

Модуль powerMonitor выдает следующие события:

Событие: 'suspend'​

Возникает, когда система приостановлена.

Событие: 'resume'​

Возникает при возобновлении работы системы.

Event: 'on-ac' macOS Windows​

Используется при переключении системы на питание от переменного тока (блока питания).

Event: 'on-battery' macOS Windows​

Используется при переключении системы на питание от батареи.

Event: 'thermal-state-change' macOS​

Возвращает:

  • details Event<>
    • state string - The system's new thermal state. Can be unknown, nominal, fair, serious, critical.

Emitted when the thermal state of the system changes. Notification of a change in the thermal status of the system, such as entering a critical temperature range. Depending on the severity, the system might take steps to reduce said temperature, for example, throttling the CPU or switching on the fans if available.

Apps may react to the new state by reducing expensive computing tasks (e.g. video encoding), or notifying the user. The same state might be received repeatedly.

See https://developer.apple.com/library/archive/documentation/Performance/Conceptual/power_efficiency_guidelines_osx/RespondToThermalStateChanges.html

Event: 'speed-limit-change' macOS Windows​

Возвращает:

  • details Event<>
    • limit number - The operating system's advertised speed limit for CPUs, in percent.

Notification of a change in the operating system's advertised speed limit for CPUs, in percent. Values below 100 indicate that the system is impairing processing power due to thermal management.

Событие: 'shutdown' Linux macOS​

Возникает, когда система собирается перезагрузиться или выключиться. Если обработчик события вызывает e.preventDefault(), Electron попытается отложить завершение работы системы, чтобы приложение корректно завершило работу. Если вызывается e.preventDefault(), приложение должно выйти как можно скорее, вызвав что-то вроде app.quit().

Событие: 'lock-screen' macOS Windows​

Возникает, когда система собирается заблокировать экран.

Событие: 'unlock-screen' macOS Windows​

Возникает, как только система разблокирует экран.

Event: 'user-did-become-active' macOS​

Emitted when a login session is activated. See documentation for more information.

Event: 'user-did-resign-active' macOS​

Emitted when a login session is deactivated. See documentation for more information.

Методы​

Модуль powerMonitor имеет следующие методы:

powerMonitor.getSystemIdleState(idleThreshold)​

  • idleThreshold Integer

Returns string - The system's current idle state. Может быть active, idle, locked или unknown.

Calculate the system idle state. idleThreshold is the amount of time (in seconds) before considered idle. locked is available on supported systems only.

powerMonitor.getSystemIdleTime()​

Возвращает Integer - время простоя в секундах

Расчет времени простоя системы в секундах.

powerMonitor.getCurrentThermalState() macOS​

Returns string - The system's current thermal state. Can be unknown, nominal, fair, serious, or critical.

powerMonitor.isOnBatteryPower()​

Returns boolean - Whether the system is on battery power.

To monitor for changes in this property, use the on-battery and on-ac events.

Свойства​

powerMonitor.onBatteryPower​

A boolean property. True if the system is on battery power.

See powerMonitor.isOnBatteryPower().