SharedObject: локальное хранилище Flash

SharedObject: локальное хранилище Flashdata, flush() и квоты, а также чем его заменяют в 2026 году

SharedObject был первым удобным хранилищем на стороне клиента и заодно главным инструментом трекинга. Разбираем API, квоты и ловушки, а затем переносим ту же логику на localStorage и IndexedDB.

Раздел
ActionScript
Стек
ActionScript 3SharedObjectIndexedDBStorage API
Уровень
Средний
Опубликовано
Обновлено
Чтение
8 мин
Коротко
  • Без flush() данные пишутся только при выгрузке ролика.
  • Лимит по умолчанию 100 КБ на домен, выше нужен диалог.
  • localPath "/" делает объект общим для роликов домена.
  • Сегодня: localStorage, IndexedDB и navigator.storage.persist().
Как решаем
  1. Получите объект через SharedObject.getLocal с localPath "/"
  2. Задайте значения по умолчанию, если data пустой
  3. Вызывайте flush() в try/catch и ждите NET_STATUS при PENDING
  4. В вебе храните настройки в localStorage, крупное в IndexedDB
  5. Проверяйте квоту estimate() и просите persist()

Что такое SharedObject и зачем он был нужен#

В эпоху Flash у SWF-ролика не было удобного способа запомнить что-то между запусками. HTTP-cookie подходили плохо: их нужно было читать через JavaScript на странице, они уходили на сервер с каждым запросом и вмещали около четырёх килобайт. Поэтому начиная с Flash Player 6 появился локальный SharedObject: небольшое хранилище на диске пользователя, которое ролик читал и писал сам, без участия сервера и страницы.

Пользовались им все: игры хранили рекорды и прогресс уровней, плееры помнили громкость, формы держали черновики. Данные лежали в файлах с расширением .sol в профиле пользователя, отдельно от браузера, и это свойство позже сыграло против технологии. Для разработчика же API выглядел предельно просто: получить объект по имени, положить значения в data, вызвать flush(). Если вам интересна общая культура экономии ресурсов того времени, загляните в нашу подборку советов по оптимизации ActionScript.

Чтение и запись: data и flush()#

Статический метод SharedObject.getLocal(name, localPath, secure) возвращает объект для текущего домена. Если файла ещё нет, Flash Player создаёт пустой объект, и свойство data приходит без полей. Всё, что вы присваиваете в data, сериализуется в формат AMF, поэтому сохраняются числа, строки, массивы, даты и вложенные объекты. Экземпляры своих классов тоже переживают перезапуск, если зарегистрировать их через registerClassAlias, иначе после чтения вы получите обычный Object.

ActionScript 3
import flash.events.NetStatusEvent;
import flash.net.SharedObject;
import flash.net.SharedObjectFlushStatus;

// "/" делает объект общим для всех SWF этого домена
var so:SharedObject = SharedObject.getLocal("game-settings", "/");

// первая загрузка: data пустой, задаём значения по умолчанию
if (so.data.volume === undefined) {
    so.data.volume = 0.8;
    so.data.bestScore = 0;
}

function saveScore(score:int):void {
    so.data.bestScore = Math.max(score, so.data.bestScore);
    var status:String;
    try {
        // просим сразу 10 000 байт запаса, чтобы не спрашивать пользователя каждый раз
        status = so.flush(10000);
    } catch (e:Error) {
        // пользователь запретил локальное хранение для домена
        trace("Сохранение недоступно: " + e.message);
        return;
    }
    if (status == SharedObjectFlushStatus.PENDING) {
        // Flash Player показал диалог и ждёт решения
        so.addEventListener(NetStatusEvent.NET_STATUS, onFlushStatus);
    }
}

function onFlushStatus(e:NetStatusEvent):void {
    so.removeEventListener(NetStatusEvent.NET_STATUS, onFlushStatus);
    // "SharedObject.Flush.Success" или "SharedObject.Flush.Failed"
    trace(e.info.code);
}

