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

<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [write](./bitburner.ns.write.md)

## NS.write() method

Write data to a file.

<b>Signature:</b>

```typescript
write(handle: string, data?: string[] | number | string, mode?: "w" | "a"): Promise<void>;
```

## Parameters

|  Parameter | Type | Description |
|  --- | --- | --- |
|  handle | string | Port or text file that will be written to. |
|  data | string\[\] \| number \| string | Data to write. |
|  mode | "w" \| "a" | Defines the write mode. Only valid when writing to text files. |

<b>Returns:</b>

Promise&lt;void&gt;

## Remarks

RAM cost: 0 GB

This function can be used to either write data to a text file (.txt).

This function will write data to that text file. If the specified text file does not exist, then it will be created. The third argument mode, defines how the data will be written to the text file. If \*mode is set to “w”, then the data is written in “write” mode which means that it will overwrite all existing data on the text file. If mode is set to any other value then the data will be written in “append” mode which means that the data will be added at the end of the text file.