データストレージ

Ionicアプリ内にデータを保存するためのさまざまなオプションを用意しています。

Ionicオフラインストレージ

Ionic Offline Storage is a cross-platform data storage system that works on iOS and Android. It makes it easy to add offline storage to Ionic apps that is secure (encrypted on device), highly performant, and provides advanced NoSQL data querying.

Created for teams building complex, data-driven apps, apps managing sensitive data, or apps used in areas with unreliable cell service/internet connections. Interested? Start here.

Ionic Storage

Ionic Storageは無料で使える、独立系の開発者や学生、ホビイスト向けのオープンソースです。 キー/値ペアとJSONオブジェクトを保存する簡単な方法を提供します。

さまざまなストレージエンジンを使用し、プラットフォームに応じて 最適なものを選択します。

• ネイティブアプリのコンテキストで実行する場合、StorageはSQLiteを優先的に使用します。 これは、SQLiteが最も安定し、広く使用されているファイルベースのデータベースの1つであり、 OSがそのようなものを排除することを決定するようなlocalstorageやIndexedDBのような いくつかの落とし穴を避けるためです。
• WebまたはProgressive Web Appとして実行されている場合、StorageはIndexedDB、WebSQL、 およびlocalstorageをこの順序で使用しようとします。

Usage

もしSQLiteを使いたいときは、まずcordova-sqlite-storage プラグインをインストールします:

ionic cordova plugin add cordova-sqlite-storage

次に、パッケージをインストールします:

npm install --save @ionic/storage

そして、以下をあなたの NgModule デコレーションに追加します（例えば、 src/app/app.module.ts に追記ください）:

import { IonicStorageModule } from '@ionic/storage';

@NgModule({
  declarations: [
    // ...
  ],
  imports: [
    BrowserModule,
    IonicModule.forRoot(MyApp),
    IonicStorageModule.forRoot()
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    // ...
  ],
  providers: [
    // ...
  ]
})
export class AppModule {}

最後に、あなたのComponentsやpageに注入します:

import { Storage } from '@ionic/storage';

export class MyApp {
  constructor(private storage: Storage) { }

  ...

  // set a key/value
  storage.set('name', 'Max');

  // Or to get a key/value pair
  storage.get('age').then((val) => {
    console.log('Your age is', val);
  });
}

Storage の設定

Storageエンジンは、特定のストレージエンジンの優先順位、 localForageに渡す任意の設定の両方で構成されます。 localForageの設定ドキュメントについては、こちらをご覧ください: https://github.com/localForage/localForage#configuration

Note: どのカスタム設定も、デフォルト設定とマージされます。

import { IonicStorageModule } from '@ionic/storage';

@NgModule({
  declarations: [...],
  imports: [
    IonicStorageModule.forRoot({
      name: '__mydb',
driverOrder: ['indexeddb', 'sqlite', 'websql']
    })
  ],
  bootstrap: [...],
  entryComponents: [...],
   providers: [...]
})
export class AppModule { }

Instance Members

constructor

LocalForageに渡すドライバの順序とその他の設定オプションを使用して、 新しいStorageインスタンスを作成します。

利用可能なドライバオプション: ['sqlite', 'indexeddb', 'websql', 'localstorage'] そして、これはデフォルトの優先順です。

driver

使用されているドライバの名前を取得します。

clear()

保存されているすべてのデータを削除します。 WARNING: HOT!

Returns: Returns a promise that resolves when the store is cleared

forEach()

key, valueの値を順に取得します。

Returns: Returns a promise that resolves when the iteration has finished.

Parameters

iteratorCallback

a callback of the form (value, key, iterationNumber)

get()

keyを引数にいれることによって、valueを取得します。

Returns: Returns a promise with the value of the given key

Parameters

key

Type: string

the key to identify this value

keys()

Returns: Returns a promise that resolves with the keys in the store.

length()

Returns: Returns a promise that resolves with the number of keys stored.

ready()

storeが利用可能になったことを反映します。

Returns: Returns a promise that resolves when the store is ready

remove()

keyを引数にわたすことで、valueを削除します。

Returns: Returns a promise that resolves when the value is removed

Parameters

key

Type: string

the key to identify this value

set()

keyを引数にわたすことでvalueを保存します。

Returns: Returns a promise that resolves when the key and value are set

Parameters

key

Type: string

the key to identify this value

value

Type: any

the value for this key