Назад в Центр знаний
Начало работы

Chrome DevTools MCP и Playwright MCP: отладка

Выберите DevTools MCP или Playwright MCP для своей страницы: состояние интерфейса, сетевые запросы, трассы Chrome, изолированные и существующие сеансы.

BotBrowser Team

Документация

Нужна структурированная документация по теме Начало работы?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Выбор между Chrome DevTools MCP и Playwright MCP зависит от того, какие данные нужны для отладки принадлежащей вам страницы. Начните с Playwright MCP, если нужно выяснить, привело ли взаимодействие к нужному состоянию страницы; начните с Chrome DevTools MCP, если вопрос требует записи производительности Chrome и анализа Performance Insights. Оба сервера умеют взаимодействовать со страницами и исследовать сетевую активность, поэтому название каждого из них не ограничивает его возможности только одной задачей. BotBrowser может предоставить исполняемый файл Chromium и профиль для совместимого средства запуска Playwright, но не может регистрировать инструменты за MCP-сервер, не превращает щелчок в проверенную запись данных приложения и не выполняет анализ вместо любого из этих серверов.

Кратко

  • Успешный щелчок по Save дает меньше оснований для вывода, чем свежее наблюдение за страницей. Видимое подтверждение дает меньше оснований, чем долговременная запись на сервере приложения.
  • Playwright MCP предоставляет снимки дерева доступности, инструменты взаимодействия, сообщения консоли и сведения о сетевых запросах. Его документированная дополнительная возможность DevTools также включает инструменты трассировки.
  • Chrome DevTools MCP предоставляет снимки дерева доступности и взаимодействия наряду с записью трасс производительности Chrome и анализом Insights. Эти данные нужны при исследовании времени отрисовки или загрузки.
  • Чистый изолированный сеанс и браузер с уже выполненной авторизацией отвечают на разные вопросы о воспроизведении ошибки. Оба проекта документируют способы работы с существующим состоянием браузера.
  • Сверяйте активный список инструментов установленного сервера и их аргументы с документацией закрепленной ревизии. Примеры ниже представляют условные планы отладки, а не записи запусков или сравнение скорости.

Содержание

Сначала вопрос, затем сервер

Предположим, что на принадлежащей вам странице настроек есть поле отображаемого имени, кнопка Save и сообщение о подтверждении. Другая ваша страница иногда кажется медленной после перехода. Это условные сценарии поведения приложения, а не наблюдения за работающим сервисом. Сначала полезно определить, относится ли недостающий факт к действию, состоянию страницы после него, запросу или временной шкале браузера. Для этих фактов нужны разные наблюдения, даже если один сервер способен предоставить несколько из них.

Справочник инструментов Chrome DevTools MCP включает взаимодействие со страницей, исследование сети и инструменты производительности. README Playwright MCP описывает структурированные снимки дерева доступности и предоставляет собственные инструменты взаимодействия, сети и дополнительной трассировки. Поэтому сравнение только по наличию инструментов будет неполным. Решающий вопрос состоит в том, какой результат позволяет различить конкурирующие объяснения ошибки.

Вопрос отладкиКакие данные запроситьС чего начатьЧто остается неизвестным
Попало ли действие Save в нужный элемент управления?Текущий снимок дерева доступности, цель и результат действияЦикл взаимодействия Playwright MCPПриняло ли приложение изменение
Отображается ли теперь на странице новое имя?Свежий снимок после действия и выполнения условия завершения, заданного приложениемИнструменты снимков любого сервераСохранится ли значение при следующем чтении
Что вернул запрос сохранения?Сведения о соответствующем запросе, тело ответа и поля ошибок приложенияСетевые инструменты любого сервераОзначает ли ответ зафиксированную запись
Почему страница отрисовалась поздно?Запись производительности Chrome, охватывающая переход, и сведения соответствующих InsightsИнструменты производительности Chrome DevTools MCPПолное объяснение со стороны серверной части
Нужна ли для ошибки существующая авторизация?Тот же разрешенный сеанс, затем отдельное контролируемое воспроизведениеДокументированный способ подключения любого сервераБудет ли изолированный сеанс вести себя так же

