Переносим AS3 на TypeScriptклассы, типы, события и сцена по шагам
Flash-плеера нет с конца 2020 года, а код на ActionScript 3 во многих командах остался. Хорошая новость: TypeScript ему ближе любого другого языка, и большая часть логики переносится почти построчно.
- Раздел
- ActionScript 3
- Стек
- ActionScript 3TypeScriptPixiJS
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Пакеты AS3 становятся ES-модулями: один класс, один файл, явные import и export.
- int, uint и Number сводятся к number, целочисленность держим вручную или через typed arrays.
- EventDispatcher заменяется на встроенный EventTarget и CustomEvent с полем detail.
- Display list переносим на PixiJS или canvas, ENTER_FRAME на requestAnimationFrame.
- Отделить логику от display list и перенести её первой
- Перевести пакеты в модули, типы в number, Vector в массивы
- Заменить EventDispatcher на EventTarget и CustomEvent
- Собрать сцену на PixiJS или canvas, кадр на requestAnimationFrame
- Включить strict в tsconfig и закрыть все any
Почему AS3 переносится легче, чем кажется#
ActionScript 3 и TypeScript растут из одного корня. AS3 опирался на черновик ECMAScript 4 с классами, аннотациями типов через двоеточие и модификаторами доступа. Черновик так и не стал стандартом, но многие его идеи позже вернулись в JavaScript и TypeScript. Об этом подробнее в посте о том, что осталось от Flash.
На практике это значит, что игровую логику, расчёты, парсеры и state-машины часто удаётся перенести почти построчно. Сложнее с тем, что давала платформа Flash Player: display list, модель событий с всплытием, цикл кадров, SharedObject, загрузчики. Поэтому мы советуем сначала разделить код на две кучи: чистая логика без импортов из flash.* и всё, что трогает сцену. Первая куча переезжает за день, вторая требует решений.
Ещё один совет до начала работ: соберите список всех импортов из flash.* по проекту. Это займёт пару минут поиском по исходникам и сразу покажет масштаб. Если в списке в основном flash.events и flash.utils, переезд будет быстрым. Если там flash.display, flash.text и flash.net, закладывайте время на выбор замены для сцены, текста и сетевых запросов. Сетевую часть обычно закрывает fetch, а URLLoader с прогрессом загрузки переписывается на чтение потока ответа.
Пакеты, классы и модификаторы#
Пакет в AS3 совпадал со структурой каталогов, а класс был обязан лежать в файле со своим именем. В TypeScript роль пакета играет ES-модуль: путь к файлу и явный export. Конструктор, свойства, геттеры и сеттеры выглядят почти так же.
// AS3
package com.game.model {
public class Score {
private var _value:int = 0;
public function add(points:int):void {
_value += points;
}
public function get value():int {
return _value;
}
}
}// TypeScript: src/model/Score.ts
export class Score {
#value = 0;
add(points: number): void {
this.#value += Math.trunc(points);
}
get value(): number {
return this.#value;
}
}Что сопоставляется не один в один:
| AS3 | TypeScript |
|---|---|
package a.b | модуль, export и import |
private, protected, public | те же слова (проверка только при компиляции) или #поле для настоящей приватности |
internal | аналога нет: просто не экспортируйте |
dynamic class | индексная сигнатура или Record<string, unknown> |
* (любой тип) | unknown, а не any |
Числа и коллекции: int, uint, Vector#
В AS3 было три числовых типа: int, uint и Number. В TypeScript остаётся один number (64-битное число с плавающей точкой), а для больших целых есть bigint. Код, который полагался на целочисленность, при переносе нужно проверить руками:
- деление
intнаintв AS3 при присваивании вintотбрасывало дробную часть, в TypeScript нуженMath.trunc()или| 0; - переполнение
uintраньше «заворачивалось», теперь число просто растёт; для той же семантики подойдёт>>> 0; - значение по умолчанию у неинициализированного
intбыло0, а уNumberбылNaN; в TypeScript без инициализации получитеundefinedи ошибку приstrict.
Vector.<T> превращается в обычный массив T[]. Если вектор был фиксированной длины и хранил числа ради скорости (частицы, пиксели, тайлы), берите typed arrays: Float32Array, Int32Array, Uint8Array. У них фиксированная длина и честная целочисленность для целых типов, то есть ровно то, ради чего писали Vector.<int>.
Отдельно проверьте сравнения и сортировки. В AS3 Array.sortOn() и флаги вроде Array.NUMERIC сортировали массивы объектов по полю, в TypeScript это всегда sort() с функцией сравнения, например (a, b) => a.score - b.score. Без функции сравнения sort() сравнивает элементы как строки, и массив чисел [10, 9, 1] отсортируется неожиданно. Эту ошибку мы видели почти в каждом перенесённом проекте.
События: от EventDispatcher к EventTarget#
Свои события в AS3 мы делали наследником Event с переопределённым clone(), как в заметке про пользовательские события в AS3. В браузере тот же паттерн даёт встроенный EventTarget: от него можно наследоваться, а данные события передаются через CustomEvent и поле detail.
type ScoreDetail = { total: number };
export class ScoreModel extends EventTarget {
#total = 0;
add(points: number): void {
this.#total += Math.trunc(points);
this.dispatchEvent(
new CustomEvent<ScoreDetail>('change', { detail: { total: this.#total } })
);
}
}
const model = new ScoreModel();
const ctrl = new AbortController();
model.addEventListener('change', (e) => {
const { total } = (e as CustomEvent<ScoreDetail>).detail;
console.log('Счёт:', total);
}, { signal: ctrl.signal });
// вместо removeEventListener для пачки подписок
ctrl.abort();Отличия, о которых стоит помнить. У EventTarget вне DOM нет всплытия: оно было у display list во Flash и есть у DOM-узлов, но не у ваших моделей. Параметра useWeakReference нет, утечки подписок закрывают через AbortController и опцию signal. Метод clone() больше не нужен.
Display list и кадр: canvas или PixiJS#
Сцену Flash с Sprite, MovieClip и вложенными контейнерами напрямую повторяет только сторонняя библиотека. Есть три пути:
- DOM и SVG, если элементов немного, а важны доступность и текст.
- Canvas 2D без библиотек: полный контроль, но иерархию, хит-тест и перерисовку пишете сами.
- PixiJS: модель
Container,Sprite,Graphicsс вложенностью, позицией и событиями указателя на WebGL или WebGPU. Мышление Flash-разработчика переносится сюда легче всего.
Событие Event.ENTER_FRAME заменяет requestAnimationFrame или тикер PixiJS. Идея одного цикла на всё приложение, о которой мы писали в заметке про один цикл ENTER_FRAME, работает и здесь: один обработчик кадра раздаёт время подписчикам. Учитывайте, что частота кадров в браузере зависит от экрана, поэтому анимацию считаем от прошедшего времени, а не от номера кадра. Свои tween-классы обычно заменяют на Web Animations API или GSAP.
Что изменилось к 2026 году#
Flash Player снят с поддержки 31 декабря 2020 года, запускать старый SWF в браузере нечем, кроме эмуляторов. Зато TypeScript стал стандартом де-факто, и переезд AS3-кода на него логичнее, чем на чистый JavaScript: аннотации типов сохраняются, ошибки ловит компилятор. Включайте strict в tsconfig.json с первого дня, иначе неявные any спрячут ровно те места, где раньше работали int и *. Больше заметок по теме собрано в разделе ActionScript 3.
«Синтаксис AS3 и TypeScript почти совпадает. Переписывать приходится не язык, а платформу: события, кадр и сцену.»
Главный вывод заметки


