Отчет об адаптации gem.js под новый интерфейс Steam

Краткий обзор

Скрипт gem.js предназначен для отображения цены предмета в "самоцветах" (Gems) и информации о бустер-паках. В новой версии интерфейса Steam, построенной на React, скрипт полностью неработоспособен. Основная причина — попытка обратиться к элементам DOM и глобальным переменным (window.g_rgAssets), которые или отсутствуют, или имеют совершенно другую структуру. Для восстановления функциональности требуется полный рефакторинг с использованием MutationObserver и данных из window.SSR.


Список проблем и рекомендации

1. Получение имени предмета


2. Получение appid, item_type и border_color для вызова GetGooValue


3. Получение game_appid для парсинга бустер-паков


4. Определение типа страницы (предмет или бустер)


5. Парсинг бустер-паков через fetch


6. Обработка динамического React-рендеринга


7. GetGooValue API-запрос


8. Вставка данных в DOM


Итоговые сроки

Задача Сложность Время
Переход на window.SSR.loaderData для получения данных о предмете и бустере Высокая 3–5 часов
Переработка логики определения типа страницы Низкая 0.5–1 час
Исправление URL для парсинга бустеров и API GetGooValue Низкая 0.5–1 час
Адаптация под React-рендеринг (MutationObserver) Средняя 2–3 часа
Редизайн и вставка UI-элементов (Gems и бустеры) Средняя 2–3 часа
Тестирование и отладка Средняя 2–3 часа
Итого 10–16 часов

Рекомендации для заказчика

  1. Критичность: Высокая — скрипт полностью неработоспособен.
  2. Риски:
    • Данные в window.SSR.loaderData могут быть обновлены Steam в будущем.
    • React-компоненты могут динамически изменять DOM, что потребует постоянного мониторинга.
    • API GetGooValue может изменить формат ответа или прекратить работу.
  3. Рекомендации:
    • Приоритет №1: Перейти на использование window.SSR.loaderData для получения всех необходимых данных (appid, item_type, border_color, game_appid).
    • Приоритет №2: Внедрить MutationObserver для отслеживания изменений DOM и динамической вставки данных.
    • Приоритет №3: Создать отдельный UI-блок для отображения информации о Gems и бустерах, чтобы не зависеть от структуры существующих элементов.
    • Приоритет №4: Добавить логирование и обработку ошибок для упрощения отладки.
  4. Бюджет времени: Заложить 12–18 часов на адаптацию и тестирование (с учетом непредвиденных сложностей).
  5. Превентивные меры:
    • Добавить автотесты для проверки работоспособности на основных страницах.
    • Документировать все используемые источники данных и селекторы.
    • Рассмотреть возможность использования node.js или Puppeteer для парсинга, если API-запросы станут недоступны.

Сравнительная таблица: старая vs новая разметка

Данные Старый селектор/источник Новый селектор/источник Статус
Название предмета span.f6hU22EA7Z8peFWZVBJU Класс _3KfHV-wUo5sKXQAsJZO5Uw (или аналогичный) ❌ Сломано
window.g_rgAssets Глобальная переменная window.SSR.loaderData (JSON) ❌ Сломано
appid, item_type, border_color Из window.g_rgAssets Из window.SSR.loaderData ❌ Сломано
game_appid (для бустеров) Из URL 753/<appid>-<something> Из window.SSR.loaderData.backgroundAppID ❌ Сломано
API для бустеров https://steamcommunity.com/market/search/render/ Без изменений (требуется корректный game_appid) 🔄 Частично
API для Gems //steamcommunity.com/auction/ajaxgetgoovalueforitemtype/ Без изменений (требуются корректные параметры) 🔄 Частично
Место для вставки данных span.f6hU22EA7Z8peFWZVBJU Создать новый элемент ❌ Сломано