1.0.9 • Published 4 years ago

@uni/storage v1.0.9

Weekly downloads
100
License
BSD-3-Clause
Repository
github
Last release
4 years ago

storage

npm

Stores data in the specified key in the local cache. This operation will overwrite the original content of the key. The data storage lifecycle is consistent with the Mini Program, that is, data is always available unless manually deleted by the user or automatically deleted after a certain period of time.

The maximum size of data stored in a single key is 1 MB, and the total size for data storage is limited to 10 MB.

Install

$ npm install @uni/storage --save

or

$ npm install @uni/apis --save

Usage

import {setStorage} from '@uni/storage';

setStorage({
  key: 'key',
  data: {
    value: 'value'
  },
  success: (res) => {
    console.log('success', res);
  },
  fail: (res) => {
    console.log('fail', res);
  },
  complete: (res) => {
    console.log('complete', res);
  }
});

// promise
setStorage({
  key: "key",
  data: {
    value: 'value'
  }
}).then(response => {})
  .catch(error => {})
  .finally(res => {});

Methods

setStorage(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-
options.dataobject Contents to be stored can only be native types, dates, and objects that can be serialized via JSON.stringify.✔️-
options.successFunction The callback function for a successful API call-
options.failFunction The callback function for a failed API call-
options.completeFunction The callback function used when the API call completed (always executed whether the call succeeds or fails)-

setStorageSync

npm

Stores data in the specified key in the local cache. This operation will overwrite the original content of the key. The data storage lifecycle is consistent with the Mini Program, that is, data is always available unless manually deleted by the user or automatically deleted after a certain period of time.

The maximum size of data stored in a single key is 1 MB, and the total size for data storage is limited to 10 MB.

Install

$ npm install @uni/setStorageSync --save

or

$ npm install @uni/apis --save

Usage

import setStorageSync from '@uni/setStorageSync';

setStorageSync({
  key: 'key',
  data: {
    value: 'value'
  }
});

Methods

setStorageSync(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-
options.dataobject Contents to be stored can only be native types, dates, and objects that can be serialized via JSON.stringify.✔️-

getStorage

npm

Asynchronously gets the content of the specified key from the local cache.

Install

$ npm install @uni/getStorage --save

or

$ npm install @uni/apis --save

Usage

import getStorage from '@uni/getStorage';

getStorage({
  key: 'key',
  success: (res) => {
    console.log('success', res);
  },
  fail: (res) => {
    console.log('fail', res);
  },
  complete: (res) => {
    console.log('complete', res);
  }
});

// promise
getStorage({
  key: "key"
}).then(response => {})
  .catch(error => {})
  .finally(res => {});

Methods

getStorage(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-
options.successFunction The callback function for a successful API call-
options.failFunction The callback function for a failed API call-
options.completeFunction The callback function used when the API call completed (always executed whether the call succeeds or fails)-

Return

PropertyTypeDescription
dataany Content of the key

getStorageSync

npm

Gets the content of the specified key from the local cache.

Install

$ npm install @uni/getStorageSync --save

or

$ npm install @uni/apis --save

Usage

import getStorageSync from '@uni/getStorageSync';

let res = getStorageSync({
  key: 'key'
});

Methods

getStorageSync(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-

Return

PropertyTypeDescription
dataany Content of the key

removeStorage

npm

Asynchronously removes the specified key from the local cache.

Install

$ npm install @uni/removeStorage --save

or

$ npm install @uni/apis --save

Usage

import removeStorage from '@uni/removeStorage';

removeStorage({
  key: 'key',
  success: (res) => {
    console.log('success', res);
  },
  fail: (res) => {
    console.log('fail', res);
  },
  complete: (res) => {
    console.log('complete', res);
  }
});

// promise
removeStorage({
  key: "key"
}).then(response => {})
  .catch(error => {})
  .finally(res => {});

Methods

removeStorage(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-
options.successFunction The callback function for a successful API call-
options.failFunction The callback function for a failed API call-
options.completeFunction The callback function used when the API call completed (always executed whether the call succeeds or fails)-

removeStorageSync

npm

Removes the specified key from the local cache.

Install

$ npm install @uni/removeStorageSync --save

or

$ npm install @uni/apis --save

Usage

import removeStorageSync from '@uni/removeStorageSync';

removeStorageSync({
  key: 'key'
});

Methods

removeStorageSync(options)

Supported

Arguments

PropertyTypeDescriptionrequiredDefault
optionsobject ✔️-
options.keystring The specified key in the local cache✔️-