Таблица задает правило выбора, а не рейтинг поставщиков. Наблюдения за интерфейсом достаточно для вопроса о его состоянии, тогда как гипотезе об отрисовке нужны временные данные. Объяснение протокола MCP и состояния браузера отделяет представление, возвращенное инструментом, от состояния браузера и контекста модели. Сервер может управлять нужной страницей, но возвращать слишком мало информации для подтверждения заявленного вывода.

На /settings Playwright делает снимки до и после щелчка; Chrome DevTools записывает переход и анализирует Insight из трассы

Схема показывает вопросы и границы подтверждающих данных. В ней нет измеренных длительностей, числа запусков или наблюдаемых результатов приложения. Переход от пути Save к пути временной шкалы означает смену вопроса или сбор другого артефакта; он не означает, что инструмент взаимодействия установил причину задержки.

Возможности пересекаются, но данные различаются

В закрепленной ревизии Chrome take_snapshot возвращает текстовое представление на основе дерева доступности и назначает идентификаторы элементам. Справочник прямо предписывает использовать последний снимок. click принимает pageId и uid элемента; его необязательный аргумент includeSnapshot по умолчанию равен false. Следовательно, вызывающая сторона не должна предполагать, что каждый успешный ответ на щелчок содержит свежее описание получившейся страницы.

В закрепленной ревизии Playwright browser_snapshot фиксирует представление доступности текущей страницы. browser_click принимает target, полученный из этого снимка, или уникальный селектор. Это другая схема аргументов, чем сочетание pageId и uid в Chrome. В опубликованном каталоге инструментов Playwright также перечислены browser_network_requests и browser_network_request, поэтому исследование запроса и ответа само по себе не требует смены сервера.

Вид данныхНазвания в Chrome DevTools MCPНазвания в Playwright MCPГраница интерпретации
Состояние страницы в дереве доступностиtake_snapshotbrowser_snapshotПредставляет доступную семантику страницы, а не все пиксели или состояние сервера
Пользовательское взаимодействиеclick, fill, fill_formbrowser_click, browser_fill_formВыполненное действие требует отдельной проверки результата
Исследование запросаlist_network_requests, get_network_requestbrowser_network_requests, browser_network_requestПо-прежнему важны идентичность запроса и семантика ответа
Запись трассыperformance_start_trace, performance_stop_tracebrowser_start_tracing, browser_stop_tracing с дополнительной возможностью DevToolsОбщие слова в названиях не подтверждают одинаковое содержимое трасс
Анализ производительности Chromeperformance_analyze_insightНельзя выводить наличие соответствующего инструмента из названий трассировкиДля нужного анализа используйте каталог и реальный артефакт

Строка трассировки служит особенно полезным контрпримером распространенному упрощению. README Playwright помещает инструменты трассировки в раздел DevTools, который включается через --caps=devtools. Назвав Playwright MCP сервером только для взаимодействий, мы упустили бы документированную возможность. И наоборот, наличие команды трассировки не подтверждает, что ее результат содержит наборы Chrome Performance Insights или принимает их идентификаторы. Сравнивать нужно реальный артефакт и интерфейс анализа, а не считать все случаи употребления слова «трасса» равнозначными.

Конфигурация также может сужать каталог. Справочник конфигурации Chrome позволяет отключать категории, включая производительность, сеть и отладку. Закрепленная документация задает воспроизводимую основу для изучения, но не доказывает, что именно предлагает работающий экземпляр сейчас. Запишите версию пакета и проверьте обнаруженные схемы инструментов, прежде чем копировать вызов из другой среды.

Для Save в настройках нужна проверка состояния

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

При использовании инструментов взаимодействия Playwright MCP последовательность начинается со свежего снимка, определяет поле и элемент Save, один раз выполняет разрешенное изменение и получает новое наблюдение после выполнения условия завершения приложения. Читайте измененное значение и подтверждение вместе. Сообщение об успехе рядом с неизменившимся отображаемым именем существенно отличается от ситуации, когда оба согласованы, хотя на обеих страницах может присутствовать слово saved.

Эквивалентная последовательность Chrome использует текущий идентификатор страницы, свежие значения uid и fill или fill_form, после которых вызывается click. Поскольку определение click в Chrome не включает снимок по умолчанию, запросите его явно либо вызовите take_snapshot после действия. Идентификатор, скопированный из предыдущего документа, не заменяет надежного наблюдения за текущей формой после перехода или повторной отрисовки.

