FileSystemEntry
Giao diện FileSystemEntry của File and Directory Entries API đại diện cho một mục đơn lẻ trong hệ thống tệp. Mục đó có thể là tệp hoặc thư mục (thư mục được đại diện bởi giao diện FileSystemDirectoryEntry). Giao diện này bao gồm các phương thức để làm việc với tệp, chẳng hạn như sao chép, di chuyển, xóa và đọc tệp, cũng như thông tin về tệp mà nó trỏ đến, bao gồm tên tệp và đường dẫn từ thư mục gốc đến mục.
Khái niệm cơ bản
Bạn không tạo trực tiếp các đối tượng FileSystemEntry. Thay vào đó, bạn sẽ nhận được một đối tượng dựa trên giao diện này thông qua các API khác. Giao diện này đóng vai trò là lớp cơ sở cho các giao diện FileSystemFileEntry và FileSystemDirectoryEntry, cung cấp các tính năng đặc thù cho các mục hệ thống tệp đại diện cho tệp và thư mục tương ứng.
Giao diện FileSystemEntry bao gồm các phương thức mà bạn mong đợi để thao tác tệp và thư mục, nhưng nó cũng có một phương thức tiện lợi để lấy URL của mục: toURL(). Nó cũng giới thiệu một lược đồ URL mới: filesystem:.
Bạn có thể sử dụng lược đồ filesystem: trên Google Chrome để xem tất cả tệp và thư mục được lưu trữ trong nguồn gốc của ứng dụng. Chỉ cần dùng lược đồ filesystem: cho thư mục gốc của nguồn gốc ứng dụng. Ví dụ: nếu ứng dụng của bạn ở http://www.example.com, hãy mở filesystem:http://www.example.com/temporary/ trong một tab. Chrome hiển thị danh sách chỉ đọc tất cả tệp và thư mục được lưu trữ trong nguồn gốc của ứng dụng.
Ví dụ
Để xem ví dụ về cách toURL() hoạt động, hãy xem mô tả phương thức. Đoạn mã dưới đây cho thấy cách bạn có thể xóa một tệp theo tên.
// Xử lý các tiền tố dành riêng cho từng trình duyệt.
window.requestFileSystem =
window.requestFileSystem || window.webkitRequestFileSystem;
// …
// Mở hệ thống tệp với bộ nhớ tạm thời
window.requestFileSystem(
TEMPORARY,
1024 * 1024 /* 1MB */,
(fs) => {
fs.root.getFile(
"log.txt",
{},
(fileEntry) => {
fileEntry.remove(() => {
console.log("File removed.");
}, onError);
},
onError,
);
},
onError,
);
Thuộc tính phiên bản
Giao diện này cung cấp các thuộc tính sau.
filesystemRead only-
Một đối tượng
FileSystemđại diện cho hệ thống tệp nơi mục đó tồn tại. fullPathRead only-
Một chuỗi cung cấp đường dẫn đầy đủ, tuyệt đối từ thư mục gốc của hệ thống tệp đến mục; cũng có thể được coi là đường dẫn tương đối so với thư mục gốc, có thêm ký tự "/" ở đầu.
isDirectoryRead only-
Giá trị boolean là
truenếu mục đại diện cho một thư mục; ngược lại làfalse. isFileRead only-
Giá trị Boolean là
truenếu mục đại diện cho một tệp. Nếu không phải tệp, giá trị này làfalse. nameRead only-
Một chuỗi chứa tên của mục (phần cuối của đường dẫn, sau ký tự "/" cuối cùng).
Phương thức phiên bản
Giao diện này định nghĩa các phương thức sau.
copyTo()Deprecated Non-standard-
Sao chép tệp hoặc thư mục đến một vị trí mới trong hệ thống tệp.
getMetadata()Deprecated Non-standard-
Lấy siêu dữ liệu về tệp, chẳng hạn như ngày sửa đổi và kích thước.
getParent()-
Trả về một
FileSystemDirectoryEntryđại diện cho thư mục cha của mục. moveTo()Deprecated Non-standard-
Di chuyển tệp hoặc thư mục đến một vị trí mới trong hệ thống tệp, hoặc đổi tên tệp hoặc thư mục.
remove()Deprecated Non-standard-
Xóa tệp hoặc thư mục được chỉ định. Bạn chỉ có thể xóa các thư mục rỗng.
toURL()Deprecated Non-standard-
Tạo và trả về URL xác định mục. URL này sử dụng lược đồ URL
"filesystem:".
Thông số kỹ thuật
| Specification |
|---|
| File and Directory Entries API> # api-entry> |
Tương thích trình duyệt
Xem thêm
- File and Directory Entries API
FileSystemFileEntryvàFileSystemDirectoryEntryđược dựa trênFileSystemEntry.