FileSystemDirectoryEntry: getDirectory() method

Cú pháp

getDirectory()
getDirectory(path)
getDirectory(path, options)
getDirectory(path, options, successCallback)
getDirectory(path, options, successCallback, errorCallback)

Tham số

path Optional

Một chuỗi đại diện cho đường dẫn tuyệt đối hoặc đường dẫn tương đối với thư mục mà phương thức được gọi, mô tả mục thư mục nào cần trả về. Đường dẫn tuyệt đối có thể không sử dụng được vì lý do bảo mật.

options Optional

Một đối tượng cho phép bạn chỉ định có tạo mục hay không nếu nó bị thiếu và có phải là lỗi nếu tệp đã tồn tại hay không. Các tùy chọn này hiện không hữu ích trong ngữ cảnh Web. Xem phần tham số options để biết thêm chi tiết.

successCallback Optional

Một phương thức được gọi khi FileSystemDirectoryEntry đã được tạo. Phương thức nhận một tham số đơn: đối tượng FileSystemDirectoryEntry đại diện cho thư mục.

errorCallback Optional

Một phương thức được gọi nếu xảy ra lỗi. Nhận một tham số đầu vào duy nhất là đối tượng DomException mô tả lỗi xảy ra.

Tham số options

Đối tượng tham số options chấp nhận các tham số sau:

create Optional

Nếu thuộc tính này là true và thư mục được yêu cầu không tồn tại, tác nhân người dùng sẽ tạo nó. Mặc định là false. Thư mục cha phải đã tồn tại.

exclusive Optional

Nếu true và tùy chọn create cũng là true, thư mục không được tồn tại trước khi phát lệnh gọi. Thay vào đó, phải có thể tạo nó mới vào thời điểm gọi. Mặc định là false. Tham số này bị bỏ qua nếu create là false.

Bảng dưới đây mô tả kết quả của từng tổ hợp cờ tùy theo điều kiện đường dẫn đích:

Giá trị trả về

Không có (undefined).

Ngoại lệ

NotFoundError DOMException

Được ném ra nếu tùy chọn create không được chỉ định (hoặc được chỉ định là false), và thư mục không tồn tại.

SecurityError DOMException

Được ném ra nếu yêu cầu truy cập thư mục bị từ chối vì lý do bảo mật.

TypeMismatchError DOMException

Được ném ra nếu đường dẫn được chỉ định không phải là thư mục; có thể là tệp, hoặc bộ mô tả tệp không được hỗ trợ như một đường ống; điều này phụ thuộc vào tác nhân người dùng ở một mức độ nào đó.

Ví dụ

Trong ví dụ này, hàm tìm một tệp JSON trong thư mục dữ liệu ứng dụng của người dùng chứa từ điển người dùng cho ngôn ngữ được chỉ định, sau đó tải từ điển đó.

let dictionary = null;

function loadDictionaryForLanguage(appDataDirEntry, lang) {
  dictionary = null;

  appDataDirEntry.getDirectory("Dictionaries", {}, (dirEntry) => {
    dirEntry.getFile(`${lang}-dict.json`, {}, (fileEntry) => {
      fileEntry.file((dictFile) => {
        let reader = new FileReader();

        reader.addEventListener("loadend", () => {
          dictionary = JSON.parse(reader.result);
        });

        reader.readAsText(dictFile);
      });
    });
  });
}

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• API Mục Tệp và Thư mục
• FileSystemDirectoryEntry