---
name: "batchSetStorage"
mode: "kit"
versionRequirements:
  - { name: "BaseKit", version: "3.30.1" }
platform:
  - "iOS"
  - "Android"
async: true
---

## batchSetStorage

> [VERSION] BaseKit >= 3.30.1

> [PLATFORM] iOS, Android

> ⚡ **Supports Promise** — Returns a Promise when success / fail / complete callbacks are omitted.

### Description

Batch store data in the local cache under the specified keys. This overwrites the existing content for those keys. Data remains available unless the user deletes it or the system clears it due to storage constraints. The maximum data size per key is 1 MB, and the total storage limit is 10 MB.

### Parameters

| Property | Type | Required | Default | Since | Description |
| --- | --- | --- | --- | --- | --- |
| `kvList` | `StorageDataBean[]` | Yes | - | `3.30.1` | List of key-value pairs to store |
| `complete` | `() => void` | No | - | - | Completion callback for the API call (runs on both success and failure) |
| `success` | `() => void` | No | - | - | Success callback for the API call |
| `fail` | `(params: Object) => void` ↓see below | No | - | - | Failure callback for the API call |

#### fail callback parameters

| Property | Type | Description |
| --- | --- | --- |
| `errorMsg` | `string` | Error message |
| `errorCode` | `string \| number` | Error code |
| `innerError` | `Object` | Error extension |

##### fail(params).innerError properties

| Property | Type | Description |
| --- | --- | --- |
| `errorCode` | `string \| number` | Extended error code |
| `errorMsg` | `string` | Extended error information |


### Referenced Types

##### `interface` StorageDataBean

| Property | Type | Required | Since | Description |
| --- | --- | --- | --- | --- |
| `key` | `string` | Yes | `2.0.1` | Specified key in local storage |
| `data` | `string` | Yes | `2.0.1` | Value for the key |


### Examples

```tsx
// Batch write to local storage (kvList is a key-value list)
ty.batchSetStorage({
  kvList: [
    { key: "k1", data: "v1" },
    { key: "k2", data: "v2" },
  ],
  success: () => console.log("Batch write completed"),
  fail: error => console.error(error),
});
```