mirror of
https://github.com/bitburner-official/bitburner-src.git
synced 2024-12-24 23:22:29 +01:00
32 lines
1.6 KiB
ReStructuredText
32 lines
1.6 KiB
ReStructuredText
wget() Netscript Function
|
|
=========================
|
|
|
|
.. js:function:: wget(url, target[, hostname=current hostname])
|
|
|
|
:RAM cost: 0 GB
|
|
:param string url: URL to pull data from
|
|
:param string target: Filename to write data to. Must be script or text file
|
|
:param string ip: Optional hostname of server for target file.
|
|
|
|
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, .ns, .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). Example::
|
|
|
|
wget("https://raw.githubusercontent.com/danielyxie/bitburner/master/README.md", "game_readme.txt");
|
|
|
|
**IMPORTANT:** This is an asynchronous function that returns a Promise. The Promise's 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 :ref:`netscriptjs`.
|
|
|
|
In NetscriptJS, you must preface any call to
|
|
``wget`` with the ``await`` keyword (like you would ``hack`` or ``sleep``).
|
|
|
|
``wget`` will still work in :ref:`netscript1`, 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.
|