bitburner-src/markdown/bitburner.ns.wget.md
2022-10-20 03:56:59 +11:00

2.1 KiB
Raw Blame History

Home > bitburner > NS > wget

NS.wget() method

Download a file from the internet.

Signature:

wget(url: string, target: string, host?: string): Promise<boolean>;

Parameters

Parameter Type Description
url string URL to pull data from.
target string Filename to write data to. Must be script or text file.
host string Optional hostname/ip of server for target file.

Returns:

Promise<boolean>

True if the data was successfully retrieved from the URL, false otherwise.

Remarks

RAM cost: 0 GB

Retrieves data from a URL and downloads it to a file on the specified server. The data can only be downloaded to a script (.script, .js) or a text file (.txt). If the file already exists, it will be overwritten by this command. Note that it will not be possible to download data from many websites because they do not allow cross-origin resource sharing (CORS).

IMPORTANT: This is an asynchronous function that returns a Promise. The Promises resolved value will be a boolean indicating whether or not the data was successfully retrieved from the URL. Because the function is async and returns a Promise, it is recommended you use wget in NetscriptJS (Netscript 2.0).

In NetscriptJS, you must preface any call to wget with the await keyword (like you would hack or sleep). wget will still work in Netscript 1.0, but the functions execution will not be synchronous (i.e. it may not execute when you expect/want it to). Furthermore, since Promises are not supported in ES5, you will not be able to process the returned value of wget in Netscript 1.0.

Example 1

// NS1:
wget("https://raw.githubusercontent.com/bitburner-official/bitburner-src/master/README.md", "game_readme.txt");

Example 2

// NS2:
await ns.wget("https://raw.githubusercontent.com/bitburner-official/bitburner-src/master/README.md", "game_readme.txt");