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()
  • 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 the app is started by being passed as parameter to the default Electron executable, this property is true in the main process, otherwise it is undefined. For example when running the app with electron ., it is true, even if the app is packaged (isPackaged) is true. This can be useful to determine how many arguments will need to be sliced off from process.argv.

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 desaprobació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​

A string representing the path to the resources directory.

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 boolean que controla si las advertencias de depreciación serán lanzadas como excepciones. 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​

A boolean that controls whether or not deprecations printed to stderr include their stack trace. 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​

A boolean that controls whether or not process warnings printed to stderr include their stack trace. 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
  • utility - In a node process launched as a service

process.versions.chrome Solo lectura​

A string representing Chrome's version string.

process.versions.electron Solo lectura​

A string representing Electron's version string.

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.

process.parentPort​

A Electron.ParentPort property if this is a UtilityProcess (or null otherwise) allowing communication with the parent 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.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.
  • 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 se ha creado 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.