mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-20 13:15:48 +01:00
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
||
|
||
[Home](./index.md) > [bitburner](./bitburner.md) > [NS](./bitburner.ns.md) > [spawn](./bitburner.ns.spawn.md)
|
||
|
||
## NS.spawn() method
|
||
|
||
Terminate current script and start another in 10 seconds.
|
||
|
||
**Signature:**
|
||
|
||
```typescript
|
||
spawn(script: string, numThreads?: number, ...args: (string | number | boolean)[]): void;
|
||
```
|
||
|
||
## Parameters
|
||
|
||
| Parameter | Type | Description |
|
||
| --- | --- | --- |
|
||
| script | string | Filename of script to execute. |
|
||
| numThreads | number | _(Optional)_ Number of threads to spawn new script with. Will be rounded to nearest integer. |
|
||
| args | (string \| number \| boolean)\[\] | Additional arguments to pass into the new script that is being run. |
|
||
|
||
**Returns:**
|
||
|
||
void
|
||
|
||
## Remarks
|
||
|
||
RAM cost: 2 GB
|
||
|
||
Terminates the current script, and then after a delay of about 10 seconds it will execute the newly-specified script. The purpose of this function is to execute a new script without being constrained by the RAM usage of the current one. This function can only be used to run scripts on the local server.
|
||
|
||
Because this function immediately terminates the script, it does not have a return value.
|
||
|
||
Running this function with a numThreads argument of 0 or less will cause a runtime error.
|
||
|
||
## Example 1
|
||
|
||
|
||
```ts
|
||
// NS1:
|
||
//The following example will execute the script ‘foo.script’ with 10 threads and the arguments ‘foodnstuff’ and 90:
|
||
spawn('foo.script', 10, 'foodnstuff', 90);
|
||
```
|
||
|
||
## Example 2
|
||
|
||
|
||
```ts
|
||
// NS2:
|
||
//The following example will execute the script ‘foo.script’ with 10 threads and the arguments ‘foodnstuff’ and 90:
|
||
ns.spawn('foo.script', 10, 'foodnstuff', 90);
|
||
```
|
||
|