Saltar al contenido principal

systemPreferences

Obtener las preferencias del sistema.

Process: Main, Utility

const { systemPreferences } = requiere('electron')
console.log(systemPreferences.isAeroGlassEnabled())

Eventos​

El objeto de lossistemasdePreferenciasemiten los siguietes eventos:

Evento: 'acento-color-cambio' Windows​

Devuelve:

  • event
  • nuevoColor string - El nuevo color RGBA que el usuario asignó para ser su color de acento del sistema.

Event: 'color-changed' Windows​

Devuelve:

  • event

Métodos​

systemPreferences.isSwipeTrackingFromScrollEventsEnabled() macOS​

Devuelve boolean - Aunque el ajuste de cambio entre páginas esté activado.

systemPreferences.postNotification(event, userInfo) macOS​

  • event string
  • userInfo Record<string, any>
  • deliverImmediately boolean (Opcional) - true para publicar inmediatamente incluso cuando la aplicación esta inactiva.

Posts event as native notifications of macOS. The userInfo is an Object that contains the user information dictionary sent along with the notification.

systemPreferences.postLocalNotification(event, userInfo) macOS​

  • event string
  • userInfo Record<string, any>

Posts event as native notifications of macOS. The userInfo is an Object that contains the user information dictionary sent along with the notification.

systemPreferences.postWorkspaceNotification(event, userInfo) macOS​

  • event string
  • userInfo Record<string, any>

Posts event as native notifications of macOS. The userInfo is an Object that contains the user information dictionary sent along with the notification.

systemPreferences.subscribeNotification(event, callback) macOS​

  • event string | null
  • callback Function
    • event string
    • userInfo Record<string, unknown>
    • string object

Devuelve number - El ID de la suscripción

Subscriptores a notificaciones nativas de macOS, callback serán llamados con callback(evento, userinfo) cuando el evento correspondiente suceda. El userInfo es un Objeto que contiene el diccionario de la información de usuario enviado junto a las notificaciones. El object es el remitente de la notificación y solo soporta valores NSString por ahora.

El id del subscriptor es devuelto, el cual puede ser usado para desuscribir el evento.

Bajo de la capucha este API subscribe a NSDistributedNotificationCenter, valores de ejemplo de evento son:

  • AppleInterfaceThemeChangedNotification
  • AppleAquaColorVariantChanged
  • AppleColorPreferencesChangedNotification
  • AppleShowScrollBarsSettingChanged

If event is null, the NSDistributedNotificationCenter doesn’t use it as criteria for delivery to the observer. See docs for more information.

systemPreferences.subscribeLocalNotification(event, callback) macOS​

  • event string | null
  • callback Function
    • event string
    • userInfo Record<string, unknown>
    • string object

Devuelve number - El ID de la suscripción

Same as subscribeNotification, but uses NSNotificationCenter for local defaults. Esto es necesario para eventos como NSUserDefaultsDidChangeNotification.

If event is null, the NSNotificationCenter doesn’t use it as criteria for delivery to the observer. See docs for more information.

systemPreferences.subscribeWorkspaceNotification(event, callback) macOS​

  • event string | null
  • callback Function
    • event string
    • userInfo Record<string, unknown>
    • string object

Devuelve number - El ID de la suscripción

Igual que subscribeNotification, pero utiliza NSWorkspace.sharedWorkspace.notificationCenter. Esto es necesario para eventos como NSWorkspaceDidActivateApplicationNotification.

If event is null, the NSWorkspaceNotificationCenter doesn’t use it as criteria for delivery to the observer. See docs for more information.

systemPreferences.unsubscribeNotification(id) macOS​

  • id Íntegro

Remueve el subscriptor con el id.

systemPreferences.unsubscribeLocalNotification(id) macOS​

  • id Íntegro

Al igual que unsubscribeNotification, pero remueveal subscritor de NSNotificationCenter.

systemPreferences.unsubscribeWorkspaceNotification(id) macOS​

  • id Íntegro

Igual que unsubscribeNotification, pero remueve el subscriptor desde NSWorkspace.sharedWorkspace.notificationCenter.

systemPreferences.registerDefaults(defaults) macOS​

  • defaults Record<string, string | boolean | number> - a dictionary of (key: value) user defaults

Agregue los valores predeterminados especificados a NSUserDefaults de su aplicación.

