DeviceStorage.usedSpace()

Summary

The usedSpace method is used to get the total of space used by the storage (the amount of space filled by files).

The request's result is a number representing the amount of available space expressed in Bytes.

Syntax

var instanceOfDOMRequest = instanceOfDeviceStorage.usedSpace();

Returns

It returns a DOMRequest object to handle the success or error of the operation.

Example

var sdcard = navigator.getDeviceStorage("sdcard");

var request = sdcard.usedSpace();

request.onsuccess = function () {
  // The result is expressed in bytes, let's turn it into Gigabytes
  var size = this.result / Math.pow(10,9);

  console.log("The files on your SDCard take " + size.toFixed(2) + "GB of space.");
}

request.onerror = function () {
  console.warn("Unable to get the space used by the SDCard: " + this.error);
}

Specification

Not part of any specification.

See also

• DeviceStorage
• DOMRequest
• Device Storage API