fileStorage -- Javascript file Storage

$ cordova plugin add cordova-plugin-file
$ cordova plugin add cordova-plugin-console

<!-- cordova -> config.xml -->
<preference name="iosPersistentFileLocation" value="Compatibility" />
<preference name="AndroidPersistentFileLocation" value="Compatibility" />

Demo: https://scriptive.github.io/fileStorage

Download lastest version.

For License information.

TODO

• open() returned [fileContent, fileType, fileSize]
• browse()

file!

• download
• save
• open
• delete
• directory

✨ 🐫 💥

Configuration

var file = fileStorage({
    // Base: 'storage',
    // Base: 'database',
    // RequestQuota: 1073741824,
    Permission: 1,
    objectStore:{
      version:2
    }
  },
  {
    done: function(status) {
      // NOTE: doneCallback!
      // REVIEW: executed either success or fail!
      console.log('init.done');
    },
    fail: function(status) {
      // NOTE: failCallback
      // REVIEW: executed to warn the Browser does not support 'requestFileSystem'!
      console.log('init.fail');
    },
    success: function(fs) {
      // NOTE: successCallback
      // REVIEW: Browser supports 'requestFileSystem'!
      console.warn('init.success');
    }
  }
);

Download

how download work fileStorage().download!

file.download({
  url: 'http://www.example.com/file.xml',
  urlLocal: 'filename.xml',
  // urlLocal===true -> file.xml

  // readAs: 'createObjectURL',
  // readAs: 'readAsText',
  // readAs: 'readAsArrayBuffer',
  // readAs: 'readAsDataURL',
  // readAs: 'readAsBinaryString',

  // requestMethod: 'GET',
  // requestMethod: 'POST',

  // requestCache:false,
  // requestCache:true,
  before: function(xmlHttp){
    // xmlHttp.responseType = "blob";
    // xmlHttp.responseType = "document";
    // xmlHttp.responseType = "json";
    // xmlHttp.responseType = "text";
    // xmlHttp.responseType = 'arraybuffer';
  },
  progress: function(Percentage){
    console.log(Percentage);
  }
}).then(function(e){
  console.log('success');
},function(e){
  console.log('fail');
}).then(function(e){
  console.log('done');
});

Save

how save work fileStorage().save!

file.save({
  urlLocal: 'directory/filename.txt',
  blob: new Blob(['this is plain text'], {type: 'text/plain; charset=utf-8'}),
  // data: 'this is plain text',
  // fileContent: 'this is plain text',
  fileType: 'text/plain'
}).then(function(e){
  console.log('success');
},function(e){
  console.log('fail');
}).then(function(e){
  console.log('done');
});

Open

how open work fileStorage().open!

file.open({
  urlLocal: 'directory/filename.txt',
  readAs: 'createObjectURL'
}).then(function(e){
  console.log('success');
},function(e){
  console.log('fail');
}).then(function(e){
  console.log('done');
});

Delete

how delete work fileStorage().delete!

file.delete({
  urlLocal: 'directory/filename.txt',
  fileNotFound: true // fileNotFound if true return successCallback, even the file is not found!
}).then(function(e){
  console.log('success');
},function(e){
  console.log('fail');
}).then(function(e){
  console.log('done');
});

Download then save

how download then save work fileStorage().download!

file.download({
  url: 'http://www.example.com/file.xml',
  urlLocal: true,
  readAs: 'createObjectURL'
  fileOption:{
    create:true
  },
  before: function(xmlHttp){
    xmlHttp.responseType='blob';
  },
  progress: function(Percentage){
    console.log(Percentage);
  }
}).then(function(e){
  console.log('success');
},function(e){
  console.log('fail');
}).then(function(e){
  console.log('done');
});

Promise

how Promise process in Javascript!

return new Promise(function(resolve, reject) {
    // NOTE: resolve, reject
}).then(function(e) {
    // NOTE: if success
    return e;
}, function(e) {
    // NOTE: if fail
    return e;
}).then(function(e){
    // NOTE: when done
    return e;
});