bitburner-src/markdown/bitburner.ns.isrunning.md

65 lines
2.2 KiB
Markdown
Raw Normal View History

2021-10-30 18:34:14 +02:00
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [isRunning](./bitburner.ns.isrunning.md)
## NS.isRunning() method
Check if a script is running.
2021-10-30 18:34:14 +02:00
<b>Signature:</b>
```typescript
2021-10-30 21:46:34 +02:00
isRunning(script: string, host: string, ...args: string[]): boolean;
2021-10-30 18:34:14 +02:00
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
2021-10-30 21:46:34 +02:00
| script | string | Filename of script to check. This is case-sensitive. |
2021-11-03 05:27:21 +01:00
| host | string | Host of target server. |
2021-10-30 18:34:14 +02:00
| args | string\[\] | Arguments to specify/identify which scripts to search for. |
<b>Returns:</b>
boolean
True if specified script is running on the target server, and false otherwise.
## Remarks
2021-10-30 21:46:34 +02:00
RAM cost: 0.1 GB
2021-10-30 18:34:14 +02:00
Returns a boolean indicating whether the specified script is running on the target server. Remember that a script is uniquely identified by both its name and its arguments.
2021-10-30 18:34:14 +02:00
## Example 1
2021-10-30 21:46:34 +02:00
```ts
2022-01-08 19:25:06 +01:00
// NS1:
2021-10-30 18:34:14 +02:00
//The function call will return true if there is a script named foo.script with no arguments running on the foodnstuff server, and false otherwise:
isRunning("foo.script", "foodnstuff");
//The function call will return true if there is a script named foo.script with no arguments running on the current server, and false otherwise:
isRunning("foo.script", getHostname());
2022-01-08 19:25:06 +01:00
//The function call will return true if there is a script named foo.script running with the arguments 1, 5, and “test” (in that order) on the joesguns server, and false otherwise:
isRunning("foo.script", "joesguns", 1, 5, "test");
2021-10-30 18:34:14 +02:00
```
2022-01-08 19:25:06 +01:00
## Example 2
2021-10-30 18:34:14 +02:00
2021-10-30 21:46:34 +02:00
```ts
2022-01-08 19:25:06 +01:00
// NS2:
//The function call will return true if there is a script named foo.script with no arguments running on the foodnstuff server, and false otherwise:
ns.isRunning("foo.script", "foodnstuff");
//The function call will return true if there is a script named foo.script with no arguments running on the current server, and false otherwise:
ns.isRunning("foo.script", ns.getHostname());
2021-10-30 18:34:14 +02:00
//The function call will return true if there is a script named foo.script running with the arguments 1, 5, and “test” (in that order) on the joesguns server, and false otherwise:
2022-01-08 19:25:06 +01:00
ns.isRunning("foo.script", "joesguns", 1, 5, "test");
2021-10-30 18:34:14 +02:00
```