---
title: File and Directory Entries API
slug: Web/API/File_and_Directory_Entries_API
tags:
  - API
  - File System API
  - File and Directory Entries API
  - Files
  - NeedsTranslation
  - Non-standard
  - Overview
  - Reference
  - TopicStub
translation_of: Web/API/File_and_Directory_Entries_API
---
<p>{{DefaultAPISidebar("File System API")}}</p>

<p>{{Non-standard_Header}}</p>

<p>API доступа к файлам и директориям имитирует локальную файловую систему, в которой веб-приложения могут перемещаться и получать доступ к файлам. Вы можете разрабатывать приложения, которые читают, записывают и создают файлы и/или каталоги в виртуальной изолированной файловой системе. </p>

<div class="note">
<p>Поскольку это нестандартный API, спецификация которого в настоящее время не входит в стандарт, важно помнить, что не все браузеры реализуют его, а те, которые поддерживают, могут реализовывать только небольшие его части. Дополнительные сведения в разделе {{anch("Browser compatibility")}} </p>
</div>

<p>Существуют два очень похожих API в зависимости от того, хотите ли вы асинхронного или синхронного поведения. Синхронный API предназначен для использования внутри {{domxref("Worker")}} и будет возвращать желаемые значения. Асинхронный API не будет блокировать выполнение кода, а API не будет возвращать значения; вместо этого вам нужно будет предоставить колбэк-функцию для обработки одного или нескольких ответов.</p>

<div class="warning">
<p>Firefox реализация File System API очень ограничена: не поддерживается создание файлов. Доступ к файлам осуществляется только через {{HTMLElement("input")}} элемент (см. так же {{domxref("HTMLInputElement")}}) или путём перетаскивания файла/папки (<a href="/en-US/docs/Web/API/HTML_Drag_and_Drop_API">drag and drop</a>). Firefox также не реализует синхронный API. Внимательно проверьте совместимость браузера для любой части API, которую вы используете. ( см. <a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Firefox_support">Поддержка File System API в Firefox</a>)</p>
</div>

<h2 id="Получение_доступа_к_файловой_системе">Получение доступа к файловой системе</h2>

<p>Есть два способа получить доступ к файловой системе, определённым в текущем проекте спецификации:</p>

<ul>
 <li>При обработке события {{event("drop")}} вы можете вызвать {{domxref("DataTransferItem.webkitGetAsEntry()")}} что бы получить {{domxref("FileSystemEntry")}} для "брошенного" элемента. Если результат не <code>null</code>, то это брошенный файл или каталог, и вы можете использовать вызовы файловой системы для работы с ним.</li>
 <li>Свойство {{domxref("HTMLInputElement.webkitEntries")}} позволяет получить объект {{domxref("FileSystemFileEntry")}} для выбранного файла, но только если они перетаскиваются в <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1326031" rel="noopener">средство выбора</a> файлов ( <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1326031" rel="noopener">баг 1326031</a> ). Если {{domxref("HTMLInputElement.webkitdirectory")}} является <code>true</code>, то {{HTMLElement("input")}} работает для выбора директорий, и вы можете получить объект {{domxref("FileSystemDirectoryEntry")}} для каждой выбранной директории.</li>
</ul>

<h2 id="Асинхронный_API">Асинхронный API</h2>

<p>Асинхронный API следует использовать для большинства операций, чтобы доступ к файловой системе не блокировал весь браузер, если он используется в основном потоке. Он включает в себя следующие интерфейсы:</p>

<dl>
 <dt>{{domxref("FileSystem")}}</dt>
 <dd>Представляет файловую систему.</dd>
 <dt>{{domxref("FileSystemEntry")}}</dt>
 <dd>Базовый интерфейс, представляющий одну запись в файловой системе. Это реализуется другими интерфейсами, которые представляют файлы или каталоги.</dd>
 <dt>{{domxref("FileSystemFileEntry")}}</dt>
 <dd>Представляет отдельный файл в файловой системе.</dd>
 <dt>{{domxref("FileSystemDirectoryEntry")}}</dt>
 <dd>Представляет отдельный каталог в файловой системе.</dd>
 <dt>{{domxref("FileSystemDirectoryReader")}}</dt>
 <dd>Созданный путём вызова {{domxref("FileSystemDirectoryEntry.createReader()")}}, этот интерфейс предоставляет функции, которые позволяют вам читать содержимое каталога.</dd>
 <dt>{{domxref("FileSystemFlags")}}</dt>
 <dd>Определяет набор значений, которые используются при указании флагов опций при вызове определённых методов в <a href="https://developer.mozilla.org/en-US/docs/Web/API/File_and_Directory_Entries_API">File System API</a>.</dd>
 <dt>{{domxref("FileError")}}</dt>
 <dd>Представляет ошибку, которая возникает при вызовах асинхронной файловой системы.</dd>