systemPreferences.getUserDefault<Type extends keyof UserDefaultTypes>(key, type) macOS​

  • llave cadena
  • type Type - Can be string, boolean, integer, float, double, url, array or dictionary.

Returns UserDefaultTypes[Type] - The value of key in NSUserDefaults.

Algunos key y types populares:

  • AppleInterfaceStyle: string
  • AppleAquaColorVariant: integer
  • AppleHighlightColor: string
  • AppleShowScrollBars: string
  • NSNavRecentPlaces: array
  • NSPreferredWebServices: dictionary
  • NSUserDictionaryReplacementItems: array

systemPreferences.setUserDefault<Type extends keyof UserDefaultTypes>(key, type, value) macOS​

  • llave cadena
  • type Type - Can be string, boolean, integer, float, double, url, array or dictionary.
  • value UserDefaultTypes[Type]

Establece el valor de key en NSUserDefaults.

Note that type should match actual type of value. An exception is thrown if they don't.

Algunos key y types populares:

  • ApplePressAndHoldEnabled: boolean

systemPreferences.removeUserDefault(key) macOS​

  • llave cadena

Elimina el key en NSUserDefaults. This can be used to restore the default or global value of a key previously set with setUserDefault.

systemPreferences.isAeroGlassEnabled() Windows​

Devuelve boolean - true si DWM composition (Aero Glass) está habilitada, y false de lo contrario.

Un ejemplo de usarlo para determinar si deberías crear una ventana transparente o no (las ventanas transparentes no funcionarán correctamente cuando la composición de DWM está deshabilitada):

const { BrowserWindow, systemPreferences } = require('electron')
const browserOptions = { width: 1000, height: 800 }

// Make the window transparent only if the platform supports it.
if (process.platform !== 'win32' || systemPreferences.isAeroGlassEnabled()) {
  browserOptions.transparent = true
  browserOptions.frame = false
}

// Create the window.
const win = new BrowserWindow(browserOptions)

// Navigate.
if (browserOptions.transparent) {
  win.loadFile('index.html')
} else {
  // No transparency, so we load a fallback that uses basic styles.
  win.loadFile('fallback.html')
}

systemPreferences.getAccentColor() Windows macOS​

Returns string - The users current system wide accent color preference in RGBA hexadecimal form.

const color = systemPreferences.getAccentColor() // `"aabbccdd"`
const red = color.substr(0, 2) // "aa"
const green = color.substr(2, 2) // "bb"
const blue = color.substr(4, 2) // "cc"
const alpha = color.substr(6, 2) // "dd"

Esta API solo esta disponible desde macOS 10.15 Mojave or posteriores.

