Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

DeviceStorage.get()

This article needs a technical review. How you can help.

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

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, fscholz, kscarfone, Jeremie
 Last updated by: chrisdavidmills,