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

Home > bitburner > NS > fileExists

NS.fileExists() method

Check if a file exists.

Signature:

fileExists(filename: string, host?: string): boolean;

Parameters

Parameter	Type	Description
filename	string	Filename of file to check.
host	string	Host of target server. This is optional. If it is not specified then the function will use the current server as the target server.

Returns:

boolean

True if specified file exists, and false otherwise.

Remarks

RAM cost: 0.1 GB

Returns a boolean indicating whether the specified file exists on the target server. The filename for scripts is case-sensitive, but for other types of files it is not. For example, fileExists(“brutessh.exe”) will work fine, even though the actual program is named 'BruteSSH.exe'.

If the hostname/ip argument is omitted, then the function will search through the current server (the server running the script that calls this function) for the file.

Example 1

// NS1:
//The function call will return true if the script named foo.script exists on the foodnstuff server, and false otherwise.
fileExists("foo.script", "foodnstuff");

//The function call will return true if the current server contains the FTPCrack.exe program, and false otherwise.
fileExists("ftpcrack.exe");

*

Example 2

// NS2:
// The function call will return true if the script named foo.script exists on the foodnstuff server, and false otherwise.
ns.fileExists("foo.script", "foodnstuff");

// The function call will return true if the current server contains the FTPCrack.exe program, and false otherwise.
ns.fileExists("ftpcrack.exe");