bitburner-src/markdown/bitburner.ns.peek.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; [peek](./bitburner.ns.peek.md)

## NS.peek() method

This function is used to peek at the data from a port. It returns the first element in the specified port without removing that element. If the port is empty, the string “NULL PORT DATA” will be returned.

<b>Signature:</b>

```typescript
peek(port: number): string | number | object;
```

## Parameters

|  Parameter | Type | Description |
|  --- | --- | --- |
|  port | number | Port to peek. Must be an integer between 1 and 20. |

<b>Returns:</b>

string \| number \| object

Data in the specified port.

## Remarks

RAM cost: 1 GB