Saltar al contenido principal

process

Extensiones para el objeto process.

Proceso: Main, Renderer

El objeto process de Electron es heredado del objeto process de Node.js. Este agrega los siguientes eventos, propiedades y métodos:

Sandbox

En el procesor renderer en sandbox el objeto process sólo contiene un subconjunto de las APIs:

  • crash()
  • hang()
  • getCreationTime()
  • getHeapStatistics()
  • getBlinkMemoryInfo()
  • getProcessMemoryInfo()
  • getSystemMemoryInfo()
  • getSystemVersion()
  • getCPUUsage()
  • getIOCounters()
  • uptime()
  • argv
  • execPath
  • env
  • pid
  • arch
  • platform
  • sandboxed
  • contextIsolated
  • type
  • version
  • versions
  • mas
  • windowsStore
  • contextId

Eventos

Evento: 'loaded'

Emitido cuando Electron ha cargado su script de inicialización interno y está empezando a carga la página web o el script principal.

Propiedades

process.defaultApp Solo lectura

Un Boolean. When app is started by being passed as parameter to the default app, this property is true in the main process, otherwise it is undefined.

process.isMainFrame Solo lectura

Un Boolean, true cuando el contexto actual del renderer es "main" renderer frame. Si quieres el ID del frame actual deberías usar webFrame.routingId.

process.mas Solo lectura

Un Boolean. Para compilaciones de Mac App Store, esta propiedad es true, para otras compilaciones es undefined.

proceso.noAsar

Un Boolean que controla el soporte ASAR dentro de tu aplicación. Establecer esto a true desactivará el soporte para archivos asar en los módulos integrados de Node.

process.noDeprecation

Un Boolean que controla si las advertencias de deprecación se imprimen o no a stderr. Modificar esta propiedad a true silenciará las advertencias de depreciación. Esta propiedad es usada en lugar de la linea de comando --no-deprecation.

process.resourcesPath Solo lectura

Un string que representa la ruta de acceso al directorio de recursos.

process.sandboxed Solo lectura

Un Boolean. When the renderer process is sandboxed, this property is true, otherwise it is undefined.

process.contextIsolated SoloLectura

Un Boolean que indica si el renderer context acutal tiene el contextIsolation activado. Es undefined en el main process.

proceso.desechoDegradación

Un Booleano que controla si las advertencias de degradación son consideradas como excepción. Ajustando este como verdad se producirán errores por degradación. Esta propiedad es usada en vez de la linea de comando --throw-deprecation.

proceso.ubicarDegradación

Un Booleano que controla si las degradaciones son enviadas a stderr incluyen su proceso de ubicación. Ajustando este como true se enviarán ubicaciones de pila por degradaciones. Esta propiedad es en vez de la linea de comando --trace-deprecation.

proceso.ubicarAdvertenciasdeProcesos

Un Booleano que controla si las advertencias de procesos son enviadas a stderr incluyen su proceso de ubicación. Ajustando este como verdad se enviarán ubicaciones de pila para advertencias de procesos (incluyendo degradaciones). Esta propiedad es en vez de la línea de comando --trace-warnings.

process.type Solo lectura

Un String que representa el tipo de proceso actual, puede ser:

  • browser - El main process
  • renderer - Un renderer process
  • worker - En un web worker

process.versions.chrome Solo lectura

Una cadena representando la versión de cadena de Chrome.

process.versions.electron Solo lectura

Una cadena representando la versión de cadena de Electron.

process.windowsStore Solo lectura

Un Boolean. If the app is running as a Windows Store app (appx), this property is true, for otherwise it is undefined.

process.contextId SoloLectura

Un String (opcional) que representa un único global ID del contexto JavaScript actual. Cada frame tiene su propio contexto JavaScript. Cuando el contextIsolation está activado, el isolated world además tiene un contexto JavaScript separado. Esta propiedad solo está disponible en el renderer process.

Métodos

El objeto proceso tiene los siguientes métodos:

proceso.crash()

Hace que el hilo principal del proceso actual se detenga.

process.getCreationTime()

Devuelve Number | null - El numero de mili-segundos desde la época o null si la información no esta disponible

Indicates the creation time of the application. El tiempo es representado como número de milisegundos desde la época. Devuelve null si no es capaz de obtener el tiempo de creación del proceso.

process.getCPUUsage()

Devuelve CPUUsage

process.getIOCounters() Windows Linux

Devuelve IOCounters

process.getHeapStatistics()

Devuelve Objeto:

  • totalHeapSize Integer
  • totalHeapSizeExecutable Integer
  • totalPhysicalSize Integer
  • totalAvailableSize Integer
  • usedHeapSize Integer
  • heapSizeLimit Integer
  • mallocedMemory Integer
  • peakMallocedMemory Integer
  • doesZapGarbage Boolean

Devuelve un objeto con estadísticas de la pila V8. Tome en cuenta que todas las estadísticas son reportadas en Kilobytes.

process.getBlinkMemoryInfo()

Devuelve Objeto:

  • allocated Integer - Tamaño de todos los objetos asignados en Kilobytes.
  • marked Integer - Tamaño de todos los objetos marcados en Kilobytes.
  • total Integer - Espacio total asignado en Kilobytes.

Returns an object with Blink memory information. It can be useful for debugging rendering / DOM related memory issues. Note that all values are reported in Kilobytes.

process.getProcessMemoryInfo()

Devuelve Promise<ProcessMemoryInfo> - Resuelve con un ProcessMemoryInfo

Returns an object giving memory usage statistics about the current process. Note that all statistics are reported in Kilobytes. This api should be called after app ready.

Chromium no provee el valor residentSet para macOS. Esto es porque macOS realiza compresión en memoria que no han sido utilizadas recientemente. Como resultado, el valor del tamaño del conjunto de residentes no es lo que uno esperaría. Memoria private es más representativo del uso real de la memoria de precompresión del proceso en macOS.

process.getSystemMemoryInfo()

Devuelve Objeto:

  • total Entero - La cantidad total de memoria física en kilobytes de la que dispone el sistema.
  • libre entero - La cantidad de memoria que no está siendo usada por aplicaciones o caché de disco.
  • swapTotal Integer Windows Linux - La cantidad total de memoria de swap en Kilobytes disponible para el sistema.
  • swapFree Integer Windows Linux - La cantidad libre de memoria de swap en Kilobytes disponible para el sistema.

Returns an object giving memory usage statistics about the entire system. Note that all statistics are reported in Kilobytes.

process.getSystemVersion()

Devuelve String - La versión de sistema operativo del host.

Ejemplo:

const version = process.getSystemVersion()
console.log(version)
// En macOS -> '10.13.6'
// En Windows -> '10.0.17763'
// En Linux -> '4.15.0-45-generic'

Note: Devuelve la versión actual del sistema en lugar de la versión del kernel en macOS deferente a os.release().

process.takeHeapSnapshot(filePath)

  • filePath String - Ruta al archivo de salida.

Devuelve Boolean - Indica si la instantánea ha sido creada correctamente.

Toma una instantánea de la pila V8 y la guarda en filePath.

process.hang()

Hace que el hilo principal del proceso actual se caiga.

process.setFdLimit(maxDescriptors) macOS Linux

  • maxDescriptors Entero

Ajusta el limite suave del descriptor del documento a maxDescriptors o el límite duro OS, cual sea menor para el proceso actual.