mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-23 14:42:28 +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
55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
||
|
||
[Home](./index.md) > [bitburner](./bitburner.md) > [NS](./bitburner.ns.md) > [run](./bitburner.ns.run.md)
|
||
|
||
## NS.run() method
|
||
|
||
Start another script on the current server.
|
||
|
||
**Signature:**
|
||
|
||
```typescript
|
||
run(script: string, numThreads?: number, ...args: (string | number | boolean)[]): number;
|
||
```
|
||
|
||
## Parameters
|
||
|
||
| Parameter | Type | Description |
|
||
| --- | --- | --- |
|
||
| script | string | Filename of script to run. |
|
||
| numThreads | number | _(Optional)_ Integer number of threads for new script. Defaults to 1. |
|
||
| args | (string \| number \| boolean)\[\] | Additional arguments to pass into the new script that is being run. Note that if any arguments are being passed into the new script, then the second argument numThreads must be filled in with a value. |
|
||
|
||
**Returns:**
|
||
|
||
number
|
||
|
||
Returns the PID of a successfully started script, and 0 otherwise.
|
||
|
||
## Remarks
|
||
|
||
RAM cost: 1 GB
|
||
|
||
Run a script as a separate process. This function can only be used to run scripts located on the current server (the server running the script that calls this function). Requires a significant amount of RAM to run this command.
|
||
|
||
If the script was successfully started, then this functions returns the PID of that script. Otherwise, it returns 0.
|
||
|
||
PID stands for Process ID. The PID is a unique identifier for each script. The PID will always be a positive integer.
|
||
|
||
Running this function with a numThreads argument of 0 or less will cause a runtime error.
|
||
|
||
## Example
|
||
|
||
|
||
```js
|
||
//The simplest way to use the run command is to call it with just the script name. The following example will run ‘foo.js’ single-threaded with no arguments:
|
||
ns.run("foo.js");
|
||
|
||
//The following example will run ‘foo.js’ but with 5 threads instead of single-threaded:
|
||
ns.run("foo.js", 5);
|
||
|
||
//This next example will run ‘foo.js’ single-threaded, and will pass the string ‘foodnstuff’ into the script as an argument:
|
||
ns.run("foo.js", 1, 'foodnstuff');
|
||
```
|
||
|