Trong ES module, import.meta.url cho biết vị trí module dưới dạng URL. Nếu lấy pathname rồi đưa thẳng cho filesystem, đường dẫn có khoảng trắng hoặc ký tự được mã hóa có thể sai. Node.js cung cấp fileURLToPath để chuyển file URL sang đường dẫn theo hệ điều hành.
So sánh trên cùng đầu vào
Ví dụ dùng API path dạng POSIX để tạo đường dẫn URL có khoảng trắng. fileURLToPath sau đó trả đường dẫn phù hợp với máy đang chạy. Chạy bằng Node.js và đọc assertion trước khi đưa vào CLI thật.
const assert = require('node:assert/strict');
const {fileURLToPath, pathToFileURL} = require('node:url');
const path = require('node:path');
const original = path.resolve('folder with spaces', 'data.json');
const url = pathToFileURL(original);
assert.equal(fileURLToPath(url), original);
assert.ok(url.pathname.includes('%20'));
Chọn theo đại lượng cần dùng
pathname là thành phần của URL và vẫn mang quy tắc mã hóa URL. fileURLToPath tạo đường dẫn dùng cho hệ điều hành. Nếu filesystem API nhận URL object trực tiếp, có thể truyền một file URL hợp lệ mà không phải đổi thành chuỗi đường dẫn.
Khi đọc file nằm cạnh module, dùng new URL với đường dẫn tương đối và import.meta.url làm base. Cách đó giữ vị trí tương đối theo module thay vì thư mục hiện hành. Nếu dùng process.cwd, chạy CLI từ thư mục khác có thể đổi file được chọn. Trong bài kiểm thử, thử khởi động từ một thư mục tạm để phát hiện sự phụ thuộc đó.
Kiểm tra khả năng di chuyển
Tạo tên thư mục có khoảng trắng, chữ có dấu và dấu phần trăm. Với sản phẩm hỗ trợ Windows, thử trên Windows thật hoặc CI Windows. File URL còn có quy tắc cho ổ đĩa và host, nên một phép decodeURIComponent thủ công không tự thay thế toàn bộ chuyển đổi.
Việc chuyển URL không chứng minh file tồn tại hoặc người dùng có quyền đọc. Xử lý lỗi từ thao tác filesystem và giữ thông báo theo ngữ cảnh của ứng dụng. Nếu nhận URL từ đầu vào bên ngoài, xác minh scheme và quyền truy cập đường dẫn theo hợp đồng trước khi đọc.
So sánh này tập trung vào kiểu dữ liệu và tính di động. Bài không đưa số liệu hiệu năng. Hai API giải quyết hai dạng dữ liệu khác nhau nên lựa chọn hợp lý bắt đầu bằng việc xác định bạn đang thao tác URL hay đường dẫn hệ điều hành.


