This is an archived page. It's not actively maintained.

DeviceStorage.get()

This API is available on Firefox OS for privileged or certified applications only.

Summary

The get method is used to retrieve a read-only file from a given storage area.

If the request is successful, the request's result is a File object containing the data of the original file on the device.

Syntax

var instanceOfDOMRequest = instanceOfDeviceStorage.get(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.get("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);
}

Specification

Not part of any specification.

See also