Safely run code in separate process. Limit child process requiring module.
npm install --save limited-process
constructor(fileName[, jsCode])
fileName
: Js file`s absolute path. If you provide jsCode
parameter, the fileName
will be this code`s alias, use for stack trace.
jsCode
: A javascript code string, it will be run in other process.
-
fileName
:jsCode
correspondfilename
, use for stack trace. -
jsCode
: A javascript code string, it will be run in other process. -
requireList
: A module name array, in child process all those module names will be required and exposed atglobal.lp.requireList
. -
service
A object consist of function, child process can useglobal.lp.invoke
to invoke those functions. Note than, those function can not return afunction
. If you need running a async task, you can return a promise object. -
cpuUsage
Child process cpu usage. If child process is not running, this property will be undefined. -
memoryUsage
Child process memory usage. If child process is not running, this property will be undefined. -
errors
: A array consist of child process uncaught exception. -
isRunning
: Indicates whether the child process is running. -
startTime
: Child process start time. -
invoke
: you can use this to invoke child processglobal.lp.service
. Like this,invoke(functionName[,...args])
orinvoke.functionName([...args])
. -
pid
,stderr
,stdin
,stdout
: Same tochild_process
module
async start(option = {debug: false})
: Start child process.debug
: Is using--inspect
flag to run child process. Ifdebug
is true,start()
will return a debug net address string.
setTimeout(delay)
How much time to turn off the child processasync kill([signal])
The child.kill() methods sends a signal to the child process. If no argument is given, the process will be sent the 'SIGTERM' signal. Before child process close, child process`sglobal.lp.onClose
will be triggered.
childProcessError
: When child process generate a uncaught exception.close
,error
,exit
: Same tochild_process
module
In child process a lp
object will be exposed at global
.
invoke
: Invoke parent service.Usage same to parentinvoke
.requireList
: Consisting of parental indicated modules.service
: A object consist of function, parent process can useinvoke
to invoke those functions.onClose
: This will be triggered before child process closing.onStart
: This will be triggered after child process has started.onError
: This will be triggered when child process has a unCaughtException.If you return true, this Exception will not be sended to parenterror
property.