Ниже приведен шаблон для копирования, относящийся к вашему тестовому сценарию. Это план исследования с незаполненными полями подтверждающих данных, а не выдуманный результат инструмента:

Question: Does one Save update the display name?
Target: owned settings page and designated test account
Initial state: record current field value and current page identity
Action: enter one replacement value and activate Save once
UI evidence: capture the new field value and completion message
Request evidence: identify the matching save request and response
Persistence evidence: read the saved value through the owned app's contract
Unresolved: record any boundary that the collected evidence cannot cross

Если интерфейс не согласуется с ответом, сохраните оба наблюдения. Снимок браузера может показывать оптимистично обновленное значение, хотя запрос отклонен. Успешный ответ может поступить, хотя страница не обновилась. Это разные дефекты, и выбор сервера до описания расхождения может скрыть различие. Инструмент подробностей запроса Playwright может предоставить заголовки и тело выбранного запроса, чтобы исследование не ограничивалось списком URL.

Неоднозначный сбой инструмента тоже требует внимания. Если щелчок был выполнен, но ответ прервался, немедленное повторение Save добавляет еще одно действие до выяснения результата первого. Сначала проверьте страницу и соответствующий запрос. Безвредность повтора зависит от семантики приложения, а не от марки сервера. Для этого условного изменения имени повторное значение может быть допустимым; это не дает оснований переносить такое предположение о повторе на другую форму.

Для медленного перехода нужна ограниченная временная шкала

Взаимодействие с настройками может быть корректным, а следующая страница при этом медленно отрисовываться. Снимок дерева доступности, сделанный после загрузки, не позволяет установить, какая предыдущая активность браузера заняла время. Он описывает результирующее состояние в момент наблюдения. Для вопроса об отрисовке Chrome полезен артефакт записи, действительно охватывающей медленный интервал, вместе с условиями, в которых этот интервал возник.

Инструменты производительности Chrome предоставляют определенную последовательность действий. При использовании reload или autoStop до начала записи перейдите на нужный URL целевой страницы. Начните запись, воспроизведите соответствующий переход или перезагрузку, остановите запись в подходящий момент и сохраните артефакт трассы. performance_analyze_insight требует insightSetId, возвращенный в списке доступных наборов Insights, и соответствующее имя Insight. Это входные данные конкретного запуска, а не метки, которые можно придумать по примеру.

Для условной медленной страницы разделите три возможных объяснения: поздний ответ документа, затратную работу клиентской части после ответа и ресурс, задерживающий видимое содержимое. Запись должна помочь определить, какое объяснение заслуживает дальнейшего исследования. Такие Insights, как DocumentLatency или LCPBreakdown, оба приведенные в справочнике как примеры, дают отправную точку для диагностики на стороне браузера. Их наличие не означает, что в приложении есть узкое место в конкретной базе данных или серверной части.

Условия кеширования меняют исследование. Для performance_start_trace Chrome документирует ignoreCache, позволяющий обойти HTTP-кеш при перезагрузке, и указывает, что он применяется только при reload, равном true. Явно запишите этот выбор. Холодная перезагрузка и повторный переход на уже посещенную страницу не представляют один и тот же пользовательский путь. Справочник инструмента также отмечает, что активные сетевые заглушки отключают HTTP-кеш страницы, поэтому при интерпретации воспроизведения с заглушками нужно учитывать это условие.

Условное наблюдениеКакой следующий вопрос обоснованКакой вывод не обоснован
В итоге на странице появляется нужный заголовокПривел ли переход к нужному состоянию страницы?Отрисовка была быстрой
Трасса охватывает позднее видимое обновлениеКакие записанные действия браузера совпадают по времени с задержкой?У переходов всех пользователей одна причина задержки
Ответ на запрос приходит поздно в этой записиКакие журналы вашего сервера соответствуют этому запросу?Виновата обязательно база данных
Повтор с прогретым кешем быстрее холодной перезагрузкиКакие условия кеша и сеанса изменились?Один сервер MCP сам по себе быстрее

