文件 I/O

const foo = Bun.file("foo.txt"); // 相对于当前工作目录
foo.size; // 字节数
foo.type; // MIME 类型

const foo = Bun.file("foo.txt");

await foo.text(); // 字符串格式的内容
await foo.json(); // JSON 对象格式的内容
foo.stream(); // ReadableStream 格式的内容
await foo.arrayBuffer(); // ArrayBuffer 格式的内容
await foo.bytes(); // Uint8Array 格式的内容

Bun.file(1234);
Bun.file(new URL(import.meta.url)); // 引用当前文件

const notreal = Bun.file("notreal.txt");
notreal.size; // 0
notreal.type; // "text/plain;charset=utf-8"
const exists = await notreal.exists(); // false

const notreal = Bun.file("notreal.json", { type: "application/json" });
notreal.type; // => "application/json;charset=utf-8"

Bun.stdin; // 只读
Bun.stdout;
Bun.stderr;

await Bun.file("logs.json").delete();

const data = `这是最好的时代，也是最坏的时代。`;
await Bun.write("output.txt", data);

const input = Bun.file("input.txt");
const output = Bun.file("output.txt"); // 尚不存在！
await Bun.write(output, input);

const encoder = new TextEncoder();
const data = encoder.encode("datadatadata"); // Uint8Array
await Bun.write("output.txt", data);

const input = Bun.file("input.txt");
await Bun.write(Bun.stdout, input);

const response = await fetch("https://bun.com");
await Bun.write("index.html", response);

const file = Bun.file("output.txt");
const writer = file.writer();

const file = Bun.file("output.txt");
const writer = file.writer();

writer.write("it was the best of times\n");
writer.write("it was the worst of times\n");

writer.flush(); // 将缓冲区写入磁盘

const file = Bun.file("output.txt");
const writer = file.writer({ highWaterMark: 1024 * 1024 }); // 1MB

writer.end();

writer.unref();

// 稍后 "重新 ref"
writer.ref();

import { readdir } from "node:fs/promises";

// 读取当前目录中的所有文件
const files = await readdir(import.meta.dir);

import { readdir } from "node:fs/promises";

// 递归读取当前目录中的所有文件
const files = await readdir("../", { recursive: true });

import { mkdir } from "node:fs/promises";

await mkdir("path/to/dir", { recursive: true });

interface Bun {
  stdin: BunFile;
  stdout: BunFile;
  stderr: BunFile;

  file(path: string | number | URL, options?: { type?: string }): BunFile;

  write(
    destination: string | number | BunFile | URL,
    input: string | Blob | ArrayBuffer | SharedArrayBuffer | TypedArray | Response,
  ): Promise<number>;
}

interface BunFile {
  readonly size: number;
  readonly type: string;

  text(): Promise<string>;
  stream(): ReadableStream;
  arrayBuffer(): Promise<ArrayBuffer>;
  json(): Promise<any>;
  writer(params: { highWaterMark?: number }): FileSink;
  exists(): Promise<boolean>;
}

export interface FileSink {
  write(chunk: string | ArrayBufferView | ArrayBuffer | SharedArrayBuffer): number;
  flush(): number | Promise<number>;
  end(error?: Error): number | Promise<number>;
  start(options?: { highWaterMark?: number }): void;
  ref(): void;
  unref(): void;
}