Что такое localStorage и как хранить в нем изображения

localStorage – это браузерное хранилище строковых пар «ключ – значение». Чтобы сохранить в нем изображение, преобразуйте файл в строку data URL. Метод setItem запишет строку, а getItem вернет ее для показа. Такой способ подходит для небольших миниатюр.

Пример позволяет загрузить картинку, уменьшить ее через canvas и удалить запись. Сжатие сокращает строку, но не гарантирует наличие свободного места. Обработчик ошибок сообщит, если браузер запретит запись или закончится место.

Что такое localStorage и подходит ли он для картинок

localStorage – это браузерное хранилище строковых пар «ключ – значение». Оно входит в Web Storage API. Данные сохраняются между обычными сеансами браузера, пока пользователь их не удалит.

Браузер разделяет записи по origin: сочетанию протокола, имени хоста и порта. Например, HTTP и HTTPS одного домена получают разные хранилища.

Каталоги внутри одного origin используют общее хранилище.

localStorage не принимает файл как бинарное значение. Поэтому пример преобразует содержимое картинки в data URL: строку с типом содержимого и закодированными данными. Эту строку можно присвоить свойству src элемента изображения.

МеханизмСрок храненияОтправка серверу
localStorageМежду обычными сеансами, до удаления данныхБраузер автоматически не отправляет записи
sessionStorageВ пределах сеанса вкладкиБраузер автоматически не отправляет записи
CookieЗависит от срока действияБраузер прикладывает подходящие cookie к HTTP-запросам

Не используйте localStorage как единственную копию важного изображения. Очистка данных сайта удалит сохраненные картинки. Скрипты страницы также имеют доступ к записям своего origin.

Ограничения localStorage при хранении изображений

Квота ограничивает общий объем записей origin, включая другие ключи приложения. Размер выбранного файла сам по себе не гарантирует свободного места.

localStorage не предоставляет метода для получения точного остатка своей квоты.

Проверяйте возможность сохранить конкретную строку вызовом setItem внутри try/catch. Успешный вызов означает, что запись поместилась. Если браузер выбросил QuotaExceededError, уменьшите изображение или удалите ненужные картинки.

  • Base64 увеличивает объем бинарных данных примерно на треть. Каждые 3 байта превращаются в 4 символа, дополнительно появляются заголовок data URL и заполнение.
  • localStorage хранит строки в формате UTF-16. Длина строки JavaScript измеряет кодовые единицы, а не размер исходного файла.
  • Синхронные getItem и setItem занимают основной поток. Большие записи могут задерживать обработку нажатий и отрисовку страницы.
  • В приватных окнах срок жизни данных и доступное место могут отличаться. Не рассчитывайте сохранить картинки после завершения приватного сеанса.
  • Настройки приватности могут запретить доступ к хранилищу. Поэтому обработка ошибок нужна также при чтении и удалении.

Выбирайте localStorage для аватарки или нескольких небольших миниатюр. Галерею исходных фотографий храните в IndexedDB. Механизмы учета места описывает документация MDN о квотах и удалении данных.

Не заполняйте рабочее хранилище тестовыми строками ради поиска предела: такой тест отнимает место у приложения.

Разметка и стили демо-страницы

Создайте файл index.html. Добавьте поле выбора файла, переключатель сжатия и две кнопки. Сообщения выводите отдельно от контейнера изображений.

<style>
  body { max-width: 900px; margin: 24px auto; padding: 16px; font-family: sans-serif; }
  #preview { display: flex; flex-wrap: wrap; gap: 16px; }
  figure { margin: 0; max-width: 240px; overflow-wrap: anywhere; }
  img { display: block; max-width: 100%; max-height: 220px; }
  button, input { margin: 8px 0; }
</style>
<label for="file">Выберите изображение</label>
<input id="file" type="file" accept="image/*">
<label><input id="compress" type="checkbox" checked> Уменьшить до JPEG</label>
<button id="show" type="button">Показать</button>
<button id="clear" type="button">Очистить все</button>
<p id="status" role="status"></p>
<pre id="stats"></pre>
<div id="preview"></div>

