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: IStorageEngine, options: any) {
    this._strategy = new strategyCls(options);
  }
  get(key: string): any {
    return this._strategy.get(key);
  }
  getJson(key: string): any {
    try {
      return JSON.parse(this._strategy.get(key));
    } catch(e) {
      console.warn('Storage getJson(): unable to parse value for key', key,' as JSON')
      return null;
    }
  }
  set(key: string, value: any) {
    return this._strategy.set(key, value);
  }
  remove(key: string) {
    return this._strategy.remove(key);
  }
  query(query: string, params: any) {
    return this._strategy.query(query, params);
  }
}

export interface IStorageEngine {
  new(options: any): StorageEngine;
}

/**
 * @private
*/
export class StorageEngine {
  constructor(options={}) {
    throw Error("constructor(options={}) not implemented for this storage engine");
  }
  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");
  }
}