systemPreferences.getColor(color) Windows macOS​

  • color string - One of the following values:
    • On Windows:
      • 3d-dark-shadow - Sombra oscura para elementos de tres dimensiones mostrados.
      • 3d-face - Color facial para elementos de tres dimensiones mostrados y para cuadro de fondos de las caja de diálogo.
      • 3d-highlight - Resalta color para elementos de tres dimensiones mostrados.
      • 3d-light - Color claro para elementos de tres dimensiones mostrados.
      • 3d-shadow - Color oscuro para elementos de tres dimensiones mostrados.
      • active-border - Borde de ventana activo.
      • active-caption - Active window title bar. Specifies the left side color in the color gradient of an active window's title bar if the gradient effect is enabled.
      • active-caption-gradient - El color del lado derecho en el tono del color de un título de barra de una ventana activa.
      • app-workspace - Color de fondo de múltiples documentos de aplicaciones de interfase.
      • button-text - Texto en los botones de presión.
      • caption-text - Textos en subtítulos, tamaño de la caja y la barra de desplazamiento de la caja de flecha.
      • desktop - Color de fondo del escritorio.
      • disabled-text - Gris (desactivado) texto.
      • highlight - objeto(s) seleccionados en un control.
      • highlight-text - Texto de objeto(s) seleccionados en un control.
      • hotlight - Color para un hiperlink o un muy rastreado objeto.
      • inactive-border - Borde de ventana inactivo.
      • inactive-caption - Inactive window caption. Specifies the left side color in the color gradient of an inactive window's title bar if the gradient effect is enabled.
      • inactive-caption-gradient - Color del lado derecho en el tono de color de un título de barra de una ventana inactiva.
      • inactive-caption-text - Color del texto en un subtítulo inactivo.
      • info-background - Color de fondo para control de información de herramientas.
      • info-text - Color de texto para controles de información de herramientas.
      • menu - Fondo del menú.
      • menu-highlight - El color usado para resaltar los objetos del menú cuando el menú aparece como un menú plano.
      • menubar - El color de fondo para la barra del menú cuando los menús aparecen como menús planos.
      • menu-text - Textos en menús.
      • scrollbar - Desplazar la barra en el área gris.
      • window - Fondo de la ventana.
      • window-frame - Cuadro de ventana.
      • window-text - Texto en ventanas.
    • On macOS
      • control-background - El fondo de un elemento de interfaz grande, tal como un navegador o tablet.
      • control - La superficie de un control.
      • control-text - El texto de un control que no está deshabilitado.
      • disabled-control-text - El texto de un control que esta deshabilitado.
      • find-highlight - El color de un indicador de búsqueda.
      • grid - Las líneas de cuadrículas de un elemento de interfaz como una tabla.
      • header-text - El texto de una celda de cabecera en una tabla.
      • highlight - La fuente de luz virtual en la pantalla.
      • keyboard-focus-indicator - El anillo que aparece alrededor del control actualmente enfocado cuando se usa el teclado para la nevagación por la interface.
      • label - El texto de una etiqueta que contiene el contenido primario.
      • link - Un enlace a otro contenido.
      • placeholder-text - Una cadena de marcador de posición en una vista de control o texto.
      • quaternary-label - El texto de una etiqueta de menor importancia que una etiqueta terciaria como el texto de la marca de agua.
      • scrubber-textured-background - El fonfo de un depurado en el Touch Bar.
      • secondary-label - El texto de una etiqueta de menor importancia que una etiqueta normal como el usado para representar un subtítulo o información adicional.
      • selected-content-background - El fondo para el contenido seleccionado en una ventana clave o en una vista.
      • selected-control - La superficie de un control seleccionado.
      • selected-control-text - El texto un control seleccionado.
      • selected-menu-item-text - El texto del menú seleccionado.
      • selected-text-background - El fondo de un texto seleccionado.
      • selected-text - Texto seleccionado.
      • separator - Un separado entre las diferentes secciones del contenido.
      • shadow - La sombra virtual proyectada por un objeto en la pantalla.
      • tertiary-label - El texto para una etiqueta de menor importancia que una etiqueta secundaria como una etiqueta que se usa para representar texto deshabilidato.
      • text-background - Texto de fondo.
      • text - Texto en un documento.
      • under-page-background - El fondo detrás del contenido de un documento.
      • unemphasized-selected-content-background - El contenido seleccionado en una ventana o vista no-clave.
      • unemphasized-selected-text-background - Un fondo para el texto seleccionado en una ventana o vista no clave.
      • unemphasized-selected-text-background - Texto seleccionado en una ventana o vista no clave.
      • window-background - El fondo de una ventana.
      • window-frame-text - El texto en la area de la barra de título de la ventana.