Атрибут accept ограничивает выбор в диалоге, но не проверяет содержимое. JavaScript дополнительно проверит MIME-тип, размер и возможность декодировать изображение.

Переключатель сжатия включен по умолчанию.

Как сохранить изображение: FileReader и setItem

Метод FileReader.readAsDataURL() читает выбранный файл асинхронно. Событие load сообщает о завершении чтения. Свойство reader.result содержит полученную строку, но ничего не говорит о доступности localStorage.

Перед чтением отклоните неподходящий файл. В примере предел входного файла составляет 8 МиБ. Это ограничение демо, которое защищает страницу от чтения слишком больших файлов.

if (!file.type.startsWith('image/')) {
  throw new Error('Выберите файл изображения.');
}
if (file.size > MAX_FILE_BYTES) {
  throw new Error('Файл больше 8 МиБ. Выберите изображение меньше.');
}

Предел 8 МиБ относится к входному файлу, а не к квоте localStorage.

Ключ img: плюс имя файла отделяет картинки от других записей. Повторная загрузка файла с тем же именем заменяет прежнюю картинку. Два разных файла avatar.png также попадут в одну запись.

const key = PREFIX + file.name;
try {
  localStorage.setItem(key, dataUrl);
} catch (error) {
  reportError(error);
  return;
}

При переполнении браузер выбрасывает исключение DOMException с именем QuotaExceededError. Проверяйте имя ошибки, не привязывайте обработчик к числовому коду. Другие исключения нельзя выдавать за нехватку места: доступ может блокировать политика браузера.

Если приложение должно хранить одноименные файлы отдельно, добавьте уникальный идентификатор. Имя файла тогда храните отдельным полем вместе с data URL.

Как показать сохраненные изображения

Свойство localStorage.length возвращает количество всех записей origin. Метод key(i) возвращает ключ по индексу. Фильтр startsWith('img:') оставляет только изображения нашего примера.

const keys = [];
for (let i = 0; i < localStorage.length; i++) {
  const key = localStorage.key(i);
  if (key?.startsWith(PREFIX)) keys.push(key);
}

Перед каждой отрисовкой вызывайте preview.replaceChildren(). Этот метод очищает контейнер, поэтому повторное нажатие «Показать» не создает дублей.

Создавайте карточки через document.createElement и new Image(). Присваивайте подпись через textContent, а адрес картинки через src.

Запишите ключ в data-key карточки: нескольким элементам нельзя назначать одинаковый id.

Пример выводит только data URL с префиксом изображения. Такая проверка отсекает посторонние строки, но не заменяет защиту сайта от XSS.

Как удалить изображение или очистить хранилище

Каждая карточка получает собственную кнопку «Удалить». Обработчик замыкает ключ записи и ссылку на карточку. Сначала он удаляет данные, затем убирает элемент со страницы.

const button = document.createElement('button');
button.type = 'button';
button.textContent = 'Удалить';
button.addEventListener('click', () => {
  try {
    localStorage.removeItem(key);
    card.remove();
    status.textContent = 'Изображение удалено.';
  } catch (error) {
    reportError(error);
  }
});
card.append(button);

Кнопка «Очистить все» сначала собирает ключи с префиксом img:. Затем обработчик удаляет каждую запись через removeItem. Готовый список предотвращает пропуск ключей при изменении индексов хранилища.

localStorage.clear() удаляет все записи origin.

Вместе с картинками исчезнут настройки и другие данные сайта. Для очистки демо используйте только его префикс.

Чтобы вернуть удаленную картинку, выберите исходный файл повторно.

Как уменьшить картинку перед сохранением

Загрузите data URL в Image и дождитесь декодирования. Затем нарисуйте изображение на canvas, сохранив пропорции. Пример ограничивает ширину до 800 пикселей и не увеличивает маленькие картинки.

