Что такое…

Что такое IndexedDB — база данных в браузере на 60% твоего диска

Иллюстрация: коробка из-под обуви рядом со складским стеллажом

Вот число, которое многих удивляет. localStorage — это 5 мегабайт. Одна фотография с телефона туда не влезет.

А IndexedDB в том же самом браузере, для того же самого сайта — это до 60% твоего диска. На терабайтном ноутбуке это шестьсот гигабайт. Разница между двумя хранилищами внутри одной вкладки — примерно в сто тысяч раз.

Что такое IndexedDB простыми словами

IndexedDB — это база данных внутри браузера, на устройстве пользователя. Сервер о ней ничего не знает и ничего в неё не отправляет.

Три отличия от привычного localStorage:

  • Хранит объекты, а не строки. Массивы, вложенные структуры, даты, файлы и картинки целиком — без превращения в текст.
  • Умеет индексы. Отсюда и название: можно искать «все записи с датой позже вчерашней», не перебирая всё подряд.
  • Работает асинхронно. localStorage при обращении подвешивает страницу; IndexedDB — нет. На больших объёмах это разница между «интерфейс живой» и «вкладка залипла».

Платишь за это неудобным старым API — с запросами, событиями и транзакциями. Поэтому почти все берут обёртку (idb, Dexie) и пишут в три строки вместо тридцати.

5 мегабайт против 60 процентов диска

Ограничения тут устроены хитро. Есть Web Storage — это localStorage и sessionStorage, у которых жёсткий потолок: по 5 МиБ на источник, максимум 10 МиБ суммарно во всех браузерах. Превысил — получил исключение QuotaExceededError.

А есть вторая группа: IndexedDB, Cache API и файловая система источника. У них общий менеджер квот, и цифры совсем другие:

  • Chrome, Edge и другие на Chromium — до 60% размера диска на один источник. Диск 1 ТиБ — потолок около 600 ГиБ.
  • Firefox — меньшее из двух: 10% диска или 10 ГиБ группового лимита. Если сайт попросил постоянное хранилище — до 50% диска, максимум 8 ТиБ.
  • Safari (начиная с macOS 14 и iOS 17) — тоже около 60% диска для самого браузера. Но если твой сайт открыт внутри чужого приложения, во встроенном веб-вью, лимит падает до ~15%.

Одна тонкость, которая ломает интуицию: квота считается от полного размера диска, а не от свободного места. Сделано это против отпечатков — чтобы сайт не вычислял пользователя по остатку памяти. Практический вывод: браузер может пообещать тебе 600 гигабайт на диске, где свободно два. Обещание — не гарантия.

Когда браузер всё это удалит

А теперь неприятная часть, про которую забывают чаще всего. По умолчанию данные хранятся в режиме best-effort — «постараемся сохранить». Три сценария, в которых их сотрут:

  1. Кончается место на устройстве. Браузер удаляет данные источника, к которому дольше всего не заходили, потом следующего — пока не разгребёт.
  2. Safari и защита от слежки. Если в течение семи дней использования браузера пользователь ни разу не кликнул и не тапнул на твоём сайте, всё, что записали скрипты, удаляется. Куки, поставленные сервером, под это не попадают.
  3. Приватный режим. Там свои квоты, и данные обычно стираются, как только окно закрыли.

И главное: удаляется всё сразу, а не по кусочкам. Если ты хранил что-то в IndexedDB и что-то в Cache API — уедет и то, и другое. Наполовину удалённое хранилище хуже пустого, поэтому браузер так не делает.

Хочешь надёжнее — попроси постоянное хранилище: navigator.storage.persist(). Firefox спросит разрешения у пользователя, Chrome и Safari решат молча, по истории его взаимодействия с сайтом. Такие данные из-под вытеснения выводятся — удалит их только сам пользователь через настройки.

Утешение от команды Chrome: по их исследованиям браузер удаляет данные очень редко. Если человек заходит на сайт регулярно, шанс потерять даже best-effort почти нулевой. Но «почти» здесь — рабочее слово: единственная копия важных данных в браузере жить не должна.

Как посмотреть свою квоту прямо сейчас

Открой консоль на любом сайте и выполни:

const q = await navigator.storage.estimate();
console.log(q.quota, q.usage); // потолок и текущий расход, в байтах

Первое число — сколько браузер готов дать этому источнику, второе — сколько уже занято IndexedDB, Cache API и соседями. Скорее всего, ты увидишь десятки гигабайт и удивишься.

Проверить постоянное хранилище — await navigator.storage.persisted(), запросить — await navigator.storage.persist().

Зачем всё это, если есть сервер

Затем, что за последние пару лет в браузер переехали тяжёлые вещи. Веса модели для запуска ИИ прямо во вкладке — это сотни мегабайт, и качать их при каждом открытии странице никто не даст. Их кладут в браузерное хранилище один раз.

Оффлайн-редакторы, почтовые клиенты, заметки — все они держат данные локально и синхронизируются, когда есть сеть. Даже обычное кэширование картинок и ответов API живёт в этой же квоте.

IndexedDB — это SQL?

Нет. Это хранилище объектов «ключ → значение» с индексами, без языка запросов. Привычные SELECT и JOIN тут не работают: ты берёшь объекты по ключу или по диапазону значений индекса, а фильтруешь уже в коде.

Когда брать localStorage, а когда IndexedDB?

Настройки, тема, флажок «согласен» — localStorage, там строки и их мало. Всё, что больше пары мегабайт, содержит файлы или требует поиска, — IndexedDB. Промежуточного варианта нет: 5 мегабайт кончаются внезапно.

Пользователь может очистить эти данные?

Да, в любой момент — «очистить данные сайта» в настройках браузера стирает всё, включая постоянное хранилище. Поэтому браузер годится как кэш, копия и оффлайн-слой, но не как единственное место, где живут важные данные.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →