Настройка среды разработки Playwright в VS Code

Для разработки на Playwright рекомендуется использоватьVS Code, поскольку он обеспечивает мощную поддержку JavaScript/TypeScript, отладчика и расширений.

Установка VS Code

  • Перейдите наофициальный сайт VS Code, скачайте и установите.
  • После установки рекомендуется также установитькитайский языковой пакет(поиск в магазине расширенийChinese (Simplified))。

Ссылки по VS Code:https://www.example.com/vscode/vscode-tutorial.html


Основные расширения

В панели расширений VS Code найдите и установите следующие расширения:

Playwright Test для VSCode

  • Официальное расширение Playwright
  • Возможности: запуск/отладка тестов, просмотр отчётов о тестировании, запись скриптов, создание трассировки
  • ID расширения:ms-playwright.playwright

Поддержка JavaScript / TypeScript(Встроена в VS Code, обычно не требует отдельной установки)

Рекомендуемые (необязательно):

  • ESLint(Чтобы обеспечить единообразный стиль кода)
  • Prettier - Code formatter(Форматирование кода в один клик)

Инициализация проекта Playwright

Если вы ещё не инициализировали проект, сначала выполните:

npm init playwright@lates

Расширение VS Code автоматически обнаружит файл проектаplaywright.config.ts/jsи включит представление тестов.


Настройки VS Code

Откройте настройки VS Code (сочетание клавишCtrl+,илиCmd+,) и подтвердите следующие настройки:

  • Форматирование при сохранении
    Найдитеformat on save→ Установите флажокEditor: Format On Save

  • Оболочка терминала по умолчанию(Выберите в соответствии с вашей системой)
    Рекомендуется для Windows:PowerShellилиGit Bash
    Для macOS/Linux значение по умолчанию подойдёт


Конфигурация отладки (launch.json)

В VS Code нажмите на левой боковой панелиЗапуск и отладка→ Создать конфигурацию, выберитеNode.js, сгенерировать.vscode/launch.json, добавьте конфигурацию отладки Playwright, например:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Playwright Test",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/node_modules/.bin/playwright",
      "args": ["test", "--project=chromium", "--headed"],
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}

Таким образом, в VS Code вы можете нажатьF5чтобы начать отладку, и Playwright запустится в headed-режиме для удобного наблюдения.


Использование панели расширения Playwright

После установки расширенияPlaywright Test for VSCodeслева появится значок "Playwright":

  • Вы можете напрямую видеть тестовые файлы и список тест-кейсов в проекте.
  • Нажмите кнопку ▶ справа от тест-кейса, чтобы запустить его.
  • Щёлкните правой кнопкой мыши и выберитеDebug Test, чтобы отлаживать пошагово.
  • Для неудачных тестов вы можете напрямую просматриватьtrace-файлы.

Основные команды

Запустите в терминале VS Code:

npx playwright test           # 运行全部测试
npx playwright test login.spec.js # 运行指定文件
npx playwright codegen        # 启动录制工具(自动生成脚本)
npx playwright show-report    # 打开测试报告

Боковая панель тестирования

После установки расширения слева в VS Code появится значок тестирования (значок лабораторного стакана).

Нажмите, чтобы открыть боковую панель тестирования, и вы увидите список всех тестовых файлов.

Здесь вы можете:

  • Разверните файл, чтобы просмотреть каждый тест.describeиtest
  • Нажмите кнопку воспроизведения, чтобы запустить отдельный тест или все тесты.
  • Просматривайте статус выполнения тестов в реальном времени (зелёный — пройден, красный — не пройден, серый — пропущен).
  • Щёлкните правой кнопкой мыши по тесту, чтобы открыть дополнительные параметры (отладка, переход к определению и т. д.).

Режим отладки

Расширение VS Code позволяет отлаживать тесты Playwright так же, как отладку обычного кода:

Установка точек останова

Щёлкните слева от номера строки в коде, чтобы добавить красную точку останова.

Щёлкните правой кнопкой мыши рядом с точкой останова и выберитеDebug Test, и тест приостановится на точке останова.

Возможности отладки

  • Step Over (F10), Step Into (F11), Step Out (Shift+F11)
  • Просмотр текущих значений переменных
  • Просмотр стека вызовов
  • Вычисление выражений в консоли отладки

Отладка в реальном времени

Отладка в реальном времени — уникальная функция расширения VS Code.

ВключитеПоказывать браузерПри запуске тестов с этой опцией щёлкните локатор в коде, и соответствующий элемент страницы будет подсвечен в окне браузера.

Если локатор соответствует нескольким элементам, Playwright подсветит все совпадающие элементы одновременно.

Вы можете редактировать локатор прямо в коде, и браузер будет отображать обновлённые результаты совпадения в реальном времени.


Pick Locator

В нижней части боковой панели тестирования нажмите кнопкуPick Locator.

В появившемся браузере щёлкните целевой элемент, и полеPick Locatorв VS Code отобразит лучший локатор.

Нажмите Enter, чтобы скопировать в буфер обмена, затем вставьте в код теста.

Playwright автоматически выберет наиболее стабильный и семантичный локатор (приоритет: role > text > testid).


Record New Test

На боковой панели тестирования нажмите кнопкуRecord new.

Playwright откроет окно браузера, и все ваши действия в нем (навигация, клики, ввод) будут записаны.

Вы также можете создавать утверждения с помощью панели инструментов:

  • Assert visibility— проверить, что элемент видим
  • Assert text— проверить, что элемент содержит текст
  • Assert value— проверить значение элемента

После завершения записи закройте браузер, и код будет автоматически сгенерирован вtest-1.spec.tsфайл.


Record at Cursor

В существующем коде теста поместите курсор туда, куда хотите вставить действия, и нажмитеRecord at cursor。

Playwright запишет последующие действия в браузере и вставит сгенерированный код в позицию курсора.

Эта функция идеально подходит для добавления шагов к существующему тесту.

Другие расширения