Не стандартно
Эта возможность не является стандартной и стандартизировать её пока никто не собирается. Не используйте её на сайтах, смотрящих во внешний мир: она будет работать не у всех пользователей. Также могут присутствовать большие несовместимости между реализациями и её поведение может в будущем измениться.
This API is available on Firefox OS for internal applications only.
Введение
DeviceStorage
— интерфейс, используемый для доступа к файлам в особом хранилище (или области хранения), доступном на устройстве. Это хранилище, по сути, является файловой системой — хотя оно на самом деле скрывает нижележащую файловую системы.
Чтобы получить доступ к хранилищу, необходимо использовать метод navigator.getDeviceStorage()
, возвращающую объекты DeviceStorage
. Затем вы сможете использовать методы и свойства этих объектов, чтобы получить доступ к содержимому хранилища.
Свойства
-
DeviceStorage.storageName
Read only -
Строка, представляющая имя области хранения. Та же, что используется при вызове
getDeviceStorage
чтобы получить объектDeviceStorage
. -
DeviceStorage.default
Read only -
Логическое значение, указывающее, назначено ли это хранилище по умолчанию для хранения новых файлов (
true
) или нет (false
).
Обработчики событий
-
DeviceStorage.onchange
-
Обрабатывает событие
change
. Это событие происходит каждый раз, когда содержимое хранилища меняется.
Функции
-
DeviceStorage.add()
- Создает файл в области хранения. Имя файла генерируется автоматически.
-
DeviceStorage.addNamed()
- Создает файл в области хранения. Имя файла задается при вызове функции.
-
DeviceStorage.available()
-
Возвращает
available
если хранилище доступно для использования иshared
если устройство подключено к ПК. -
DeviceStorage.delete()
- Удаляет файл из области хранения.
-
DeviceStorage.enumerate()
- Возвращает список файлов, доступных в области хранения. Полученные файлы доступны только для чтения.
-
DeviceStorage.enumerateEditable()
- Возвращает список файлов, доступных в области хранения.
-
DeviceStorage.freeSpace()
- Возвращает количество свободного места, доступного в области хранения.
-
DeviceStorage.get()
- Возвращает файлы, доступные только для чтения.
-
DeviceStorage.getEditable()
- Возвращает файлы, доступные для редактирования.
-
DeviceStorage.usedSpace()
- Возвращает количество занятого места в области хранения.
Обработчики событий
Функции, наследованные от EventTarget
интерфейса:
EventTarget.addEventListener()
- Register an event handler of a specific event type on the
EventTarget
. EventTarget.removeEventListener()
- Removes an event listener from the
EventTarget
. EventTarget.dispatchEvent()
- Dispatch an event to this
EventTarget
.
Спецификация
Не является частью какой-либо спецификации.