Деградация функциональности при недоступном хранилище

Idb-keyval — это легковесная обёртка над IndexedDB, предоставляющая асинхронный интерфейс для хранения ключ–значение. Библиотека упрощает работу с браузерным хранилищем, освобождая от необходимости писать объёмный код для открытия базы данных, создания транзакций и обработки ошибок. Основные методы включают:

  • set(key, value) — сохраняет значение под указанным ключом. Возвращает Promise.
  • get(key) — получает значение по ключу. Возвращает Promise, который резолвится значением или undefined.
  • del(key) — удаляет значение по ключу.
  • clear() — очищает все записи.
  • keys() — возвращает массив всех ключей.
  • upd ate(key, updater) — позволяет обновить существующее значение через функцию.

Механизм деградации функциональности

В условиях, когда IndexedDB недоступен (например, в режиме инкогнито Safari или при ограничениях политики браузера), Idb-keyval предоставляет возможность мягкой деградации. Основные моменты:

  • Fallback на память: при недоступности IndexedDB библиотека может использовать внутренний объект для хранения данных. Данные в этом случае существуют только во время сессии страницы и теряются после её закрытия.
  • Асинхронность сохраняется: методы продолжают возвращать промисы, что позволяет сохранить совместимость с существующим кодом.
  • Обработка ошибок: любые операции с set, get, del или clear при недоступном хранилище не выбрасывают исключений критического уровня, а резолвятся локальными данными либо undefined.

Практическая реализация fallback

Для реализации корректной деградации используется проверка возможностей IndexedDB при инициализации. Примерная схема работы:

import { createStore, get, se t, del } from 'idb-keyval';

let store;

try {
    store = createStore('my-db', 'keyval-store');
} catch (error) {
    // IndexedDB недоступен — используем память
    const memoryStore = new Map();
    store = {
        get: key => Promise.resolve(memoryStore.get(key)),
        set: (key, value) => { memoryStore.set(key, value); return Promise.resolve(); },
        del: key => { memoryStore.delete(key); return Promise.resolve(); },
        clear: () => { memoryStore.clear(); return Promise.resolve(); },
    };
}

В этом примере код взаимодействует с одним и тем же интерфейсом, вне зависимости от того, доступно IndexedDB или нет. Это минимизирует вероятность ошибок при использовании библиотеки в различных средах.

Влияние на производительность и устойчивость

  • Временная потеря данных: при использовании fallback все изменения теряются после закрытия вкладки. Для кэширования это допустимо, для долгосрочного хранения — критично.
  • Снижение задержек операций: хранение в памяти обеспечивает мгновенный доступ, но не гарантирует долговременную сохранность.
  • Стабильность промисов: сохранение асинхронного интерфейса позволяет обрабатывать результаты одинаково, независимо от доступности IndexedDB.

Ограничения и особенности

  1. Объём данных: fallback в памяти ограничен объёмом оперативной памяти браузера, что делает его непригодным для больших массивов данных.
  2. Конкурентный доступ: при использовании нескольких вкладок IndexedDB синхронизирует данные между ними; fallback в памяти не поддерживает кросс-вкладочную синхронизацию.
  3. Ошибки сериализации: при использовании памяти ограничения сериализации данных не так критичны, но при работе с IndexedDB сложные объекты должны быть корректно сериализуемы.

Рекомендации по использованию

  • Всегда проектировать систему с учётом возможности fallback, особенно для прогрессивных веб-приложений.
  • Для критичных данных предусматривать резервное хранилище на сервере.
  • Проверять доступность IndexedDB при инициализации и логировать состояния, чтобы выявлять среды с ограничениями.

Примеры практического применения

import { get, set } from 'idb-keyval';

async function saveUserSettings(settings) {
    try {
        await set('user-settings', settings);
    } catch (error) {
        console.warn('Хранилище недоступно, настройки будут потеряны после закрытия вкладки.');
    }
}

async function loadUserSettings() {
    const settings = await get('user-settings');
    if (!settings) {
        return { theme: 'light', notifications: true };
    }
    return settings;
}

В этом примере демонстрируется устойчивость приложения к недоступности IndexedDB: операции продолжают работать, а пользователю предоставляются разумные значения по умолчанию при отсутствии сохранённых данных.

Оглавление