process
Extensiones para el objeto process.
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 processrenderer
- Un renderer processworker
- En un web workerutility
- 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()
Returns CPUUsage
process.getHeapStatistics()
Devuelve Objeto
:
totalHeapSize
IntegertotalHeapSizeExecutable
IntegertotalPhysicalSize
IntegertotalAvailableSize
IntegerusedHeapSize
IntegerheapSizeLimit
IntegermallocedMemory
IntegerpeakMallocedMemory
IntegerdoesZapGarbage
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()
Returns Promise<ProcessMemoryInfo>
- Resolves with a 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.