FileSystemDirectoryEntry: getFile() method

Cú pháp

getFile()
getFile(path)
getFile(path, options)
getFile(path, options, successCallback)
getFile(path, options, successCallback, errorCallback)

Tham số

path Optional

Một chuỗi chỉ định đường dẫn, tương đối với thư mục mà phương thức được gọi, mô tả mục tệp nào cần trả về.

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.

successCallback Optional

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

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à tệp đượ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, tệp không được tồn tại trước khi phát lệnh gọi. Mặc định là false. Tham số này bị bỏ qua nếu create là false.

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à tệp không tồn tại.

SecurityError DOMException

Được ném ra nếu yêu cầu truy cập tệp 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à tệp; có thể là thư mục, 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
• FileSystemFileEntry