const scale = Math.min(1, 800 / image.naturalWidth);
canvas.width = Math.max(1, Math.round(image.naturalWidth * scale));
canvas.height = Math.max(1, Math.round(image.naturalHeight * scale));
context.fillStyle = '#fff';
context.fillRect(0, 0, canvas.width, canvas.height);
context.drawImage(image, 0, 0, canvas.width, canvas.height);
const compressed = canvas.toDataURL('image/jpeg', 0.75);

Метод canvas.toDataURL() возвращает новую строку. Параметр 0,75 задает качество JPEG, но не процент уменьшения. Белая заливка заменяет прозрачный фон, поскольку JPEG не сохраняет прозрачность.

Canvas также позволяет запросить image/webp. Проверяйте начало возвращенной строки: при неподдерживаемом формате браузер использует PNG. В готовом примере выбран JPEG.

Сжатие может увеличить уже оптимизированный файл.

Поэтому код сохраняет короткую из двух строк: исходную или перекодированную. Преобразование через canvas теряет анимацию и может изменить вид изображения.

После выбора файла демо выводит байты файла и длины строк. Для воспроизводимого примера откройте готовую демо-страницу и выполните код в Console. Он создаст PNG с градиентом и передаст файл обработчику загрузки.

async function measureDemoImage() {
  const canvas = document.createElement('canvas');
  canvas.width = 2400;
  canvas.height = 1600;
  const context = canvas.getContext('2d');
  if (!context) throw new Error('Canvas недоступен.');
  const gradient = context.createLinearGradient(0, 0, 2400, 1600);
  gradient.addColorStop(0, '#204080');
  gradient.addColorStop(1, '#ffd080');
  context.fillStyle = gradient;
  context.fillRect(0, 0, canvas.width, canvas.height);
  const blob = await new Promise(resolve => canvas.toBlob(resolve, 'image/png'));
  if (!blob) throw new Error('Не удалось создать PNG.');
  const transfer = new DataTransfer();
  transfer.items.add(new File([blob], 'compression-demo.png', { type: 'image/png' }));
  document.querySelector('#compress').checked = true;
  const field = document.querySelector('#file');
  if (field.disabled) throw new Error('Дождитесь завершения текущей загрузки.');
  field.files = transfer.files;
  field.dispatchEvent(new Event('change', { bubbles: true }));
}
measureDemoImage().catch(console.error);

Страница покажет цепочку «файл в байтах → исходный data URL → JPEG data URL → строка для записи». Числа зависят от кодировщика браузера, поэтому код выводит их при запуске. Если запись не поместится, показатели останутся видны вместе с сообщением об ошибке.

В этом примере ширина уменьшается с 2400 до 800 пикселей.

Уменьшение обеих сторон в 3 раза сокращает число пикселей в 9 раз. JPEG дополнительно сжимает содержимое, а base64 увеличивает размер закодированных данных. Длина итоговой строки зависит от всех этих преобразований.

Даже уменьшенная картинка может не поместиться в занятое хранилище.

В таком случае удалите ненужные записи кнопками демо и повторите загрузку. Для дальнейшего сжатия измените в makeJpeg ширину 800 на 400, а качество 0.75 на 0.6. Сохраните файл, перезагрузите страницу и выберите изображение повторно.

Сравните новую длину JPEG и читаемость самой картинки. Если качество уже неприемлемо, используйте IndexedDB вместо дальнейшего уменьшения.

Как проверить, что картинки сохранились

Откройте DevTools сочетанием Ctrl+Shift+I в Windows или Linux. На macOS используйте Command+Option+I. В Chrome выберите Application → Local Storage → origin страницы.

В Firefox откройте Storage → Local Storage → origin. В русской локализации ищите «Хранилище» и «Локальное хранилище». Если вкладка скрыта, раскройте список дополнительных вкладок панели.

