Constructor
# new DuProcess(processPath, argsopt, timeoutopt)
Constructs a new DuProcess instance
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
processPath |
string
|
The path to the process executable binary | ||
args |
Array.<string>
|
<optional> |
The common arguments used to run the process. You can append arguments each time you run the process with start(args) | |
timeout |
int
|
<optional> |
0 | Waiting timeout after process start, in ms, 0 to avoid waiting, -1 for infinite. If the process times out, process will not be killed, the script will just stop waiting. |
Members
Array.<any>
# static args
The common arguments used to run the process. You can append arguments each time you run the process with start(args)
Boolean
# static readonly isAppPackage
True if the process path leads to an application package (.app folder containing at least "/Contents/MacOS") on mac. False otherwise.
Array.<Array.<string>>
# static queue
An Array of arguments array.
Arrays of arguments in the queue will be processed one after each other.
Update the Array and launch the queue with startQueue()
Arrays of arguments in the queue will be processed one after each other.
Update the Array and launch the queue with startQueue()
int
# static timeout
Waiting timeout after process start, in ms, 0 to avoid waiting, -1 for infinite.
If the process times out, process will not be killed, the script will just stop waiting. Default: 0
If the process times out, process will not be killed, the script will just stop waiting. Default: 0
Methods
# static isAppPackage(path) → {bool}
Checks if a given path leads to an Application package on Mac, i.e. it's a path ending with
.app
containing at least Contents/MacOS/
.
Parameters:
Name | Type | Description |
---|---|---|
path |
string
|
Folder
|
File
|
The path to the file or folder to check. |
true if path is an application package.
bool
# static run(process, argsopt, detachedopt) → {string}
Runs a command with some arguments.
Parameters:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
process |
string
|
File
|
The process or a path to the process. | ||
args |
Array.<string>
|
<optional> |
[] | The arguments to pass to the command. |
detached |
bool
|
<optional> |
false | The script won't wait for the command to finish. |
The output from the command.
string
# buildCmd(argsopt) → {string}
Builds and returns the command line
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
args |
Array.<string>
|
<optional> |
Args to append to DuProcess.args before starting |
The command
string
# buildQueueCmd() → {string}
Builds and returns the command line to launch the current queue
The command
string
# start(args, timeoutopt)
Starts the process
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
args |
Array
|
Args to append to DuProcess.args before starting |
|
timeout |
int
|
<optional> |
Overrides the default timeout. |
# startCmd(cmd)
Starts a command (in another thread).
Parameters:
Name | Type | Description |
---|---|---|
cmd |
string
|
The command to start |
# startQueue(timeoutopt)
Starts the queue
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
timeout |
int
|
<optional> |
Overrides the default timeout. |
# waitForFinished(timeoutopt)
Waits for the process to finish
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
timeout |
int
|
<optional> |
Overrides the default timeout. |