Deno.FsFile

Экземпляр ReadableStream, представляющий содержимое файла в виде байтов. Это упрощает взаимодействие с другими API, основанными на потоках веб-страниц.

const file = await Deno.open("my_file.txt", { read: true });
const decoder = new TextDecoder();
for await (const chunk of file.readable) {
  console.log(decoder.decode(chunk));
}
file.close();

Идентификатор ресурса, связанный с экземпляром файла. Идентификатор ресурса следует рассматривать как непрозрачную ссылку на ресурс.

Экземпляр WritableStream для записи содержимого файла. Это упрощает взаимодействие с другими API, основанными на потоках веб-страниц.

const items = ["hello", "world"];
const file = await Deno.open("my_file.txt", { write: true });
const encoder = new TextEncoder();
const writer = file.writable.getWriter();
for (const item of items) {
  await writer.write(encoder.encode(item));
}
file.close();

Закрыть файл. Закрытие файла после завершения работы с ним важно для предотвращения утечки ресурсов.

const file = await Deno.open("my_file.txt");
// do work with "file" object
file.close();

Прочитать файл в буфер массива (p).

Возвращает количество прочитанных байтов во время операции или EOF (null) в случае отсутствия данных для чтения.

Возможна ситуация, когда чтение успешно возвращает 0 байтов. Это не означает EOF.

Не гарантируется, что весь буфер будет прочитан за один вызов.

// if "/foo/bar.txt" contains the text "hello world":
const file = await Deno.open("/foo/bar.txt");
const buf = new Uint8Array(100);
const numberOfBytesRead = await file.read(buf); // 11 bytes
const text = new TextDecoder().decode(buf);  // "hello world"
file.close();

Синхронно прочитать из файла в буфер массива (p).

Возвращает количество прочитанных байтов во время операции или EOF (null) в случае отсутствия данных для чтения.

Возможна ситуация, когда чтение успешно возвращает 0 байтов. Это не означает EOF.

Не гарантируется, что весь буфер будет прочитан за один вызов.

// if "/foo/bar.txt" contains the text "hello world":
const file = Deno.openSync("/foo/bar.txt");
const buf = new Uint8Array(100);
const numberOfBytesRead = file.readSync(buf); // 11 bytes
const text = new TextDecoder().decode(buf);  // "hello world"
file.close();

Переместить указатель на заданную offset в режиме, заданном whence. Вызов возвращает новое положение в ресурсе (байты от начала).

// Given file pointing to file with "Hello world", which is 11 bytes long:
const file = await Deno.open(
  "hello.txt",
  { read: true, write: true, truncate: true, create: true },
);
await file.write(new TextEncoder().encode("Hello world"));

// advance cursor 6 bytes
const cursorPosition = await file.seek(6, Deno.SeekMode.Start);
console.log(cursorPosition);  // 6
const buf = new Uint8Array(100);
await file.read(buf);
console.log(new TextDecoder().decode(buf)); // "world"
file.close();

Режимы перемещения указателя работают следующим образом:

// Given file.rid pointing to file with "Hello world", which is 11 bytes long:
const file = await Deno.open(
  "hello.txt",
  { read: true, write: true, truncate: true, create: true },
);
await file.write(new TextEncoder().encode("Hello world"));

// Seek 6 bytes from the start of the file
console.log(await file.seek(6, Deno.SeekMode.Start)); // "6"
// Seek 2 more bytes from the current position
console.log(await file.seek(2, Deno.SeekMode.Current)); // "8"
// Seek backwards 2 bytes from the end of the file
console.log(await file.seek(-2, Deno.SeekMode.End)); // "9" (e.g. 11-2)

Синхронно переместить указатель на заданную offset в режиме, заданном whence. Возвращается новое положение в ресурсе (байты от начала).

const file = Deno.openSync(
  "hello.txt",
  { read: true, write: true, truncate: true, create: true },
);
file.writeSync(new TextEncoder().encode("Hello world"));

// advance cursor 6 bytes
const cursorPosition = file.seekSync(6, Deno.SeekMode.Start);
console.log(cursorPosition);  // 6
const buf = new Uint8Array(100);
file.readSync(buf);
console.log(new TextDecoder().decode(buf)); // "world"
file.close();

Режимы перемещения указателя работают следующим образом:

// Given file.rid pointing to file with "Hello world", which is 11 bytes long:
const file = Deno.openSync(
  "hello.txt",
  { read: true, write: true, truncate: true, create: true },
);
file.writeSync(new TextEncoder().encode("Hello world"));

// Seek 6 bytes from the start of the file
console.log(file.seekSync(6, Deno.SeekMode.Start)); // "6"
// Seek 2 more bytes from the current position
console.log(file.seekSync(2, Deno.SeekMode.Current)); // "8"
// Seek backwards 2 bytes from the end of the file
console.log(file.seekSync(-2, Deno.SeekMode.End)); // "9" (e.g. 11-2)
file.close();

Возвращает Deno.FileInfo для файла.

import { assert } from "https://deno.land/std/testing/asserts.ts";

const file = await Deno.open("hello.txt");
const fileInfo = await file.stat();
assert(fileInfo.isFile);
file.close();

Синхронно возвращает Deno.FileInfo для файла.

import { assert } from "https://deno.land/std/testing/asserts.ts";

const file = Deno.openSync("hello.txt")
const fileInfo = file.statSync();
assert(fileInfo.isFile);
file.close();

Усекает (или расширяет) файл до указанной len. Если len не указано, всё содержимое файла усекается.

Усечение всего файла

const file = await Deno.open("my_file.txt", { write: true });
await file.truncate();
file.close();

Усечение части файла

// if "my_file.txt" contains the text "hello world":
const file = await Deno.open("my_file.txt", { write: true });
await file.truncate(7);
const buf = new Uint8Array(100);
await file.read(buf);
const text = new TextDecoder().decode(buf); // "hello w"
file.close();

Синхронно усекает (или расширяет) файл до указанной len. Если len не указано, всё содержимое файла усекается.

Усечение всего файла

const file = Deno.openSync("my_file.txt", { write: true });
file.truncateSync();
file.close();

Усечение части файла

// if "my_file.txt" contains the text "hello world":
const file = Deno.openSync("my_file.txt", { write: true });
file.truncateSync(7);
const buf = new Uint8Array(100);
file.readSync(buf);
const text = new TextDecoder().decode(buf); // "hello w"
file.close();

Записать содержимое буфера массива (p) в файл.

Возвращает количество записанных байтов.

Не гарантируется, что весь буфер будет записан за один вызов.

const encoder = new TextEncoder();
const data = encoder.encode("Hello world");
const file = await Deno.open("/foo/bar.txt", { write: true });
const bytesWritten = await file.write(data); // 11
file.close();

Синхронно записать содержимое буфера массива (p) в файл.

Возвращает количество записанных байтов.

Не гарантируется, что весь буфер будет записан за один вызов.

const encoder = new TextEncoder();
const data = encoder.encode("Hello world");
const file = Deno.openSync("/foo/bar.txt", { write: true });
const bytesWritten = file.writeSync(data); // 11
file.close();