Таблица покажет ключи img:… и строки data URL.

  1. Выберите изображение через поле загрузки. После успешной записи появятся карточка и сообщение «Сохранено».
  2. Нажмите «Показать» дважды. Количество карточек останется прежним.
  3. Перезагрузите страницу. Изображение снова появится из localStorage.
  4. Нажмите «Удалить» у карточки. Соответствующая строка исчезнет из таблицы хранилища.

Для приблизительной оценки объема выполните код в Console. Расчет учитывает все записи origin, включая данные вне демо.

let units = 0;
for (let i = 0; i < localStorage.length; i++) {
  const key = localStorage.key(i);
  if (key !== null) {
    units += key.length + (localStorage.getItem(key) ?? '').length;
  }
}
console.log({ utf16Units: units, approximateBytes: units * 2 });

Множитель 2 оценивает размер UTF-16 без служебных расходов. Это не точный расход диска и не остаток квоты браузера.

Чтобы проверить текст сообщения о переполнении без заполнения хранилища, выполните в Console вызов обработчика. Это имитация исключения, которая не меняет записи.

reportError(new DOMException('Test', 'QuotaExceededError'));

Страница покажет сообщение с предложением удалить картинки или уменьшить файл.

Реальную ошибку записи перехватывает тот же обработчик. Имитация проверяет вывод сообщения, но не измеряет квоту.

Ошибки при сохранении изображений в localStorage

ОшибкаПоследствиеИсправление
setItem без try/catchПереполнение прерывает обработчик без понятного сообщенияПерехватывайте исключение и выводите подсказку
Перебор всех ключей без фильтраНастройки сайта попадают в список изображенийИспользуйте отдельный префикс img:
Повторяющиеся idПоиск элемента возвращает неподходящую карточкуХраните ключ в data-key и замыкании обработчика
Имя файла как уникальный идентификаторОдноименная загрузка перезаписывает картинкуПримите замену или добавьте уникальный идентификатор
Исходные фотографии в base64Строки расходуют квоту и задерживают основной потокУменьшайте изображения или используйте IndexedDB

Не считайте file.type доказательством корректности файла. MIME-тип может отсутствовать или не соответствовать содержимому. Пример отклоняет пустой тип и дополнительно обрабатывает ошибку декодирования.

Ограничение в 8 МиБ не ограничивает число пикселей.

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

Когда вместо localStorage взять IndexedDB

IndexedDB хранит структурированные данные и Blob без преобразования в base64. Ее асинхронные операции лучше подходят для коллекций изображений. Обычно браузер выделяет ей больше места, чем строковому Web Storage.

МеханизмДанныеОперацииПодходящая задача
localStorageСтрокиСинхронные, простой APIНебольшие миниатюры и настройки
IndexedDBОбъекты, Blob, индексыАсинхронные, транзакцииКоллекция пользовательских изображений
Cache APIПары Request и ResponseАсинхронные, работа с запросамиКеширование ресурсов для офлайн-страницы

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

Метод StorageManager.estimate() возвращает приблизительные usage и quota для управляемого браузером хранилища origin. Запускайте запрос в защищенном контексте, например на HTTPS или localhost.

async function showStorageEstimate() {
  if (!navigator.storage?.estimate) return;
  try {
    const { usage, quota } = await navigator.storage.estimate();
    console.log({ usageBytes: usage, quotaBytes: quota });
  } catch (error) {
    console.error(error);
  }
}
showStorageEstimate();

Эти значения не показывают свободное место именно в localStorage.

Полный код примера

Сохраните листинг в index.html целиком. Для запуска понадобится локальный HTTP-сервер. Выберите один из двух способов.

  • Если установлен Python 3, откройте терминал в каталоге index.html. Запустите команду python3 -m http.server 8000. В Windows также можно использовать py -3 -m http.server 8000.
  • Если Python отсутствует, установите LTS-выпуск Node.js установщиком для вашей системы. Оставьте стандартные компоненты, включая npm. После установки заново откройте терминал в каталоге index.html. Запустите npx --yes http-server . -p 8000 -c-1; первый запуск скачает пакет сервера.