Returns string - The system color setting in RGBA hexadecimal form (#RRGGBBAA). Vea el Windows docs y el macOS docs para más detalles.

Los siguientes colores solo están disponibles en macOS 10.14: find-highlight, selected-content-background, separator, unemphasized-selected-content-background, unemphasized-selected-text-background, y unemphasized-selected-text.

systemPreferences.getSystemColor(color) macOS​

  • color string - One of the following values:
    • azul
    • marrón
    • gris
    • verde
    • naranja
    • rosa
    • púrpura
    • rojo
    • amarillo

Devuelve string - El sistema de color estándar formateado como #RRGGBBAA.

Devuelve uno de los varios colores estándar del sistema que se adaptan automáticamente a la vibración y los cambios en los ajustes de accesibilidad como "Aumentar contraste" y "reducir transparencia". Ver Apple Documentation para mas detalles.

systemPreferences.getEffectiveAppearance() macOS​

Devuelve string - Puede ser dark, light o unknown.

Obtiene confiración de la apariencia de macOS que está actulemente aplicada, mapea a NSApplication.effectiveAppearance

systemPreferences.canPromptTouchID() macOS​

Devuelve boolean - si este dispositivo tiene la habilidad para usar Touch ID.

systemPreferences.promptTouchID(reason) macOS​

  • reason string - La razón por la que estás pidiendo por la autenticación Touch ID

Devuelve Promise<void> - Se resuelve si el usuario se ha autenticado con éxito con Touch ID.

const { systemPreferences } = require('electron')

systemPreferences.promptTouchID('To get consent for a Security-Gated Thing').then(success => {
  console.log('You have successfully authenticated with Touch ID!')
}).catch(err => {
  console.log(err)
})

Esta API en si misma no va a proteger sus datos de usuario, más bien, es un mecanismo para permitirle hacerlo. Native apps will need to set Access Control Constants like kSecAccessControlUserPresence on their keychain entry so that reading it would auto-prompt for Touch ID biometric consent. Esto se podría hacer con node-keytar, de tal manera que se almacenaría una clave de cifrado con node-keytar u sólo se obtendría si promptTouchID() se resuelve.

systemPreferences.isTrustedAccessibilityClient(prompt) macOS​

  • prompt boolean - Si el usuario será informado o no vía prompt si el proceso actual no es confiable.

Devuelve boolean - true si el proceso actual es un cliente de accesibilidad de confianza y false si no lo es.

systemPreferences.getMediaAccessStatus(mediaType) Windows macOS​

  • mediaType string - Puede ser microphone, camera o screen.

Devuelve string - Puede ser not-determined, granted, denied, restricted o unknown.

This user consent was not required on macOS 10.13 High Sierra so this method will always return granted. macOS 10.14 Mojave o superior requiere consentimiento para acceso a microphone y camera. macOS 10.15 Catalina o superior requiere consentimiento para acceso a screen.

Windows 10 has a global setting controlling microphone and camera access for all win32 applications. It will always return granted for screen and for all media types on older versions of Windows.

systemPreferences.askForMediaAccess(mediaType) macOS​

  • mediaType string - el tipo de medio que se solicita; puede ser microphone, camera.

Devuelve Promise<boolean> - Una promesa que resuelve con true se fue concedido el consentimiento y false si fue denegado. Si un mediaType invalido es pasado, la promesa será rechazada. Si se negó una solicitud de acceso y después se cambia a través del panel de Preferencias del Sistema, se requerirá un reinicio de la aplicación para que los nuevos permisos surtan efecto. Si el acceso ya ha sido solicitado y denegado, must ser cambiado a través del panel de preferencias; una alerta no aparecerá y la promesa resolverá con el estado de acceso existente.

Important: Para poder aprovechar correctamente esta API, debes must set las cadenas NSMicrophoneUsageDescription y NSCameraUsageDescription en el archivo Info.plist de tu aplicación. Los valores para estas claves se utilizarán para rellenar los diálogos de permisos para que el usuario sea informado correctamente sobre el propósito de la solicitud de permiso. See Electron Application Distribution for more information about how to set these in the context of Electron.

This user consent was not required until macOS 10.14 Mojave, so this method will always return true if your system is running 10.13 High Sierra.

systemPreferences.getAnimationSettings()​

Devuelve Objeto:

  • shouldRenderRichAnimation boolean - Devuelve verdadero is animaciones ricas deben ser renderizadas. Se observa en el tipo de sesión (por ejemplo, escritorio remoto) y ajustes de accesibilidad para dar orientación a animaciones pesadas.
  • scrollAnimationsEnabledBySystem boolean - Determina sobre una base por plataforma si las animaciones de desplazamiento (por ejemplo, producidas por la clave home/end) deben estar habilitadas.
  • prefiere ReducdMotion boolean - Determina si el usuario desea un movimiento reducido basado en APIs de la plataforma.

Devuelve un objeto con las configuraciones del sistema de animación.

Propiedades​

systemPreferences.accessibilityDisplayShouldReduceTransparency macOS Deprecated​

A boolean property which determines whether the app avoids using semitransparent backgrounds. This maps to NSWorkspace.accessibilityDisplayShouldReduceTransparency

Deprecated: Use the new nativeTheme.prefersReducedTransparency API.

systemPreferences.effectiveAppearance macOS SoloLectura​

Una propiedad string que puede ser dark, light o unknown.

Devuelve la configuración de apariencia de macOS que esta aplicada actualmente a tu aplicación mapea a NSApplication.effectiveAppearance