# Годі використовувати React Native Async Storage

By Tarik Pinarci (https://tarikpinarci.com). Published 2023-02-10. Canonical: https://tarikpinarci.com/uk/blog/stop-using-react-native-async-storage

## Порівняння React Native MMKV і React Native Async Storage

Доволі довго React Native Async Storage був стандартним вибором для зберігання даних у застосунках на React Native. Проте поява React-Native MMKV дає розробникам ефективнішу і досконалішу альтернативу.

MMKV спочатку створили як ефективний, компактний і зручний фреймворк для зберігання пар ключ-значення на мобільних пристроях для застосунку WeChat.

Він переносить свої швидкі прямі прив'язки до нативної бібліотеки на C++ на платформу React Native через простий JavaScript API. Сьогодні React-Native MMKV помітний варіант для зберігання даних у застосунках на React Native. Одна з ключових переваг React-Native MMKV це продуктивність. Оскільки все написано на C++, **_він приблизно в 30 разів швидший за AsyncStorage_**. Крім того, він підтримує шифрування, тож це безпечне сховище для вашого застосунку. Використання JSI замість «старого» Bridge ще більше підвищує швидкість і ефективність.

### Бенчмарк

[**_MMKV проти інших бібліотек сховища: читання значення зі сховища 1000 разів.
Виміряно в мілісекундах на iPhone 11 Pro, менше означає краще._**](https://github.com/mrousavy/react-native-mmkv#benchmark)

![[https://github.com/mrousavy/react-native-mmkv#benchmark](https://github.com/mrousavy/react-native-mmkv#benchmark)](https://cdn-images-1.medium.com/max/2000/1*v6sX7AfLoqGWl6nK6XoneA.png)_[https://github.com/mrousavy/react-native-mmkv#benchmark](https://github.com/mrousavy/react-native-mmkv#benchmark)_

### **Без async/await**

React-Native MMKV також пропонує повністю синхронні виклики, тож ним легко користуватися без async/await чи Promises. На відміну від нього, AsyncStorage потребує асинхронної поведінки. З react-native-mmkv можна легко зберігати й отримувати дані через прості getters і setters. Подивімося, як ініціалізувати сховище за допомогою react-native-mmkv:

```tsx
import { MMKV } from "react-native-mmkv";

export const appStorage = new MMKV({
  id: "my-app-storage",
});
```

Отримувати дані зі сховища так само просто, як показано нижче:

```tsx
// set a new key/value pair using react-native-mmkv
appStorage.set("username", "John");
const username = appStorage.getString("username");

// below is how you would do using react-native-async-storage
await AsyncStorage.setItem("username", "John");
const username = await AsyncStorage.getItem("username");
```

React-Native MMKV також підтримує зберігання об'єктів, тож складні структури даних зберігати легко. Це показано в коді нижче:

```tsx
// Objects

// using react-native-mmkv

const user = {
  username: "John",
  role: "Admin",
};

appStorage.set("user", JSON.stringify(user));

const jsonUser = appStorage.getString("user");
const userObject = JSON.parse(jsonUser);

// using react-native-async-storage

await AsyncStorage.setItem("user", JSON.stringify(user));
const jsonUser = await AsyncStorage.getItem("user");
const userObject = JSON.parse(jsonUser);
```

Видаляти елементи зі сховища так само легко, як показано нижче:

```tsx
// to remove specific item from the storage in mmkv
appStorage.delete("username");

// below is how you would do using react-native-async-storage
await AsyncStorage.removeItem("username");
```

### Приклад із реального життя: middleware persist у Zustand і React Native MMKV

React-Native MMKV вміє інтегруватися з популярними бібліотеками керування станом, як-от jotai, redux-persist, mobx-persist і zustand-persist-middleware. Це дозволяє розробникам поєднати ефективне, швидке і зручне сховище MMKV з уже наявними рішеннями для керування станом. У результаті керування станом стає плавним і простим, а зберігати дані застосунку розробникам легше.

```tsx
import { Appearance } from "react-native";
import { MMKV } from "react-native-mmkv";
import create from "zustand";
import { persist, StateStorage } from "zustand/middleware";

type AppPersistStore = {
  isDarkTheme: boolean;
  setIsDarkTheme: (preference: boolean) => void;
};

export const appPersistStorage = new MMKV({ id: "app-persist-storage" });

const zustandMMKVStorage: StateStorage = {
  setItem: (name, value) => {
    return appPersistStorage.set(name, value);
  },
  getItem: (name) => {
    const value = appPersistStorage.getString(name);
    return value ?? null;
  },
  removeItem: (name) => {
    return appPersistStorage.delete(name);
  },
};

export const useAppPersistStore = create<
  AppPersistStore,
  [["zustand/persist", AppPersistStore]]
>(
  persist(
    (set, get) => ({
      isDarkTheme: Appearance.getColorScheme() === "dark",
      setIsDarkTheme: (preference) => set({ isDarkTheme: preference }),
    }),
    {
      name: "app-persist-storage",
      getStorage: () => zustandMMKVStorage,
      serialize: (state) => JSON.stringify(state),
      deserialize: (state) => JSON.parse(state),
    }
  )
);
```

Фрагмент коду вище показує, як використати zustand-persist-middleware разом із react-native-mmkv для світлої і темної теми застосунку. Поєднання цих двох бібліотек дозволяє зберігати стан застосунку навіть після того, як його закрили або перезапустили.

Ми оголошуємо власний тип AppPersistStore, який містить інформацію про вибрану тему застосунку і метод, щоб цей вибір змінити.

Далі створюємо екземпляр MMKV, який зберігатиме стан застосунку. Екземпляр лежить у константі appPersistStorage.

Потім створюємо об'єкт zustandMMKVStorage, що реалізує інтерфейс StateStorage. Цей об'єкт надає набір методів для роботи з екземпляром appPersistStorage, наприклад для запису й читання значень.

Нарешті, функцією create з бібліотеки zustand ми створюємо hook useAppPersistStore, який повертає поточну вибрану тему застосунку і метод для її зміни. Middleware persist гарантує, що стан застосунку автоматично зберігається в екземпляр appPersistStorage щоразу, коли він змінюється.

Хоч яку дію з цього store ми викличемо, її результат буде збережено. Тобто навіть якщо застосунок закриють або перезапустять, його стан лишиться таким самим, як під час останнього використання. Це дає користувачеві стабільний досвід незалежно від того, коли і як він користується застосунком.

Ось як ми зрештою використовуватимемо цей hook:

```tsx
import * as React from "react";
import { Button } from "react-native";
import { useAppPersistStore } from "./app-persist";

const Home: React.FC = () => {
  // here we have our mmkv and zustand persist-middleware hook that we have initialized previously
  const { isDarkTheme, setIsDarkTheme } = useAppPersistStore();

  return (
    <Button
      onPress={() => setIsDarkTheme(!isDarkTheme)}
      title={isDarkTheme ? "Dark Theme" : "Light theme"}
    />
  );
};

export default Home;
```

### Listeners у react-native-mmkv

Можна скористатися listeners у React Native MMKV, щоб відстежувати зміни у сховищі. Це корисно, коли треба виконувати певні дії щоразу, як змінюється конкретне значення.

Ось приклад використання listener у застосунку на React Native:

```tsx
import * as React from "react";
import { Button } from "react-native";
import { MMKV } from "react-native-mmkv";

const storage = new MMKV({ id: "theme-preference" });

const Home: React.FC = () => {
  const [isDarkTheme, setIsDarkTheme] = React.useState(false);

  React.useEffect(() => {
    const listener = storage.addOnValueChangedListener((changedKey) => {
      const newValue = storage.getString(changedKey);

      if (changedKey === "isDarkTheme") {
        // update the theme in the app based on the updated value in the storage
        console.log(`New theme preference: ${newValue}`);
      }
    });

    return () => {
      listener.remove();
    };
  }, []);

  const toggleTheme = () => {
    const newPreference = !isDarkTheme;
    setIsDarkTheme(newPreference);
    storage.set("isDarkTheme", JSON.stringify(newPreference));
  };

  return (
    <Button
      onPress={toggleTheme}
      title={isDarkTheme ? "Dark Theme" : "Light Theme"}
    />
  );
};
```

У цьому прикладі ми створили сховище MMKV з ID theme-preference і додали до нього listener за допомогою методу `addOnValueChangedListener`. Listener стежить за змінами у сховищі й відповідно оновлює тему застосунку.

> Приклад вище мав показати, як використовувати listeners у React Native MMKV з мінімальною кількістю коду, а не бути змістовним прикладом. У фрагменті коду listener стежить за змінами у сховищі й виводить у лог нові значення ключа, що змінився.

### Використання з Expo

[React native mmkv справді сумісний з expo](https://github.com/mrousavy/react-native-mmkv#expo), але оскільки він побудований на нативних модулях, у звичайному застосунку на expo (де немає згенерованого нативного коду) він одразу не запрацює. Нам потрібно згенерувати нативний код, тобто скористатися можливістю [**_prebuild_**](https://docs.expo.dev/workflow/prebuild/) в expo.

---

### Висновок

Як розробник на React Native, я щиро раджу React Native MMKV як сховище для застосунків на React Native. Бібліотека має документацію про інтеграцію з іншими популярними бібліотеками керування станом, як-от jotai, redux-persist, mobx-persist і zustand-persist-middleware, тож її легко додати в будь-який проєкт.

Порівняно з React Native Async Storage, React Native MMKV має кілька дуже важливих переваг: високу продуктивність, підтримку шифрування і зручний API. Повністю синхронні виклики без потреби в async/await чи Promises роблять його швидшим і ефективнішим вибором.

Тож якщо ви шукаєте надійне і безпечне сховище для свого застосунку на React Native, раджу придивитися до React Native MMKV.

### Ресурси

- [https://github.com/mrousavy/react-native-mmkv](https://github.com/mrousavy/react-native-mmkv)

- [https://react-native-async-storage.github.io/async-storage/](https://react-native-async-storage.github.io/async-storage/)

### Де ще опубліковано

Ця стаття також опублікована на:

- [Medium](https://medium.com/gitconnected/stop-using-react-native-async-storage-fdbcc05a6de3)

