mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-20 05:05:47 +01:00
67 lines
2.0 KiB
Markdown
67 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) > [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 1
|
||
|
||
|
||
```ts
|
||
// NS1:
|
||
//Open logs from foo.script on the current server that was run with no args
|
||
tail("foo.script");
|
||
|
||
//Get logs from foo.script on the foodnstuff server that was run with no args
|
||
tail("foo.script", "foodnstuff");
|
||
|
||
//Get logs from foo.script on the foodnstuff server that was run with the arguments [1, "test"]
|
||
tail("foo.script", "foodnstuff", 1, "test");
|
||
```
|
||
|
||
## Example 2
|
||
|
||
|
||
```ts
|
||
// NS2:
|
||
//Open logs from foo.script on the current server that was run with no args
|
||
ns.tail("foo.script");
|
||
|
||
//Get logs from foo.script on the foodnstuff server that was run with no args
|
||
ns.tail("foo.script", "foodnstuff");
|
||
|
||
//Get logs from foo.script on the foodnstuff server that was run with the arguments [1, "test"]
|
||
ns.tail("foo.script", "foodnstuff", 1, "test");
|
||
```
|
||
|