bitburner-src/markdown/bitburner.ns.kill_1.md
David Walker aa7facd4ba
NETSCRIPT: Greatly speed up script launching, and remove the limitation unique args per script (#440)
* Remove the limitation unique args per script
* Internal changes to how runningScripts are stored on the server, to make common usage faster.
2023-04-27 18:21:06 -04:00

1.5 KiB

Home > bitburner > NS > kill

NS.kill() method

Terminate the script(s) with the provided filename, hostname, and script arguments.

Signature:

kill(filename: string, hostname?: string, ...args: ScriptArg[]): boolean;

Parameters

Parameter Type Description
filename string Filename of the script to kill.
hostname string (Optional) Hostname where the script to kill is running. Defaults to the current server.
args ScriptArg[] Arguments of the script to kill.

Returns:

boolean

True if the scripts were successfully killed, and false otherwise.

Remarks

RAM cost: 0.5 GB

Kills the script(s) with the provided filename, running on the specified host with the specified args. To instead kill a script using its PID, see the other ns.kill entry.

Example

// kill the script "foo.js" on the same server the current script is running from, with no arguments
ns.kill("foo.js");

// kill the script "foo.js" on the "n00dles" server with no arguments.
ns.kill("foo.js", "n00dles");

// kill the script foo.js on the current server that was ran with the arguments [1, “foodnstuff”, false]:
ns.kill("foo.js", ns.getHostname(), 1, "foodnstuff", false);