DeviceStorage

Summary

The DeviceStorage interface is used to access files on a specific storage area available on the device. A storage area is, in essence, a file system repository even if it hides the reality of the underlying file system.

To access a storage area, you must use the navigator.getDeviceStorage() method, which returns DeviceStorage objects. You then use those objects' methods and properties to access the content of the storage area.

Properties

• DeviceStorage.canBeMounted
  Indicates if the storage area denoted by storageName is capable of being mounted and unmounted.

• DeviceStorage.canBeFormatted
  Indicates if the storage area denoted by storageName is capable of being formatted.

• DeviceStorage.default
  A Boolean value that indicates if this storage area is the default destination for storing new files (true) or not (false). Determines if this storage area is the one which will be used by default for storing new files.

• DeviceStorage.isRemovable
  Indicates if the storage area denoted by storageName is removable

• DeviceStorage.lowDiskSpace
  A Boolean value that returns true if this storage area is close to being full.

• DeviceStorage.storageName
  A string representing the name of the storage area.

• DeviceStorage.storagePath
  Return the mounted name of volume device

Event handlers

• DeviceStorage.onchange
  A handler for the change event. This event occurs each time the storage area is updated.

Methods

• DeviceStorage.add()
  Adds a file to the storage area. The name of the file is automatically generated.

• DeviceStorage.addNamed()
  Adds a file to the storage area. The name of the file is specified when calling the method.

• DeviceStorage.appendNamed()

• DeviceStorage.available()
  Reports "available" when the storage area is available for use and "shared" when the storage area is mounted on a computer using the device's USB connection.

• DeviceStorage.delete()
  Removes a file from the storage area.

• DeviceStorage.enumerate
  Iterates over the list of files available in the storage area. The files retrieved through this method are read only.

• DeviceStorage.enumerateEditable()
  Iterates over the list of files available in the storage area.

• DeviceStorage.format()

• DeviceStorage.freeSpace()
  Retrieves the total amount of free space available in the storage area.

• DeviceStorage.get()
  Retrieves a read only file from the storage area.

• DeviceStorage.getEditable()
  Retrieves an editable file from the storage area.

• DeviceStorage.usedSpace()
  Retrieves the total amount of space used by the storage area.

• DeviceStorage.getRoot()

• DeviceStorage.mount()

• DeviceStorage.storageStatus()

• DeviceStorage.unmount()

Event handlers

Methods inherited from the EventTarget interface:

• DeviceStorage.addEventListener()
  Register an event handler of a specific event type on the EventTarget.

• DeviceStorage.removeEventListener()
  Removes an event listener from the EventTarget.

• DeviceStorage.dispatchEvent()
  Dispatch an event to this EventTarget.

Additional methods for Mozilla chrome code

Mozilla extensions for use by JS-implemented event targets to implement on* properties. See also WebIDL bindings.

• void setEventHandler(DOMString type, EventHandler handler)
• EventHandler getEventHandler(DOMString type)