Без явного flush() данные записываются, когда объект выгружается: при закрытии ролика или сборке мусора. На практике это ненадёжно: вкладку закрыли, браузер упал, и прогресс пропал. Поэтому мы всегда вызывали flush() сразу после важных изменений. Метод возвращает строку SharedObjectFlushStatus.FLUSHED, если запись прошла, или PENDING, если Flash Player показал пользователю запрос на дополнительное место. Результат запроса приходит позже событием NetStatusEvent.NET_STATUS. Если же пользователь навсегда запретил хранение для домена, flush() бросает исключение, и без try/catch ролик просто остановится с ошибкой.

Лимит 100 КБ, диалог разрешения и localPath#

Самая частая жалоба на SharedObject звучала так: «сохранение то работает, то нет». Почти всегда причина была в квотах. Вот что нужно было держать в голове:

  • Лимит по умолчанию 100 КБ на домен. Пока суммарный объём объектов домена укладывается в него, запись идёт молча. Пользователь мог изменить лимит или вовсе выставить ноль в Settings Manager.
  • Диалог разрешения. Когда запись выходила за лимит, Flash Player показывал окно с вопросом. Оно требовало минимум 215 на 138 пикселей сцены; на меньшем ролике окно не помещалось, и запись тихо проваливалась.
  • Аргумент minDiskSpace. Вызов flush(10000) просит место с запасом один раз, вместо того чтобы дёргать пользователя при каждом росте данных.
  • localPath. По умолчанию путь строится из полного адреса SWF, и ролик, переехавший в другую папку, своих данных не находил. Значение "/" делало объект общим для всех роликов домена.
  • Имя объекта. Пробелы и символы вроде ~ % & ; : " ' , < > ? # в имени недопустимы, getLocal с ними бросает ошибку.
  • Размер на диске. Свойство size показывало текущий объём объекта в байтах, а clear() удалял и данные, и файл.

Отдельная ловушка подстерегала тех, кто запускал ролик локально: у SWF, открытого с диска, своя песочница, и данные, сохранённые при отладке, не совпадали с теми, что потом были на сайте.

Почему «flash cookies» стали проблемой приватности#

У локального SharedObject было два свойства, которые сделали его любимым инструментом трекинга. Во-первых, он жил вне браузера: кнопка «очистить cookie» его не трогала, а один и тот же файл часто был общим для нескольких браузеров на компьютере. Во-вторых, лимит в 100 КБ с лихвой хватал на идентификатор посетителя. Рекламные и аналитические скрипты сохраняли ID и в обычной cookie, и в SharedObject. Если пользователь чистил cookie, скрипт находил копию во Flash и восстанавливал её. Такие записи прозвали «зомби-cookie».

После исследований и судебных исков конца 2000-х производители браузеров и Adobe договорились об интерфейсе, через который браузер мог попросить плагин стереть данные сайта. С тех пор очистка истории в браузерах стала удалять и локальные данные Flash. Но репутация осталась: в глазах пользователей «flash cookies» стали синонимом слежки, и этот опыт заметно повлиял на то, как сегодня ограничено хранилище в вебе.

Что изменилось к 2026 году#

Flash Player снят с поддержки 31 декабря 2020 года, а с 12 января 2021 года Adobe заблокировала запуск Flash-контента в самом плеере. Файлы .sol на старых машинах ещё могут лежать, но читать их из браузера больше нечем. Задачи остались те же, и у каждой есть штатное решение:

ЗадачаВо FlashВ 2026 году
Пара настроек, флаги, черновикSharedObject.data + flush()localStorage (синхронно, только строки)
Объёмные или структурированные данныеТот же SharedObject с запросом местаIndexedDB, удобнее через небольшую обёртку
Файлы и кэш ответовНе былоCache API, Origin Private File System
Сколько места осталосьСвойство size, лимит в настройкахnavigator.storage.estimate()
Защита от удаленияЛимит, заданный пользователемnavigator.storage.persist()

Модель квот поменялась принципиально. Хранилище считается по origin, а не по домену, и браузер сам решает, сколько отдать сайту, исходя из свободного места на диске. По умолчанию данные хранятся в режиме best-effort: при нехватке места браузер может удалить их без вопросов. Метод persist() просит перевести origin в стойкий режим; одни браузеры решают по эвристикам вовсе без диалога, другие могут спросить пользователя. Важно и то, что для трекинга лазейку закрыли: хранилище сторонних фреймов разделено по сайту верхнего уровня, а Safari может стереть данные, записанные скриптом, если пользователь давно не заходил на сайт.

