Làm việc với tệp & thư mục

ba-the-he.mjs - cùng một việc đọc tệp, ba đời API

import fs from "node:fs";                      // thế hệ 1 & 2: callback + sync
import { readFile } from "node:fs/promises";   // thế hệ 3: Promise - mặc định nên dùng

// 1) callback (2009) - lồng vài tầng là thành "kim tự tháp"
fs.readFile("ca.txt", "utf8", (err, data) => {
  if (err) throw err;
  // chỉ dùng được data ở TRONG này
});

// 2) sync - CHẶN cả tiến trình đến khi đọc xong
const a = fs.readFileSync("ca.txt", "utf8");

// 3) Promise - await được, lỗi bắt bằng try/catch quen thuộc
const b = await readFile("ca.txt", "utf8");

doc-ghi.mjs - ghi rồi đọc lại, mỗi việc một dòng await

import { readFile, writeFile } from "node:fs/promises";

await writeFile("ca.txt", "Hôm nay: 3 con cá 🐟", "utf8");   // tạo mới (hoặc đè nếu đã có)
const noiDung = await readFile("ca.txt", "utf8");            // đọc CẢ tệp vào một chuỗi
console.log(noiDung);

Hôm nay: 3 con cá 🐟

duong-dan.mjs - chạy từ thư mục /tmp/meo-fs trên máy thử; dòng cuối trên máy mèo con sẽ khác

import path from "node:path";

console.log(path.join("nhat-ky-meo", "2026", "ca.txt"));   // nối bằng separator đúng của hệ
console.log(path.basename("nhat-ky-meo/2026/ca.txt"));     // tên tệp ở cuối đường dẫn
console.log(path.extname("nhat-ky-meo/2026/ca.txt"));      // phần mở rộng
console.log(path.resolve("ca.txt"));                       // tuyệt đối hoá - tính theo CWD

nhat-ky-meo/2026/ca.txt
ca.txt
.txt
/tmp/meo-fs/ca.txt

vi-tri.mjs - tệp đặt tại /tmp/meo-fs trên máy thử; máy mèo con sẽ in đường dẫn của máy mình

import { fileURLToPath } from "node:url";
import path from "node:path";

console.log(import.meta.url);                                // vị trí tệp này, dạng URL file://
console.log(import.meta.dirname);                            // Node ≥ 20.11: có sẵn luôn
console.log(path.dirname(fileURLToPath(import.meta.url)));   // cách "cổ điển" - kết quả y hệt

file:///tmp/meo-fs/vi-tri.mjs
/tmp/meo-fs
/tmp/meo-fs

dung-cay.mjs - cây nhật ký: nhat-ky-meo/ca.txt + nhat-ky-meo/2026/(2 tệp tháng)

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

await mkdir("nhat-ky-meo/2026", { recursive: true });   // tạo CẢ chuỗi thư mục cha nếu thiếu
await writeFile("nhat-ky-meo/ca.txt", "tổng: 38 con cá\n");
await writeFile("nhat-ky-meo/2026/thang-01.txt", "tháng 1: ăn 20 con cá\n");
await writeFile("nhat-ky-meo/2026/thang-02.txt", "tháng 2: ăn 18 con cá\n");

liet-ke.mjs - Dirent cho biết loại ngay khi liệt kê

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

const muc = await readdir("nhat-ky-meo", { withFileTypes: true });
for (const m of muc.sort((a, b) => a.name.localeCompare(b.name))) {
  console.log(m.isDirectory() ? "📁" : "📄", m.name);   // readdir không hứa thứ tự - tự sort
}

const thongTin = await stat("nhat-ky-meo/ca.txt");      // thongTin.mtime là Date lần sửa cuối
console.log("ca.txt nặng", thongTin.size, "byte");

📁 2026
📄 ca.txt
ca.txt nặng 19 byte

tong-dung-luong.mjs - 69 byte là tổng đúng của 3 tệp vừa dựng (19 + 25 + 25, đếm theo byte UTF-8)

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

async function tongDungLuong(thuMuc) {
  let tong = 0;
  for (const m of await readdir(thuMuc, { withFileTypes: true })) {
    const duongDan = path.join(thuMuc, m.name);
    if (m.isDirectory()) {
      tong += await tongDungLuong(duongDan);   // đệ quy xuống thư mục con
    } else {
      tong += (await stat(duongDan)).size;     // tệp thì cộng kích thước
    }
  }
  return tong;
}

console.log(await tongDungLuong("nhat-ky-meo"), "byte");

69 byte

thao-tac.mjs - sao chép, di chuyển, ghi nối, xoá

import { copyFile, rename, rm, appendFile } from "node:fs/promises";

await copyFile("nhat-ky-meo/ca.txt", "nhat-ky-meo/ca-sao-luu.txt");        // sao chép
await rename("nhat-ky-meo/ca-sao-luu.txt", "nhat-ky-meo/2026/ca-cu.txt");  // "di chuyển" = đổi đường dẫn
await appendFile("nhat-ky-meo/meo.log", "đã sao lưu xong\n");              // nối vào cuối - hợp cho log
await rm("nhat-ky-meo/2026/ca-cu.txt", { force: true });                   // force: không lỗi nếu tệp không có

// Xoá cả thư mục lẫn mọi thứ bên trong (cẩn thận!):
// await rm("nhat-ky-meo", { recursive: true, force: true });

ghi-an-toan.mjs - mẹo tệp tạm + rename đè

import { writeFile, rename, readFile } from "node:fs/promises";

async function ghiAnToan(tep, noiDung) {
  const tam = tep + ".tmp";
  await writeFile(tam, noiDung, "utf8");   // 1) ghi HẾT ra tệp tạm trước
  await rename(tam, tep);                  // 2) rename đè - atomic trên cùng filesystem
}

await ghiAnToan("diem-so.json", JSON.stringify({ meo: "Mướp", ca: 38 }));
console.log(await readFile("diem-so.json", "utf8"));

{"meo":"Mướp","ca":38}

theo-doi.mjs - MỘT lần writeFile, nhận HAI sự kiện change (máy Linux chạy thử - cả 5 lần chạy đều vậy)

import { watch } from "node:fs";
import { writeFile } from "node:fs/promises";
import { setTimeout as cho } from "node:timers/promises";

const ac = new AbortController();
watch("nhat-ky-meo", { signal: ac.signal }, (loaiSuKien, tenTep) => {
  console.log("sự kiện:", loaiSuKien, "→", tenTep);
});

await cho(100);                                              // chờ watcher sẵn sàng
await writeFile("nhat-ky-meo/ca.txt", "thêm 1 con cá 🐟");   // sửa tệp trong lúc đang theo dõi
await cho(300);
ac.abort();                                                  // dừng theo dõi - không abort, tiến trình không thoát

sự kiện: change → ca.txt
sự kiện: change → ca.txt