Version: Smart Feature Phone 2.5

DeviceStorage.getEditable()

Summary#

The getEditable method is used to retrieve a file, which is editable, from a given storage area.

If the request is successful, the request's result is a FileHandle object used to access and update the file on the device.

Syntax#

var instanceOfDOMRequest = instanceOfDeviceStorage.getEditable(fileName);

Parameters#

  • fileName
    A string representing the full name (path + file name) of the file to retrieve.

Returns#

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

Example#

var sdcard = navigator.getDeviceStorage("sdcard");
var request = sdcard.getEditable("myFile.txt");
request.onsuccess = function () {
var name = this.result.name;
console.log('File "' + name + '" successfully retrieved from the sdcard storage area');
}
request.onerror = function () {
console.warn('Unable to get the file: ' + this.error);
}