JavaScript
const KEY = 'game-settings';
const defaults = { volume: 0.8, bestScore: 0 };

function loadSettings() {
  try {
    return { ...defaults, ...JSON.parse(localStorage.getItem(KEY) ?? '{}') };
  } catch {
    // битый JSON или запрещённое хранилище: работаем на значениях по умолчанию
    return { ...defaults };
  }
}

function saveScore(score) {
  const s = loadSettings();
  s.bestScore = Math.max(score, s.bestScore);
  try {
    localStorage.setItem(KEY, JSON.stringify(s));
  } catch (err) {
    if (err instanceof DOMException && err.name === 'QuotaExceededError') {
      console.warn('Квота origin исчерпана');
    }
  }
}

// для крупных данных в IndexedDB: проверить квоту и попросить стойкое хранилище
async function prepareStorage() {
  if (!navigator.storage?.estimate) return;
  const { usage, quota } = await navigator.storage.estimate();
  console.log(`Занято ${usage} из ${quota} байт`);
  const persisted = await navigator.storage.persisted();
  if (!persisted) {
    const granted = await navigator.storage.persist();
    console.log(granted ? 'Данные не удалят при нехватке места' : 'Режим best-effort');
  }
}

У localStorage своя граница: обычно около 5 МБ на origin, и при переполнении setItem бросает QuotaExceededError. Хранит он только строки, поэтому всё идёт через JSON, а даты и классы придётся восстанавливать вручную. Про подводные камни сериализации подробнее в заметке о глубоком копировании объектов.

Как переносить логику сохранения со Flash#

Если вы переписываете старую игру или виджет на HTML5, не пытайтесь повторить SharedObject один в один. Мы делаем так:

  1. Отделяем модель данных от хранилища: игра работает с обычным объектом, а модуль сохранения решает, куда его писать.
  2. Добавляем в сохранённые данные номер версии схемы, чтобы при обновлении можно было мигрировать старые записи.
  3. Небольшие настройки кладём в localStorage, прогресс и кэш больше нескольких сотен килобайт переносим в IndexedDB.
  4. Оборачиваем каждую запись в try/catch: приватный режим и политики браузера могут запретить запись так же, как когда-то Settings Manager.
  5. Если данные важны пользователю, дублируем их на сервере: локальное хранилище по-прежнему может исчезнуть.

Последний пункт и есть главный урок SharedObject. Локальное хранилище всегда было и остаётся кэшем, которому нельзя доверять единственную копию. Больше заметок о переносе Flash-наследия в веб собраны в разделах ActionScript и JavaScript.

100 КБлимит SharedObject на домен по умолчанию
31.12.2020конец поддержки Flash Player
persist()запрос стойкого хранилища в Storage API

«Локальное хранилище всегда было кэшем, которому нельзя доверять единственную копию данных.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Можно ли сегодня прочитать данные из файла .sol?
Браузер этого уже не умеет. Файлы .sol хранятся в формате AMF, и для их разбора существуют сторонние библиотеки и утилиты. Если нужно перенести прогресс игроков, проще выгрузить его заранее на сервер, чем разбирать файлы на чужих компьютерах.
Сколько данных помещается в localStorage?
Обычно около 5 МБ на origin, точное значение зависит от браузера. Хранятся только строки, а при переполнении setItem бросает QuotaExceededError. Для больших объёмов используйте IndexedDB, его квота определяется свободным местом на диске.
Гарантирует ли persist(), что данные не пропадут?
Нет. Метод защищает от автоматического удаления при нехватке места, но пользователь по-прежнему может очистить данные сайта сам. Кроме того, браузер вправе отказать, и тогда хранилище остаётся в режиме best-effort.
Чем SharedObject отличался от cookie?
Он не отправлялся на сервер с запросами, вмещал по умолчанию до 100 КБ вместо примерно 4 КБ и хранил типизированные данные в формате AMF. А ещё он жил вне браузера, поэтому обычная очистка cookie его долгое время не затрагивала.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также