Переносим AS3 на TypeScript

Переносим 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.
Как решаем
  1. Отделить логику от display list и перенести её первой
  2. Перевести пакеты в модули, типы в number, Vector в массивы
  3. Заменить EventDispatcher на EventTarget и CustomEvent
  4. Собрать сцену на PixiJS или canvas, кадр на requestAnimationFrame
  5. Включить 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. Конструктор, свойства, геттеры и сеттеры выглядят почти так же.

ActionScript 3
// 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;
        }
    }
}
JavaScript
// 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;
  }
}

Что сопоставляется не один в один:

AS3TypeScript
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.

JavaScript
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 и вложенными контейнерами напрямую повторяет только сторонняя библиотека. Есть три пути:

  1. DOM и SVG, если элементов немного, а важны доступность и текст.
  2. Canvas 2D без библиотек: полный контроль, но иерархию, хит-тест и перерисовку пишете сами.
  3. 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.

31.12.2020конец поддержки Flash Player
numberодин тип вместо int, uint и Number
EventTargetвстроенная замена EventDispatcher

«Синтаксис AS3 и TypeScript почти совпадает. Переписывать приходится не язык, а платформу: события, кадр и сцену.»

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

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

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

Можно ли сконвертировать AS3 в TypeScript автоматически?
Синтаксис частично переносится поиском и заменой: var с типом, function, пакеты. Но события, display list, загрузчики и числовые типы требуют ручных решений, поэтому автоматическая конвертация даёт черновик, а не рабочий код.
Чем заменить int и uint?
В TypeScript есть только number. Целочисленность восстанавливайте явно: Math.trunc или | 0 для int, >>> 0 для uint. Для массивов целых чисел берите Int32Array или Uint32Array, там приведение к целому делает сам массив.
Нужен ли PixiJS, или хватит canvas?
Если в проекте много вложенных объектов, спрайтов и событий мыши, PixiJS сэкономит недели: модель контейнеров похожа на display list Flash. Для простой анимации или пары графиков достаточно Canvas 2D или SVG без зависимостей.
Куда переносить SharedObject?
Небольшие настройки и прогресс кладите в localStorage, сериализуя в JSON. Для больших объёмов и бинарных данных подойдёт IndexedDB. В обоих случаях данные живут в рамках origin, как раньше SharedObject был привязан к домену.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

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