mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-19 20:55:44 +01:00
08e71c732b
* Added new positive integer ns validation helper * `run`, `exec`, and `spawn` verify threads as a positive integer. * `run` terminal command also fails if the provided threadcount is not a positive integer. * Removed some references to .script files in various documentation, and removed some of the NS1 example blocks
1.7 KiB
1.7 KiB
Home > bitburner > NS > isRunning
NS.isRunning() method
Check if a script is running.
Signature:
isRunning(script: FilenameOrPID, host?: string, ...args: (string | number | boolean)[]): boolean;
Parameters
| Parameter | Type | Description |
|---|---|---|
| script | FilenameOrPID | Filename or PID of script to check. This is case-sensitive. |
| host | string | (Optional) Hostname of target server. |
| args | (string | number | boolean)[] | Arguments to specify/identify which scripts to search for. |
Returns:
boolean
True if the specified script is running on the target server, and false otherwise.
Remarks
RAM cost: 0.1 GB
Returns a boolean indicating whether the specified script is running on the target server. If you use a PID instead of a filename, the hostname and args parameters are unnecessary. Remember that a script is uniquely identified by both its name and its arguments.
Example
//The function call will return true if there is a script named foo.js with no arguments running on the foodnstuff server, and false otherwise:
ns.isRunning("foo.js", "foodnstuff");
//The function call will return true if there is a script named foo.js with no arguments running on the current server, and false otherwise:
ns.isRunning("foo.js", ns.getHostname());
//The function call will return true if there is a script named foo.js running with the arguments 1, 5, and “test” (in that order) on the joesguns server, and false otherwise:
ns.isRunning("foo.js", "joesguns", 1, 5, "test");