bitburner-src/markdown/bitburner.ns.getscriptlogs.md
Snarling 08e71c732b
Threads are a positive integer (#366)
* 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
2023-02-14 01:32:01 -05:00

1.8 KiB
Raw Blame History

Home > bitburner > NS > getScriptLogs

NS.getScriptLogs() method

Get all the logs of a script.

Signature:

getScriptLogs(fn?: string, host?: string, ...args: (string | number | boolean)[]): string[];

Parameters

Parameter Type Description
fn string (Optional) Optional. Filename of script to get logs from.
host string (Optional) Optional. Hostname of the server that the script is on.
args (string | number | boolean)[] Arguments to identify which scripts to get logs for.

Returns:

string[]

Returns a string array, where each line is an element in the array. The most recently logged line is at the end of the array.

Remarks

RAM cost: 0 GB

Returns a scripts logs. The logs are returned as an array, where each line is an element in the array. The most recently logged line is at the end of the array. Note that there is a maximum number of lines that a script stores in its logs. This is configurable in the games options. If the function is called with no arguments, it will return the current scripts 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

//Get logs from foo.js on the current server that was run with no args
ns.getScriptLogs("foo.js");

//Open logs from foo.js on the foodnstuff server that was run with no args
ns.getScriptLogs("foo.js", "foodnstuff");

//Open logs from foo.js on the foodnstuff server that was run with the arguments [1, "test"]
ns.getScriptLogs("foo.js", "foodnstuff", 1, "test");