Дополнительная трассировка Playwright остается действительным контрпримером утверждению, что любое исследование временной шкалы требует смены сервера. Если уже доступный артефакт Playwright предоставляет данные для более узкого вопроса, используйте его. Выбирайте инструменты производительности Chrome, когда следующим необходимым шагом становится его документированная запись производительности и интерфейс Insights. Каталог DevTools в Playwright MCP подтверждает наличие трассировки, но сам по себе не подтверждает эквивалентность результатов.

Выбор сеанса меняет воспроизведение

Условная ошибка Save может проявляться только после предыдущего изменения настройки. Запуск в изолированном браузере может убрать эту предпосылку, и симптом исчезнет. Существующий сеанс сохраняет полезный контекст, но также сохраняет возможные смешивающие факторы: авторизацию, предыдущие переходы и локальное состояние приложения. Правильный выбор зависит от того, относится ли вопрос к затронутому сеансу или к контролируемому начальному состоянию.

Документация профилей Playwright описывает постоянный профиль по умолчанию, изолированные сеансы через --isolated и существующие вкладки через расширение Chrome. Там также документируется настройка конечной точки CDP. При закрытии изолированного сеанса его состояние хранилищ теряется; начальный файл состояния может предоставить файлы cookie и локальное хранилище для настройки с авторизацией. Это импортированное состояние представляет конкретный входной параметр, а не доказательство полного воспроизведения исходной среды браузера.

Конфигурация сеансов Chrome назначает для --isolated временный каталог пользовательских данных, который очищается после закрытия браузера. Она также предоставляет --userDataDir для выбранного каталога, --browserUrl или --wsEndpoint для работающего браузера с доступной отладкой и --autoConnect при выполнении документированных требований к Chrome и удаленной отладке. По умолчанию Chrome тоже не использует изоляцию. Следовательно, выражение DevTools MCP само по себе не означает подключение к текущей вкладке разработчика.

Для ошибки, зависящей от существующего состояния, сначала зафиксируйте видимые условия затронутого разрешенного сеанса. Затем отдельно воспроизведите сценарий с намеренно установленным требуемым состоянием. Если во втором случае ошибка не воспроизводится, запишите различие, а не объединяйте результаты в один вывод. Предупреждение о постоянном профиле в README Playwright также важно для параллельных клиентов: один постоянный профиль одновременно может использовать только один экземпляр браузера. Применяйте отдельные изолированные сеансы или разные каталоги, а не трактуйте конфликт профиля как сбой приложения.

Переносите одну запись данных между инструментами

Переход от исследования интерфейса к анализу производительности полезен только тогда, когда второе наблюдение относится к нужной странице и нужному воспроизведению. Перед сменой инструмента сохраните целевой URL, выбранную вкладку, тестовую учетную запись, введенное значение и режим сеанса. Иначе корректная запись производительности может точно описывать другое состояние страницы и все же отвечать не на тот вопрос.

Используйте небольшую запись подтверждающих данных вместо копирования всей истории браузера в исследование. Объяснение границ сообщений MCP показывает, почему результат, возвращенный сервером, и контекст, сохраненный хостом, являются разными объектами. Путь к файлу в ответе инструмента не доказывает, что хост открыл артефакт, а краткое описание может опустить деталь, необходимую для следующего диагностического шага. В закрепленной конфигурации Chrome performanceCrux по умолчанию равен true: URL из трасс производительности отправляются в API CrUX для получения полевых данных о производительности. Для собственной страницы, требующей входа, используйте --performance-crux=false, если такой запрос не нужен, и --redact-network-headers=true: сокрытие заголовков по умолчанию отключено и охватывает лишь некоторые чувствительные сетевые заголовки перед возвратом клиенту. Это не универсальная очистка URL или тел сообщений. Сохраняйте только маршрут, условия сеанса и наблюдение, необходимые для вопроса, опуская постороннее содержимое и данные учетной записи.

Reproduction identity: owned route, test account, application revision
Session conditions: isolated or existing, supplied state, selected tab
Action boundary: one Save or one specified navigation
Observation boundary: snapshot point, request identity, trace interval
Artifact location: retained snapshot, response details or trace file
Supported claim: the narrow fact established by those artifacts
Open question: the next fact requiring application or server evidence

