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 FileSystemFileEntryFileSystemDirectoryEntry, 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.

js
// 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.

filesystem Read only

Một đối tượng FileSystem đại diện cho hệ thống tệp nơi mục đó tồn tại.

fullPath Read 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.

isDirectory Read only

Giá trị boolean là true nếu mục đại diện cho một thư mục; ngược lại là false.

isFile Read only

Giá trị Boolean là true nế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.

name Read 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