63 lines
1.3 KiB
Plaintext
63 lines
1.3 KiB
Plaintext
---
|
|
title: Read from stdin
|
|
sidebarTitle: Read from stdin
|
|
mode: center
|
|
---
|
|
|
|
In Bun, the `console` object is an `AsyncIterable` that yields lines from `stdin`.
|
|
|
|
```ts index.ts icon="/icons/typescript.svg"
|
|
const prompt = "Type something: ";
|
|
process.stdout.write(prompt);
|
|
for await (const line of console) {
|
|
console.log(`You typed: ${line}`);
|
|
process.stdout.write(prompt);
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
Running this file starts a never-ending interactive prompt that echoes whatever you type.
|
|
|
|
```sh terminal icon="terminal"
|
|
bun run index.ts
|
|
```
|
|
|
|
```txt
|
|
Type something: hello
|
|
You typed: hello
|
|
Type something: hello again
|
|
You typed: hello again
|
|
```
|
|
|
|
---
|
|
|
|
Bun also exposes `stdin` as a `BunFile`, `Bun.stdin`. Use it to incrementally read large inputs piped into the `bun` process.
|
|
|
|
Chunks aren't guaranteed to be split line-by-line.
|
|
|
|
```ts stdin.ts icon="/icons/typescript.svg"
|
|
for await (const chunk of Bun.stdin.stream()) {
|
|
// chunk is Uint8Array
|
|
// this converts it to text (assumes UTF-8 encoding)
|
|
const chunkText = Buffer.from(chunk).toString();
|
|
console.log(`Chunk: ${chunkText}`);
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
Running `stdin.ts` prints whatever is piped into it.
|
|
|
|
```sh terminal icon="terminal"
|
|
echo "hello" | bun run stdin.ts
|
|
```
|
|
|
|
```txt
|
|
Chunk: hello
|
|
```
|
|
|
|
---
|
|
|
|
See [Utils](/runtime/utils) for more utilities.
|