---
title: "Карта приложения и обход"
id: "2065"
type: "page"
slug: "map"
published_at: "2026-09-28T14:26:44+00:00"
modified_at: "2026-09-28T15:14:39+00:00"
url: "https://pastukhov.com/agents/test/docs/map"
markdown_url: "https://pastukhov.com/agents/test/docs/map.md"
excerpt: "Карта приложения показывает, из каких адресов состоит ваш сайт: какие разделы есть, что лежит на…"
---

# Карта приложения и обход

[https://pastukhov.com/agents/test/docs/map.md](https://pastukhov.com/agents/test/docs/map.md)

Карта приложения показывает, из каких адресов состоит ваш сайт: какие разделы есть, что лежит на каждом адресе и чем он покрыт. Наполняет карту **браузер с установленным дополнением** — другого способа нет, потому что адреса нужно реально открыть и посмотреть, что на них живёт.

Это взгляд с другой стороны, чем инвентарь покрытия. Там речь о кнопках и формах, а здесь — о страницах: видно, какие разделы приложения вообще никто не проверяет.

## Карта маршрутов

Карта — это дерево адресов. У каждого адреса есть карточка: что на странице — замеченные компоненты и адреса запросов, которые страница вызывает, — и чем этот адрес покрыт из тестов. Всё это собирается по ходу движения, описывать вручную ничего не нужно.

Похожие адреса схлопываются в один маршрут: `/users/123` и `/users/456` — это один и тот же маршрут, потому что числа в адресе заменяются на `{id}`. Параметры запроса при этом отбрасываются: `?page=2` и `?page=3` — тоже один адрес. Иначе карта распухла бы от каждого конкретного пользователя или страницы списка, и в ней было бы не разобраться.

## Обход

Обход — это когда браузер сам идёт по сайту и записывает то, что видит. У обхода есть настройки:

- Стартовые адреса — с чего начинать; если их не указать, берётся базовый адрес проекта.
- Максимальная глубина — на сколько шагов уходить от стартовых адресов.
- Максимальное число узлов — предохранитель, чтобы обход не ушёл в бесконечность.
- «Только тот же домен» — не выходить за пределы проекта.
- «Учитывать robots.txt» — уважать запреты, которые сайт сам объявляет для автоматических обходчиков.
- «Разрешить рабочие хосты» — по умолчанию выключено.

Обход открывает **свою** вкладку и закрывает её, когда закончит. Вкладки, которыми пользуетесь вы, он не трогает и не переключает — работать можно спокойно.

## Пауза вместо ошибки

Если подключённого браузера сейчас нет, обход не падает и не пишет ошибку. Он честно показывает «ожидание подключённого браузера» и продолжает с того же места, как только браузер появится. Это важно: браузер закрывают на ночь и на выходные, а обход из-за этого не должен считаться сломанным.

Остановить обход можно и вручную — тогда причина обязательна. Если обход остановился на странице авторизации, продукт так и скажет: адреса за входом могут быть недостижимы.

## Защита рабочего контура

Рабочий (боевой) сайт обход не трогает без явного разрешения. Запреты проверяются **до** перехода на страницу, а не после: и robots.txt, и список рабочих хостов отсекают адрес ещё до того, как браузер его откроет. Пропущенный адрес не исчезает молча — причина видна в заметках обхода.

Отсюда честная оговорка: случайно навредить рабочему сайту обход не может, но и полезного там ничего не увидит, пока вы сами не разрешите. Учитывать robots.txt тоже включено по умолчанию.

## Покрытие поверх карты

Карту можно раскрасить по фактическому покрытию: видно, куда тесты реально заходят, что задето частично и что не задето вовсе. Это тот же взгляд, что и в инвентаре, но со стороны адресов: видно не «какие строки закрыты», а «по каким страницам ходят тесты». Так удобно искать целые разделы, которые никто не проверяет.

## Неважные маршруты

Маршрут можно пометить неважным — например, служебную страницу или технический адрес. Причина обязательна. Важное следствие: **для неважных маршрутов тесты не создаются** — чтобы автоматика не плодила проверки там, где вы этого не хотите. Если решение изменилось, маршрут возвращается на карту одним действием.

На карте видно и то, кто отвечает за маршрут, — ответственного можно назначить или сменить. И ещё одна полезная деталь: у карты есть галерея снимков экрана, так что перед глазами не только адреса, но и то, как эти страницы выглядят.

Дальше: как агент проходит путь от разведки сайта до готовых проверок, — в разделе [Агентские кампании](/agents/test/docs/campaigns)
.

[← Оглавление документации](/agents/test/docs)