Отчет об адаптации gem.js под новый интерфейс Steam
Краткий обзор
Скрипт gem.js предназначен для отображения цены предмета в "самоцветах" (Gems) и информации о бустер-паках. В новой версии интерфейса Steam, построенной на React, скрипт полностью неработоспособен. Основная причина — попытка обратиться к элементам DOM и глобальным переменным (window.g_rgAssets), которые или отсутствуют, или имеют совершенно другую структуру. Для восстановления функциональности требуется полный рефакторинг с использованием MutationObserver и данных из window.SSR.
Список проблем и рекомендации
1. Получение имени предмета
- Местоположение:
document.querySelector(placeholderSelector) (где placeholderSelector = "span.f6hU22EA7Z8peFWZVBJU")
- Проблема: Селектор
span.f6hU22EA7Z8peFWZVBJU в новой разметке отсутствует.
- Рекомендация:
- Использовать более стабильный селектор, например, класс
_3KfHV-wUo5sKXQAsJZO5Uw, который содержит название предмета в новой разметке.
- Добавить
MutationObserver для отслеживания изменений, так как React может перерисовывать этот элемент.
- Статус: ❌ Сломано. Требуется доработка.
2. Получение appid, item_type и border_color для вызова GetGooValue
- Местоположение:
JSON.stringify(window.g_rgAssets).match(/GetGooValue\(.*?, (\d+), (\d+), (\d+)/)
- Проблема: Переменная
window.g_rgAssets в новой разметке отсутствует. Она была заменена на window.SSR.loaderData, где данные хранятся в виде JSON-строки.
- Рекомендация:
- Перейти на использование
window.SSR.loaderData.
- Необходимые параметры (
appid, item_type, border_color) извлекать из структуры данных window.SSR.loaderData, где содержится информация о текущем предмете.
- Статус: ❌ Сломано. Требуется полная переработка.
3. Получение game_appid для парсинга бустер-паков
- Местоположение: Извлечение из URL в формате
753/<appid>-<something>
- Проблема: URL новой страницы бустера не содержит
game_appid в формате 753/<appid>-<something>. В новой разметке используется формат 753/<market_hash_name>.
- Рекомендация:
- Извлекать
game_appid из window.SSR.loaderData, где есть поле backgroundAppID или аналогичное, содержащее ID игры для текущего предмета.
- Статус: ❌ Сломано. Требуется доработка.
4. Определение типа страницы (предмет или бустер)
- Местоположение: Проверка текста контейнера на наличие фразы "Набор карточек" или "Booster Pack"
- Проблема: Селектор для контейнера не работает (см. пункт 1), соответственно, условие никогда не выполнится.
- Рекомендация:
- Определять тип страницы по URL или по наличию определенных полей в
window.SSR.loaderData.
- Для бустеров характерно наличие поля
bCommodity: false или специфического market_hash_name, содержащего слово "Booster".
- Статус: ❌ Сломано. Требуется доработка.
5. Парсинг бустер-паков через fetch
- Местоположение: Запрос к
https://steamcommunity.com/market/search/render/
- Проблема: URL для API-запроса не изменился, но
game_appid извлекается неправильно (см. пункт 3). Структура ответа от API может измениться в будущем.
- Рекомендация:
- Исправить извлечение
game_appid (см. пункт 3).
- Добавить обработку ошибок на случай, если API вернет пустой ответ или изменит структуру.
- Статус: 🔄 Частично работает (API не изменился), но требует корректировки
game_appid.
6. Обработка динамического React-рендеринга
- Местоположение: Весь скрипт
- Проблема: Скрипт выполняется один раз при
DOMContentLoaded, но React-компоненты могут подгружаться и обновляться асинхронно. В старой разметке данные загружались сразу, в новой — могут появляться с задержкой.
- Рекомендация:
- Использовать
MutationObserver для отслеживания появления нужных элементов.
- Использовать
window.SSR для получения данных, которые гарантированно загружены на момент выполнения скрипта.
- Добавить повторные попытки поиска элементов с задержками.
- Статус: 🔄 Требуется доработка.
7. GetGooValue API-запрос
- Местоположение: Запрос к
//steamcommunity.com/auction/ajaxgetgoovalueforitemtype/
- Проблема: Сам API-запрос не изменился, но параметры для него (
appid, item_type, border_color) извлекаются неправильно (см. пункт 2).
- Рекомендация:
- Исправить извлечение параметров (см. пункт 2).
- Убедиться, что URL запроса корректен (он не содержит лишних пробелов и переносов строк).
- Статус: 🔄 Частично работает (API не изменился), но требует корректировки параметров.
8. Вставка данных в DOM
- Местоположение:
placeholder.innerHTML += ...
- Проблема: В старой разметке
placeholder — это элемент, содержащий название предмета. В новой разметке нет подходящего места для вставки данных (или оно не соответствует старому селектору).
- Рекомендация:
- Создать новый элемент для вывода информации о Gems (например,
<div> с определенным классом) и вставлять его рядом с названием предмета.
- Использовать
MutationObserver, чтобы дождаться появления контейнера с названием предмета и вставить в него данные.
- Для бустеров — создать отдельный блок под основной информацией.
- Статус: ❌ Сломано. Требуется доработка.
Итоговые сроки
| Задача |
Сложность |
Время |
Переход на 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 часов |
Рекомендации для заказчика
- Критичность: Высокая — скрипт полностью неработоспособен.
- Риски:
- Данные в
window.SSR.loaderData могут быть обновлены Steam в будущем.
- React-компоненты могут динамически изменять DOM, что потребует постоянного мониторинга.
- API
GetGooValue может изменить формат ответа или прекратить работу.
- Рекомендации:
- Приоритет №1: Перейти на использование
window.SSR.loaderData для получения всех необходимых данных (appid, item_type, border_color, game_appid).
- Приоритет №2: Внедрить
MutationObserver для отслеживания изменений DOM и динамической вставки данных.
- Приоритет №3: Создать отдельный UI-блок для отображения информации о Gems и бустерах, чтобы не зависеть от структуры существующих элементов.
- Приоритет №4: Добавить логирование и обработку ошибок для упрощения отладки.
- Бюджет времени: Заложить 12–18 часов на адаптацию и тестирование (с учетом непредвиденных сложностей).
- Превентивные меры:
- Добавить автотесты для проверки работоспособности на основных страницах.
- Документировать все используемые источники данных и селекторы.
- Рассмотреть возможность использования
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 |
Создать новый элемент |
❌ Сломано |