mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-24 23:22:29 +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
51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
||
|
||
[Home](./index.md) > [bitburner](./bitburner.md) > [NS](./bitburner.ns.md) > [tail](./bitburner.ns.tail.md)
|
||
|
||
## NS.tail() method
|
||
|
||
Open the tail window of a script.
|
||
|
||
**Signature:**
|
||
|
||
```typescript
|
||
tail(fn?: FilenameOrPID, host?: string, ...args: (string | number | boolean)[]): void;
|
||
```
|
||
|
||
## Parameters
|
||
|
||
| Parameter | Type | Description |
|
||
| --- | --- | --- |
|
||
| fn | [FilenameOrPID](./bitburner.filenameorpid.md) | _(Optional)_ Optional. Filename or PID of the script being tailed. If omitted, the current script is tailed. |
|
||
| host | string | _(Optional)_ Optional. Hostname of the script being tailed. Defaults to the server this script is running on. If args are specified, this is not optional. |
|
||
| args | (string \| number \| boolean)\[\] | Arguments for the script being tailed. |
|
||
|
||
**Returns:**
|
||
|
||
void
|
||
|
||
## Remarks
|
||
|
||
RAM cost: 0 GB
|
||
|
||
Opens a script’s logs. This is functionally the same as the tail Terminal command.
|
||
|
||
If the function is called with no arguments, it will open the current script’s logs.
|
||
|
||
Otherwise, the fn, hostname/ip, and args… arguments can be used to get the logs from another script. Remember that scripts are uniquely identified by both their names and arguments.
|
||
|
||
## Example
|
||
|
||
|
||
```js
|
||
//Open logs from foo.js on the current server that was run with no args
|
||
ns.tail("foo.js");
|
||
|
||
//Get logs from foo.js on the foodnstuff server that was run with no args
|
||
ns.tail("foo.js", "foodnstuff");
|
||
|
||
//Get logs from foo.js on the foodnstuff server that was run with the arguments [1, "test"]
|
||
ns.tail("foo.js", "foodnstuff", 1, "test");
|
||
```
|
||
|