Чтобы открыть терминал в нужном каталоге, используйте встроенный терминал редактора с открытой папкой проекта. В обычном терминале перейдите туда командой cd "путь к папке", подставив путь к вашему index.html.

Оба способа оставляют сервер работающим в открытом терминале.

Откройте адрес http://localhost:8000/index.html. Страница должна показать поле выбора файла, переключатель и кнопки. Чтобы остановить сервер, нажмите Ctrl+C в его терминале.

Если порт занят, замените 8000 в команде и адресе на 8001.

Для проверки в Chrome и Firefox используйте одинаковую последовательность загрузки, показа и удаления. Хранилища этих браузеров независимы: каждый сохранит собственные картинки.

Прямое открытие файла через file: не подходит для проверки привязки к origin. Используйте один и тот же протокол, хост и порт при повторных запусках.

<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Изображения в localStorage</title>
  <style>
    body { max-width: 900px; margin: 24px auto; padding: 16px; font-family: sans-serif; }
    #preview { display: flex; flex-wrap: wrap; gap: 16px; }
    figure { margin: 0; max-width: 240px; overflow-wrap: anywhere; }
    img { display: block; max-width: 100%; max-height: 220px; }
    button, input { margin: 8px 0; }
    #stats { white-space: pre-wrap; }
  </style>
