ionic-framework/ionic/platform/storage/storage.ts

/**
 * Storage is an easy way to store key/value pairs and other complicated
 * data in a way that uses a variety of storage engines underneath.
 *
 * For most cases, we recommend the SqlStorage system as it will store
 * data in a file in the app's sandbox. LocalStorage should ONLY be used
 * for temporary data as it may be "cleaned up" by the operation system
 * during low disk space situations.
 */
/**
 * @private
*/
export class Storage {
  private _strategy: any;

  constructor(strategyCls: any, options) {
    this._strategy = new strategyCls(options);
  }
  get(key) {
    return this._strategy.get(key);
  }
  getJson(key) {
    return this.get(key).then(value => {
      try {
        return JSON.parse(value);
      } catch (e) {
        console.warn('Storage getJson(): unable to parse value for key', key, ' as JSON');
        throw e; // rethrowing exception so it can be handled with .catch()
      }
    });
  }
  set(key, value) {
    return this._strategy.set(key, value);
  }
  remove(key) {
    return this._strategy.remove(key);
  }
  query(query, params) {
    return this._strategy.query(query, params);
  }
}

/**
 * @private
*/
export class StorageEngine {
  get(key, value) {
    throw Error("get() not implemented for this storage engine");
  }
  set(key, value) {
    throw Error("set() not implemented for this storage engine");
  }
  remove(key) {
    throw Error("remove() not implemented for this storage engine");
  }
  query(query, params) {
    throw Error("query() not implemented for this storage engine");
  }
}