</dl>

<p>Также есть две глобальные функции (которые в настоящее время не являются частью спецификации и реализуются только в Google Chrome). Они доступны внутри объекта {{domxref("Window")}} и реализованы в {{domxref("LocalFileSystem")}}: <code>requestFileSystem()</code> и <code>resolveLocalFileSystemURL()</code>.</p>

<h2 id="Синхронный_API">Синхронный API</h2>

<p>Синхронный API следует использовать только в {{domxref("Worker")}}-ах; эти вызовы блокируются до тех пор, пока не закончат своё выполнение, и просто возвращают результаты вместо использования колбэков. Использование их в основном потоке заблокирует браузер, что непослушно. В противном случае интерфейсы ниже отражают интерфейсы асинхронного API.</p>

<dl>
 <dt>{{domxref("FileSystemSync")}}</dt>
 <dd>Представляет файловую систему.</dd>
 <dt>{{domxref("FileSystemEntrySync")}}</dt>
 <dd>Базовый интерфейс, представляющий одну запись в файловой системе. Это реализуется другими интерфейсами, которые представляют файлы или каталоги. {{domxref("EntrySync")}}</dd>
 <dt>{{domxref("FileSystemFileEntrySync")}}</dt>
 <dd>Представляет отдельный файл в файловой системе.</dd>
 <dt>{{domxref("FileSystemDirectoryEntrySync")}}</dt>
 <dd>Представляет отдельный каталог в файловой системе.</dd>
 <dt>{{domxref("FileSystemDirectoryReaderSync")}}</dt>
 <dd>Созданный путём вызова {{domxref("FileSystemDirectoryEntrySync.createReader()")}}, этот интерфейс предоставляет функции, которые позволяют вам читать содержимое каталога.</dd>
 <dt>{{domxref("FileException")}}</dt>
 <dd>Представляет ошибку, которая возникает при вызовах синхронной файловой системы.</dd>
</dl>

<p>Также есть две глобальные функции (которые в настоящее время не являются частью спецификации и реализуются только в Google Chrome). Они доступны в объекте {{domxref("Worker")}} и реализованы в{{domxref("LocalFileSystemSync")}}: <code>requestFileSystemSync()</code> и <code>resolveLocalFileSystemSyncURL()</code>.</p>

<h2 id="Другие_интерфейсы">Другие интерфейсы</h2>

<dl>
 <dt>{{domxref("LocalFileSystem")}}</dt>
 <dd>Предоставляет вам доступ к изолированной файловой системе.</dd>
 <dt>{{domxref("LocalFileSystemSync")}}</dt>
 <dt></dt>
 <dt>{{domxref("LockedFile")}}</dt>
 <dd>Предоставляет инструменты для работы с данным файлом со всеми необходимыми блокировками.</dd>
 <dt>{{domxref("Metadata")}}{{experimental_inline}}</dt>
</dl>

<h2 id="Спецификации">Спецификации</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('File System API')}}</td>
   <td>{{Spec2('File System API')}}</td>
   <td>Draft of proposed API</td>
  </tr>
 </tbody>
</table>

<p>Этот API не имеет официальной спецификации W3C или WHATWG.</p>

<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2>

<p>{{Compat}}</p>

<p>{{Compat("api.FileSystemSync", 0)}}</p>

<h2 id="Смотрите_также">Смотрите также</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Introduction">Introduction to the File and Directory Entries API</a></li>
 <li><a href="/en-US/docs/Web/API/File_and_Directory_Entries_API/Firefox_support">File and Directory Entries API support in Firefox</a></li>
</ul>