</head>
<body>
  <label for="file">Выберите изображение</label>
  <input id="file" type="file" accept="image/*">
  <label><input id="compress" type="checkbox" checked> Уменьшить до JPEG</label>
  <button id="show" type="button">Показать</button>
  <button id="clear" type="button">Очистить все</button>
  <p id="status" role="status"></p>
  <pre id="stats"></pre>
  <div id="preview"></div>

  <script>
    const PREFIX = 'img:';
    const MAX_FILE_BYTES = 8 * 1024 * 1024;
    const input = document.querySelector('#file');
    const compress = document.querySelector('#compress');
    const preview = document.querySelector('#preview');
    const status = document.querySelector('#status');
    const stats = document.querySelector('#stats');
    const showButton = document.querySelector('#show');
    const clearButton = document.querySelector('#clear');

    function reportError(error) {
      console.error(error);
      if (error?.name === 'QuotaExceededError') {
        status.textContent = 'Недостаточно места. Удалите картинки или уменьшите файл.';
      } else if (error?.name === 'SecurityError') {
        status.textContent = 'Браузер запретил доступ к хранилищу сайта.';
      } else {
        status.textContent = error?.message || 'Не удалось обработать изображение.';
      }
    }

    function imageKeys() {
      const keys = [];
      for (let i = 0; i < localStorage.length; i++) {
        const key = localStorage.key(i);
        if (key?.startsWith(PREFIX)) keys.push(key);
      }
      return keys.sort();
    }

    function readDataUrl(file) {
      return new Promise((resolve, reject) => {
        const reader = new FileReader();
        reader.addEventListener('load', () => resolve(String(reader.result)), { once: true });
        reader.addEventListener('error', () => {
          reject(reader.error || new Error('Не удалось прочитать файл.'));
        }, { once: true });
        reader.addEventListener('abort', () => {
          reject(new Error('Чтение файла отменено.'));
        }, { once: true });
        reader.readAsDataURL(file);
      });
    }

    function decodeImage(url) {
      return new Promise((resolve, reject) => {
        const image = new Image();
        image.addEventListener('load', () => resolve(image), { once: true });
        image.addEventListener('error', () => {
          reject(new Error('Браузер не смог декодировать изображение.'));
        }, { once: true });
        image.src = url;
      });
    }

    function makeJpeg(image) {
      const canvas = document.createElement('canvas');
      const scale = Math.min(1, 800 / image.naturalWidth);
      canvas.width = Math.max(1, Math.round(image.naturalWidth * scale));
      canvas.height = Math.max(1, Math.round(image.naturalHeight * scale));
      const context = canvas.getContext('2d');
      if (!context) throw new Error('Canvas недоступен.');
      context.fillStyle = '#fff';
      context.fillRect(0, 0, canvas.width, canvas.height);
      context.drawImage(image, 0, 0, canvas.width, canvas.height);
      const result = canvas.toDataURL('image/jpeg', 0.75);
      if (!result.startsWith('data:image/jpeg;')) {
        throw new Error('Не удалось создать JPEG.');
      }
      return result;
    }

    function showImages() {
      preview.replaceChildren();
      for (const key of imageKeys()) {
        const value = localStorage.getItem(key);
        if (!value?.startsWith('data:image/')) continue;

        const card = document.createElement('figure');
        card.dataset.key = key;
        const image = new Image();
        image.alt = key.slice(PREFIX.length);
        image.src = value;
        const caption = document.createElement('figcaption');
        caption.textContent = image.alt;
        const button = document.createElement('button');
        button.type = 'button';
        button.textContent = 'Удалить';
        button.addEventListener('click', () => {
          try {
            localStorage.removeItem(key);
            card.remove();
            status.textContent = 'Изображение удалено.';
          } catch (error) {
            reportError(error);
          }
        });
        card.append(image, caption, button);
        preview.append(card);
      }
    }

    function setBusy(busy) {
      input.disabled = busy;
      compress.disabled = busy;
      showButton.disabled = busy;
      clearButton.disabled = busy;
      preview.querySelectorAll('button').forEach(button => {
        button.disabled = busy;
      });
    }

    input.addEventListener('change', async () => {
      const file = input.files[0];
      if (!file) return;
      const shouldCompress = compress.checked;
      setBusy(true);
      status.textContent = 'Обработка изображения...';
      stats.textContent = '';
      try {
        if (!file.type.startsWith('image/')) {
          throw new Error('Выберите файл изображения.');
        }
        if (file.size > MAX_FILE_BYTES) {
          throw new Error('Файл больше 8 МиБ. Выберите изображение меньше.');
        }
        const original = await readDataUrl(file);
        const image = await decodeImage(original);
        if (!image.naturalWidth || !image.naturalHeight) {
          throw new Error('У изображения нет допустимых размеров.');
        }
        let dataUrl = original;
        const measurements = [
          `Файл: ${file.size} байт`,
          `Исходный data URL: ${original.length} символов`
        ];
        if (shouldCompress) {
          const jpeg = makeJpeg(image);
          measurements.push(`JPEG data URL: ${jpeg.length} символов`);
          if (jpeg.length < original.length) dataUrl = jpeg;
        }
        measurements.push(`Для записи: ${dataUrl.length} символов`);
        stats.textContent = measurements.join('\n');
        localStorage.setItem(PREFIX + file.name, dataUrl);
        status.textContent = 'Сохранено. Одноименная запись заменена, если она существовала.';
        showImages();
      } catch (error) {
        reportError(error);
      } finally {
        input.value = '';
        setBusy(false);
      }
    });

    showButton.addEventListener('click', () => {
      try {
        showImages();
        status.textContent = `Показано изображений: ${preview.childElementCount}.`;
      } catch (error) {
        reportError(error);
      }
    });

    clearButton.addEventListener('click', () => {
      try {
        for (const key of imageKeys()) localStorage.removeItem(key);
        preview.replaceChildren();
        stats.textContent = '';
        status.textContent = 'Все изображения демо удалены.';
      } catch (error) {
        reportError(error);
      }
    });

    try {
      showImages();
    } catch (error) {
      reportError(error);
    }
  </script>
</body>
</html>

Сохраняйте в браузере только восстанавливаемые копии картинок. Если пользователь потеряет данные сайта, исходный файл позволит вернуть изображение.

Комментарии

Оставьте свой комментарий
Пока никто не оставил комментариев