--- title: DeviceStorage.get slug: Web/API/DeviceStorage.get tags: - API - B2G - Device Storage - Firefox OS - Method - Non Standard - Non-standard - Não Padrão - Reference - Referencia - WebAPI - metodo translation_of: Archive/B2G_OS/API/DeviceStorage/get ---

{{ non-standard_header() }}

{{ B2GOnlyHeader2('privileged') }}

Sumário

O metodo get é usado para obter um arquivo somente-leitura de uma dada área de armazenamento.

Caso o pedido seja bem-sucedido, o resultado do pedido result é um objeto {{domxref("File")}} contendo os dados do arquivo original do dispositivo.

Sintaxe

var instanciaDeDOMRequest = instanciaDeDeviceStorage.get(nomeDoArquivo);

Parametros

nomeDoArquivo
Uma string representando o nome completo (caminho + nome do arquivo) do arquivo a ser obtido.

Retorno

Retorna um objeto {{domxref("DOMRequest")}} para manipular o sucesso ou o erro da operação.

Exemplo

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

var pedido = sdcard.get("meuArquivo.txt");

pedido.onsuccess = function () {
  var name = this.result.name;
  console.log('O arquivo "' + name + '" foi obtido com sucesso da área de armazenamento do sdcard');
}

request.onerror = function () {
  console.warn('Nao foi possivel obter o arquivo: ' + this.error);
}

Especificação

Não é parte de nenhuma especificação.

Veja também