При сравнении итераций сохраняйте условия браузера вместе с этой записью. Измененный режим кеша, восстановленный файл состояния или другой маршрут могут объяснять кажущееся улучшение без какого-либо исправления приложения. Эта запись не является протоколом сравнительного тестирования, и здесь не приводятся длительности. Она сохраняет входные условия, необходимые для решения, сопоставимы ли два наблюдения, прежде чем делать из них вывод.

Роль BotBrowser

Руководство по интеграции BotBrowser с Playwright показывает запуск выбранного исполняемого файла с аргументом профиля и описывает инициализацию, специфичную для фреймворка. Это уровень запуска браузера. Сервер MCP добавляет над ним еще один уровень конфигурации и инструментов. Успешный прямой запуск Playwright не доказывает, что сервер передает тот же исполняемый файл, аргументы или поведение инициализации.

Статья о конфигурации Playwright MCP рассматривает эту передачу исполняемого файла и профиля. Используйте ее, когда сеанс отладки должен работать на конкретной сборке Chromium. Запишите реальную конфигурацию запуска и проверьте нужный браузер отдельно от результата Save в приложении. Закрепленная схема конфигурации Playwright MCP включает параметры запуска браузера, тогда как конфигурация Chrome отдельно предоставляет параметр пользовательского исполняемого файла. Похожие параметры не подтверждают совместимость каждой пользовательской сборки, подключенного сеанса или инструмента производительности.

Роль BotBrowser в этом сравнении ограничивается контролируемым поведением браузера и поддерживаемой интеграцией. Сервер по-прежнему отвечает за доступный каталог инструментов; приложение по-прежнему определяет, что означает saved; запись по-прежнему должна охватывать медленный интервал. Замена исполняемого файла не создаст отсутствующих сведений о запросе и не превратит подтверждение интерфейса в проверку долговременного хранения. Документация интеграции описывает запуск браузера, а шаблон подтверждающих данных определяет, что нужно наблюдать после запуска.

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

Chrome DevTools MCP только исследует страницы, а Playwright MCP нажимает кнопки?

Нет. Закрепленный справочник инструментов Chrome включает щелчки, заполнение и навигацию. Различие полезно для выбора диагностических данных, а не для закрепления взаимодействий исключительно за одним проектом. Текущий список инструментов может быть уже, если конфигурация сервера отключает категории.

Достаточно ли снимка дерева доступности для проверки визуального дефекта?

Не обязательно. Снимок показывает доступную структуру и состояние, тогда как дефект отступов, обрезки или цвета может потребовать скриншота при соответствующем размере области просмотра. Документация скриншотов Playwright в каталоге инструментов различает снимки для действий и наблюдения на основе скриншотов. Выбирайте представление, которое содержит спорное свойство, и сохраняйте размер области просмотра вместе с визуальным сравнением.

Гарантирует ли какой-либо сервер долговременное сохранение после успешного Save?

Ни один результат инструмента на стороне браузера сам по себе не дает такой гарантии. Снимок может подтвердить отображаемое значение, а исследование запроса Chrome может показать ответ. Долговременное сохранение требует документированного чтения после записи в вашем приложении или проверки на стороне сервера. Перезагрузка дает полезные подтверждающие данные только тогда, когда путь перезагрузки этого приложения действительно читает авторитетное сохраненное значение.

Может ли существующего сеанса Playwright быть достаточно для отладки?

Да, если доступные в нем наблюдения отвечают на вопрос. README Playwright MCP документирует способы подключения к существующему браузеру и дополнительную трассировку. Повторно используйте подходящий разрешенный сеанс, когда сохранение его состояния является частью воспроизведения; создайте отдельный изолированный случай, когда вопрос требует контролируемого старта.

Источники

Практический вывод

Выбирайте Playwright MCP для исследования взаимодействий на основе снимков, когда его активные инструменты предоставляют нужные данные о состоянии и запросах. Выбирайте Chrome DevTools MCP, когда вопрос требует его записи производительности Chrome и интерфейса Insights. Оба могут участвовать в одной диагностике, если сеанс, страница и воспроизведение явно определены. Начните с одного принадлежащего вам маршрута, осознанно выберите изолированный или существующий сеанс и проверьте в активном каталоге наличие наблюдения, способного разрешить следующую неизвестность.

#Devtools Mcp#Playwright MCP#Отладка Браузера#Трассы Производительности#Сеансы Браузера

Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.