SharedObject: локальное хранилище Flashdata, flush() и квоты, а также чем его заменяют в 2026 году
SharedObject был первым удобным хранилищем на стороне клиента и заодно главным инструментом трекинга. Разбираем API, квоты и ловушки, а затем переносим ту же логику на localStorage и IndexedDB.
- Раздел
- ActionScript
- Стек
- ActionScript 3SharedObjectIndexedDBStorage API
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Без flush() данные пишутся только при выгрузке ролика.
- Лимит по умолчанию 100 КБ на домен, выше нужен диалог.
- localPath "/" делает объект общим для роликов домена.
- Сегодня: localStorage, IndexedDB и navigator.storage.persist().
- Получите объект через SharedObject.getLocal с localPath "/"
- Задайте значения по умолчанию, если data пустой
- Вызывайте flush() в try/catch и ждите NET_STATUS при PENDING
- В вебе храните настройки в localStorage, крупное в IndexedDB
- Проверяйте квоту 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.
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 может стереть данные, записанные скриптом, если пользователь давно не заходил на сайт.
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 один в один. Мы делаем так:
- Отделяем модель данных от хранилища: игра работает с обычным объектом, а модуль сохранения решает, куда его писать.
- Добавляем в сохранённые данные номер версии схемы, чтобы при обновлении можно было мигрировать старые записи.
- Небольшие настройки кладём в
localStorage, прогресс и кэш больше нескольких сотен килобайт переносим в IndexedDB. - Оборачиваем каждую запись в
try/catch: приватный режим и политики браузера могут запретить запись так же, как когда-то Settings Manager. - Если данные важны пользователю, дублируем их на сервере: локальное хранилище по-прежнему может исчезнуть.
Последний пункт и есть главный урок SharedObject. Локальное хранилище всегда было и остаётся кэшем, которому нельзя доверять единственную копию. Больше заметок о переносе Flash-наследия в веб собраны в разделах ActionScript и JavaScript.
«Локальное хранилище всегда было кэшем, которому нельзя доверять единственную копию данных.»
Главный вывод заметки


