FileSystemDirectoryEntry: метод getFile()

Метод интерфейса FileSystemDirectoryEntry getFile() возвращает объект FileSystemFileEntry, соответствующий файлу, содержащемуся где-либо в поддереве каталога, корнем которого является каталог, к которому он применяется.

path Необязательно

Строка, определяющая путь, относительный к каталогу, к которому применяется метод, описывающий запись файла, который требуется вернуть.

options Необязательно

Объект, который позволяет указать, создавать ли запись, если она отсутствует, и является ли ошибкой существование файла. Эти параметры в настоящее время не полезны в веб-контексте. Подробнее см. раздел «Параметр options».

successCallback Необязательно

Метод, который будет вызван после создания FileSystemFileEntry. Метод получает единственный параметр: объект FileSystemFileEntry , представляющий рассматриваемый файл.

errorCallback Необязательно

Метод, который будет вызван в случае возникновения ошибки. Принимает в качестве единственного входного параметра объект DOMException, описывающий произошедшую ошибку.

Параметр options

Объект параметра options принимает следующие параметры:

create Необязательно

Если это свойство true, и запрашиваемый файл не существует, пользовательский агент должен его создать. По умолчанию false. Родительский каталог должен уже существовать.

exclusive Необязательно

Если true, и параметр create также true, файл не должен существовать перед вызовом. Вместо этого он должен быть создан во время вызова. По умолчанию false. Этот параметр игнорируется, если create равен false.

В таблице ниже описан результат каждой возможной комбинации этих флагов в зависимости от того, существует ли целевой путь к файлу.

None (undefined).

NotFoundError DOMException

Выбрасывается, если параметр create не был указан (или был указан как false) и файл не существует.

SecurityError DOMException

Выбрасывается, если запрос доступа к файлу был отклонен по соображениям безопасности.

TypeMismatchError DOMException

Выбрасывается, если указанный путь не является файлом; он, вероятно, является каталогом, но может быть и недоступным дескриптором файла, например, конвейгом; это в какой-то степени зависит от пользовательского агента.

В этом примере представлена функция, задача которой — найти в каталоге данных приложения JSON-файл, содержащий словарь пользователя для заданного языка, а затем загрузить этот словарь.

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);
      });
    });
  });
}

Функция loadDictionaryForLanguage() начинается с использования getDirectory() для получения объекта FileSystemDirectoryEntry, представляющего подпапку с именем «Dictionaries», расположенную внутри указанного каталога данных приложения. Обработчик успеха для этого принимает полученный объект записи каталога и вызывает getFile() для получения объекта FileSystemFileEntry, представляющего файл словаря; в свою очередь, обработчик успеха для этого создаёт новый объект FileReader и использует его для загрузки содержимого файла. Когда это происходит успешно (как указано событием loadend), загруженный текст передаётся в JSON.parse() для преобразования в объект JavaScript.

• File and Directory Entries API
• Введение в File and Directory Entries API
• FileSystemFileEntry