diff --git a/blog/component-testing.mdx b/blog/component-testing.mdx index 39c55c96..6e80971c 100644 --- a/blog/component-testing.mdx +++ b/blog/component-testing.mdx @@ -38,7 +38,7 @@ import Admonition from "@theme/Admonition"; ### Как использовать? -Узнайте больше об этом в нашей документации Компонентное тестирование. +Узнайте больше об этом в нашей документации [Компонентное тестирование](/docs/basic-guides/component-testing). ### Заключение diff --git a/blog/local-browsers.mdx b/blog/local-browsers.mdx index 313db8b6..89c12c37 100644 --- a/blog/local-browsers.mdx +++ b/blog/local-browsers.mdx @@ -12,9 +12,9 @@ import localBrowsersExampleUrl from "/video/blog/local-browsers/local-browsers-e -Раньше Testplane с протоколом автоматизации webdriver можно было запустить локально только с вручную запущенным [selenium-standalone](https://github.com/webdriverio/selenium-standalone). Теперь достаточно указать `gridUrl: "local"` в [Конфиге Testplane](/docs/v8/reference/config/main) или запустить тесты с [CLI-опцией](/docs/v8/reference/cli) `--local`. В таком случае перед запуском тестов при необходимости будут загружены соответствующие браузеры и вебдрайверы к ним, которые также будут запущены для дальнейшего использования в этих тестах. +Раньше Testplane с протоколом автоматизации webdriver можно было запустить локально только с вручную запущенным [selenium-standalone](https://github.com/webdriverio/selenium-standalone). Теперь достаточно указать `gridUrl: "local"` в [Конфиге Testplane](/docs/reference/config/main) или запустить тесты с [CLI-опцией](/docs/reference/cli) `--local`. В таком случае перед запуском тестов при необходимости будут загружены соответствующие браузеры и вебдрайверы к ним, которые также будут запущены для дальнейшего использования в этих тестах. -Загрузить браузеры и вебдрайверы к ним можно и отдельно, с помощью команды [install-deps](/docs/v8/reference/cli#install-deps). +Загрузить браузеры и вебдрайверы к ним можно и отдельно, с помощью команды [install-deps](/docs/reference/cli#install-deps). Пример запуска тестов на локальном браузере с webdriver протоколом автоматизации: @@ -25,4 +25,4 @@ import localBrowsersExampleUrl from "/video/blog/local-browsers/local-browsers-e ### Как использовать? -Узнайте больше об этом в нашей документации [Как запустить Testplane в локальном браузере](/docs/v8/basic-guides/browsers-overview). +Узнайте больше об этом в нашей документации [Как запустить Testplane в локальном браузере](/docs/basic-guides/browsers-overview). diff --git a/blog/selectivity.mdx b/blog/selectivity.mdx index 8a7afda9..964b1ee8 100644 --- a/blog/selectivity.mdx +++ b/blog/selectivity.mdx @@ -13,7 +13,7 @@ date: 2025-12-03T14:00 ### Как использовать -Узнайте больше об этом в нашей документации [Как настроить селективность при запуске тестов](/docs/v8/guides/selectivity). +Узнайте больше об этом в нашей документации [Как настроить селективность при запуске тестов](/docs/guides/selectivity). ### Заключение diff --git a/blog/storybook-testing.mdx b/blog/storybook-testing.mdx index 8c19d387..822e6337 100644 --- a/blog/storybook-testing.mdx +++ b/blog/storybook-testing.mdx @@ -26,5 +26,5 @@ Also you can try it yourself in our [example project][example] on GitHub with cu [storybook]: https://storybook.js.org [testplane-storybook]: https://github.com/gemini-testing/testplane-storybook [play-function]: https://storybook.js.org/docs/writing-stories/play-function -[vt-story]: ../../docs/v8/basic-guides/visual-testing-with-storybook +[vt-story]: /docs/basic-guides/visual-testing-with-storybook [example]: https://github.com/gemini-testing/testplane/tree/master/examples/storybook-autoscreenshots diff --git a/blog/support-bidi-protocol.mdx b/blog/support-bidi-protocol.mdx index b0a57576..85cc8e1d 100644 --- a/blog/support-bidi-protocol.mdx +++ b/blog/support-bidi-protocol.mdx @@ -133,7 +133,7 @@ it("should screen full page", async ({ browser }) => { [webdriver]: https://www.w3.org/TR/webdriver1/ [cdp]: https://chromedevtools.github.io/devtools-protocol/ -[webvider-vs-cdp]: https://testplane.io/ru/docs/v8/reference/webdriver-vs-cdp/ +[webvider-vs-cdp]: /docs/reference/webdriver-vs-cdp/ [bidi-browsers-support]: https://wpt.fyi/results/webdriver/tests/bidi?label=master&label=stable&aligned [bidi-commands]: https://webdriver.io/docs/api/webdriverBidi [editors-draft]: https://www.w3.org/standards/types/#ED diff --git a/blog/testplane-vs-playwright.mdx b/blog/testplane-vs-playwright.mdx index 7e1c5c33..7bfff909 100644 --- a/blog/testplane-vs-playwright.mdx +++ b/blog/testplane-vs-playwright.mdx @@ -135,7 +135,7 @@ Testplane имеет графический интерфейс, который Testplane предоставляет больше возможностей для кастомизации -Архитектура Testplane построена с учётом потребностей в кастомизации и интеграции. Богатая [событийная модель](/docs/v8/reference/testplane-events) предоставляет множество точек расширения, позволяя разработчикам внедрять собственную логику на любом этапе выполнения тестов. Это особенно важно для проектов, где требуется интеграция с внутренними системами мониторинга, отчётности и управления качеством. +Архитектура Testplane построена с учётом потребностей в кастомизации и интеграции. Богатая [событийная модель](/docs/reference/testplane-events) предоставляет множество точек расширения, позволяя разработчикам внедрять собственную логику на любом этапе выполнения тестов. Это особенно важно для проектов, где требуется интеграция с внутренними системами мониторинга, отчётности и управления качеством. Также Testplane предоставляет JS API, которое позволяет создавать собственные раннеры, адаптированные под специфические потребности проекта. Playwright, несмотря на свою популярность, предлагает меньше точек расширения и требует самостоятельной разработки большинства интеграций. Это увеличивает время на внедрение и поддержку инструмента в корпоративной среде. @@ -173,14 +173,14 @@ Playwright же связывает обновления инструмента ✅ Необходимо тестирование в широком спектре десктопных браузеров и мобильных устройств\ ✅ Требуется тестирование нативных приложений Android и iOS -[anti-aliasing-tolerance]: https://testplane.io/docs/v8/reference/config/browsers/#antialiasing_tolerance +[anti-aliasing-tolerance]: /docs/reference/config/browsers/#antialiasing_tolerance [looks-same]: https://github.com/gemini-testing/looks-same [looks-same-benchmarks]: https://github.com/gemini-testing/looks-same/blob/master/benchmark/results.md [mpt]: https://learn.microsoft.com/en-us/azure/playwright-testing/ -[report-visual-testing]: https://testplane.io/docs/v8/html-reporter/overview/#superb-visual-testing-capabilities -[reporter]: https://testplane.io/docs/v8/html-reporter/overview/ +[report-visual-testing]: /docs/html-reporter/overview/ +[reporter]: /docs/html-reporter/overview/ [storybook]: https://storybook.js.org -[storybook-autotests]: https://testplane.io/docs/v8/basic-guides/visual-testing-with-storybook/ -[testplane-mcp]: https://testplane.io/ru/docs/v8/testplane-mcp/ -[tolerance]: https://testplane.io/docs/v8/reference/config/browsers/#tolerance -[time-travel]: https://testplane.io/ru/docs/v8/guides/time-travel/ +[storybook-autotests]: /docs/basic-guides/visual-testing-with-storybook/ +[testplane-mcp]: /docs/ai/toolkit/testplane-mcp/ +[tolerance]: /docs/reference/config/browsers/#tolerance +[time-travel]: /docs/basic-guides/time-travel/ diff --git a/blog/time-travel-release.mdx b/blog/time-travel-release.mdx index 778573cf..aa87886f 100644 --- a/blog/time-travel-release.mdx +++ b/blog/time-travel-release.mdx @@ -57,7 +57,7 @@ Time Travel записывает снапшоты DOM-дерева, что по ### Другие улучшения -- Значительно переработали [команду `merge-reports`](/docs/v8/html-reporter/html-reporter-commands/#merge-reports) — теперь она работает лучше, стабильнее и покрывает больше кейсов +- Значительно переработали [команду `merge-reports`](/docs/html-reporter/html-reporter-commands/#merge-reports) — теперь она работает лучше, стабильнее и покрывает больше кейсов - Testplane UI теперь умеет работать с отчетами, созданными в старых версиях — теперь можно не бояться потерять данные при обновлении - [Появилось API](https://github.com/gemini-testing/html-reporter/releases/tag/v10.17.0) для выгрузки снапшотов в Time Travel - Возможность выбирать скорость воспроизведения в плеере Time Travel @@ -65,4 +65,4 @@ Time Travel записывает снапшоты DOM-дерева, что по Следите за новыми релизами в нашем блоге и в разделе [Release Notes на GitHub](https://github.com/gemini-testing/html-reporter/releases), а в случае обнаружения проблем приходите в [issue GitHub][gh-issues] — мы вам обязательно поможем! [gh-issues]: https://github.com/gemini-testing/testplane/issues -[time-travel-guide]: https://testplane.io/ru/docs/v8/basic-guides/time-travel/ +[time-travel-guide]: /docs/basic-guides/time-travel/ diff --git a/blog/vscode-extension.mdx b/blog/vscode-extension.mdx index 1716a47b..4ea2c09a 100644 --- a/blog/vscode-extension.mdx +++ b/blog/vscode-extension.mdx @@ -9,7 +9,7 @@ import Admonition from "@theme/Admonition"; import runTestsFromSidebarVideoUrl from "/video/blog/vscode-extension/run-tests-from-sidebar.mp4"; import runTestsFromEditorVideoUrl from "/video/blog/vscode-extension/run-tests-from-editor.mp4"; -Для Testplane реализовали расширение для VS Code, с помощью которого можно настраивать Testplane с нуля, запускать тесты и удобно работать с REPL режимом. +Для Testplane реализовали расширение для VS Code, с помощью которого можно настраивать Testplane с нуля, запускать тесты и удобно работать с [REPL режимом](/docs/reference/cli#testplane-repl). @@ -74,13 +74,13 @@ Install Testplane #### С настройкой `devtools` -В сайдбаре в панели для тестирования также отображается секция с названием Testplane. В ней можно управлять настройками в рантайме. При клике в чекбокс `Enable devtools` и последующем запуске тестов браузеры будут подниматься с использованием CDP протокола (вне зависимости от того, что указано в конфиге). Подробнее про этот режим можно прочитать здесь. +В сайдбаре в панели для тестирования также отображается секция с названием Testplane. В ней можно управлять настройками в рантайме. При клике в чекбокс `Enable devtools` и последующем запуске тестов браузеры будут подниматься с использованием CDP протокола (вне зависимости от того, что указано в конфиге). Подробнее про этот режим можно прочитать [здесь](/docs/guides/how-to-use-cdp/). ![Включение опции devtools](/img/blog/vscode-extension/enable-devtools.png) #### С настройкой `REPL` -При клике в чекбокс `Enable REPL` и последующем запуске теста (в REPL режиме можно одновременно запустить только один тест) он будет запущен в специальном REPL режиме. Подробнее про этот режим можно прочитать здесь. +При клике в чекбокс `Enable REPL` и последующем запуске теста (в REPL режиме можно одновременно запустить только один тест) он будет запущен в специальном REPL режиме. Подробнее про этот режим можно прочитать [здесь](/docs/reference/cli#testplane-repl). ![Включение опции REPL](/img/blog/vscode-extension/enable-repl.png) diff --git a/docs/basic-guides/selectors.mdx b/docs/basic-guides/selectors.mdx index d3ce3db6..c4828a5b 100644 --- a/docs/basic-guides/selectors.mdx +++ b/docs/basic-guides/selectors.mdx @@ -343,7 +343,7 @@ To find form elements by their label text (`label`), use the `getByLabelText` me ```javascript describe("Finding an input field using the getByLabelText method", () => { it("Find and use the search field", async ({ browser }) => { - await browser.url("https://testplane.io/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/docs/html-reporter/overview/"); // Find the search button const searchButton = await browser.getByLabelText(/search|поиск/i); // Click the button to open the search modal @@ -359,7 +359,7 @@ To find an input field by its `placeholder` text, use the `getByPlaceholderText` ```javascript describe("getByPlaceholderText", () => { it("Finding an input field using the getByPlaceholderText method", async ({ browser }) => { - await browser.url("https://testplane.io/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/docs/html-reporter/overview/"); // Open the search modal const searchButton = await browser.$(".DocSearch-Button"); @@ -413,7 +413,7 @@ To find an element by its current value, use the `getByDisplayValue` method. ```javascript describe("Finding using the getByDisplayValue method", () => { it("Find and verify the value", async ({ browser }) => { - await browser.url("https://testplane.io/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/docs/html-reporter/overview/"); // Open search const searchButton = await browser.$(".DocSearch-Button"); @@ -462,7 +462,7 @@ To find an element by the `title` attribute, use the `getByTitle` method. describe("Finding an element using the getByTitle method", () => { it("Finding an element", async ({ browser }) => { // Open the page - await browser.url("https://testplane.io/docs/v8/"); + await browser.url("https://testplane.io/docs/"); // Find the element by the title attribute const linkElement = await browser.getByTitle("Direct link to Rich Debugging Capabilities"); // Confirm that the element is found diff --git a/docs/basic-guides/typescript-esm.mdx b/docs/basic-guides/typescript-esm.mdx index 4592752a..16a2d8cd 100644 --- a/docs/basic-guides/typescript-esm.mdx +++ b/docs/basic-guides/typescript-esm.mdx @@ -113,7 +113,7 @@ declare global { } ``` -You can read more about this in the [custom commands](https://testplane.io/docs/v8/basic-guides/custom-commands/) guide. +You can read more about this in the [custom commands](https://testplane.io/docs/basic-guides/custom-commands/) guide. ## Working with ESM diff --git a/docs/basic-guides/visual-testing.mdx b/docs/basic-guides/visual-testing.mdx index a94b8ace..f7db0126 100644 --- a/docs/basic-guides/visual-testing.mdx +++ b/docs/basic-guides/visual-testing.mdx @@ -56,5 +56,5 @@ Read more about the capabilities of the `assertView' command in the relevant sec [html-reporter]: ../../html-reporter/html-reporter-setup [looks-same]: https://github.com/gemini-testing/looks-same -[browser-command]: https://testplane.io/docs/v8/commands/browser/assertView/ -[element-command]: https://testplane.io/docs/v8/commands/element/assertView/ +[browser-command]: https://testplane.io/docs/commands/browser/assertView/ +[element-command]: https://testplane.io/docs/commands/element/assertView/ diff --git a/docs/comparison/compare-with-playwright.mdx b/docs/comparison/compare-with-playwright.mdx index b6e9d986..a23e0e52 100644 --- a/docs/comparison/compare-with-playwright.mdx +++ b/docs/comparison/compare-with-playwright.mdx @@ -119,7 +119,7 @@ Additionally, Testplane MCP provides the ability to run the browser in mobile de Testplane provides more customization capabilities -Testplane's architecture is built with customization and integration needs in mind. The rich [event model](/docs/v8/reference/testplane-events) provides numerous extension points, allowing developers to inject their own logic at any stage of test execution. This is especially important for projects that require integration with internal monitoring, reporting, and quality management systems. +Testplane's architecture is built with customization and integration needs in mind. The rich [event model](/docs/reference/testplane-events) provides numerous extension points, allowing developers to inject their own logic at any stage of test execution. This is especially important for projects that require integration with internal monitoring, reporting, and quality management systems. Testplane also provides a JS API that allows creating custom runners adapted to specific project needs. Playwright, despite its popularity, offers fewer extension points and requires independent development of most integrations. This increases the time for implementation and maintenance of the tool in a corporate environment. @@ -157,14 +157,14 @@ Playwright links tool updates with browser updates, which can lead to unexpected ✅ Testing across a wide range of desktop browsers and mobile devices is necessary\ ✅ Testing of native Android and iOS applications is required -[anti-aliasing-tolerance]: https://testplane.io/docs/v8/reference/config/browsers/#antialiasing_tolerance +[anti-aliasing-tolerance]: https://testplane.io/docs/reference/config/browsers/#antialiasing_tolerance [looks-same]: https://github.com/gemini-testing/looks-same [looks-same-benchmarks]: https://github.com/gemini-testing/looks-same/blob/master/benchmark/results.md [mpt]: https://learn.microsoft.com/en-us/azure/playwright-testing/ -[report-visual-testing]: https://testplane.io/docs/v8/html-reporter/overview/#superb-visual-testing-capabilities -[reporter]: https://testplane.io/docs/v8/html-reporter/overview/ +[report-visual-testing]: https://testplane.io/docs/html-reporter/overview/#superb-visual-testing-capabilities +[reporter]: https://testplane.io/docs/html-reporter/overview/ [storybook]: https://storybook.js.org -[storybook-autotests]: https://testplane.io/docs/v8/visual-testing/with-storybook/ -[testplane-mcp]: https://testplane.io/docs/v8/testplane-mcp/ -[tolerance]: https://testplane.io/docs/v8/reference/config/browsers/#tolerance -[time-travel]: https://testplane.io/docs/v8/guides/time-travel/ +[storybook-autotests]: https://testplane.io/docs/basic-guides/visual-testing-with-storybook/ +[testplane-mcp]: https://testplane.io/docs/ai/toolkit/testplane-mcp/ +[tolerance]: https://testplane.io/docs/reference/config/browsers/#tolerance +[time-travel]: https://testplane.io/docs/basic-guides/time-travel/ diff --git a/docs/guides/how-to-run-on-github.mdx b/docs/guides/how-to-run-on-github.mdx index 54237788..24e85c2f 100644 --- a/docs/guides/how-to-run-on-github.mdx +++ b/docs/guides/how-to-run-on-github.mdx @@ -4,7 +4,7 @@ To run Testplane in GitHub CI, there's a [dedicated GitHub Action][gh-actions-testplane] that: -- Handles caching of [local browsers](/docs/v8/basic-guides/browsers-overview) (if used); +- Handles caching of [local browsers](/docs/basic-guides/browsers-overview) (if used); - Writes statistics about failed tests to [Job Summary](https://github.blog/news-insights/product-news/supercharging-github-actions-with-job-summaries/); - Helps display [HTML reports](../../html-reporter/html-reporter-setup) with test results in the browser. diff --git a/docs/guides/selectivity.mdx b/docs/guides/selectivity.mdx index 0366c857..6296d79a 100644 --- a/docs/guides/selectivity.mdx +++ b/docs/guides/selectivity.mdx @@ -25,7 +25,7 @@ After a file changes, on the next run only those tests that depend on the change ## Setup -To enable selectivity, just add a [`selectivity`](/docs/v8/reference/config/browsers#selectivity) section with `enabled: true` to your Testplane configuration: +To enable selectivity, just add a [`selectivity`](/docs/reference/config/browsers#selectivity) section with `enabled: true` to your Testplane configuration: ```typescript // testplane.config.ts @@ -183,7 +183,7 @@ Since the tests failed, the new state was not saved, so re-running the tests wil ### Collecting browser dependencies -Testplane records browser dependencies only in the Chrome browser, because dependency collection works via the [Chrome Devtools Protocol](/docs/v8/reference/webdriver-vs-cdp). However, if you have multiple browsers (for example, Chrome and Firefox), Firefox will still be able to use the list of browser dependencies for a test that was collected in Chrome. +Testplane records browser dependencies only in the Chrome browser, because dependency collection works via the [Chrome Devtools Protocol](/docs/reference/webdriver-vs-cdp). However, if you have multiple browsers (for example, Chrome and Firefox), Firefox will still be able to use the list of browser dependencies for a test that was collected in Chrome. ### SourceMap requirement diff --git a/docs/reference/cli.mdx b/docs/reference/cli.mdx index c826768b..2399097a 100644 --- a/docs/reference/cli.mdx +++ b/docs/reference/cli.mdx @@ -580,7 +580,7 @@ testplane list-browsers --format json #### Example {#list-browsers-example} -If you have the following "browsers" section in your [Testplane config](/docs/v8/reference/config/main): +If you have the following "browsers" section in your [Testplane config](/docs/reference/config/main): ```json { @@ -649,9 +649,9 @@ testplane config --help ## `install-deps` command {#install-deps} -This command is a part of the guide [How to launch Testplane in the local browser](/docs/v8/basic-guides/browsers-overview). +This command is a part of the guide [How to launch Testplane in the local browser](/docs/basic-guides/browsers-overview). -Use the `install-deps` command to download all browsers, specified in [Testplane config](/docs/v8/reference/config/main). +Use the `install-deps` command to download all browsers, specified in [Testplane config](/docs/reference/config/main). If this command is launched on supported ubuntu version, all missing necessary ubuntu packages would be downloaded too. @@ -665,7 +665,7 @@ npx testplane install-deps You can also specify, which browsers are need to be downloaded. -For example, if you have browsers "chrome-dark", "firefox-dark" described in Testplane config, you can use the following command to only download these two browsers: +For example, if you have browsers "chrome-dark", "firefox-dark" described in Testplane config, you can use the following command to only download these two browsers: ```bash npx testplane install-deps chrome-dark firefox-dark diff --git a/docs/reference/config/browsers.mdx b/docs/reference/config/browsers.mdx index dbe5f958..66bb0c1f 100644 --- a/docs/reference/config/browsers.mdx +++ b/docs/reference/config/browsers.mdx @@ -141,8 +141,7 @@ Default: `http://localhost:4444/wd/hub`. You can also use value `"local"` in order to use local browsers, managed by Testplane. Read more - in guide [How to launch Testplane in the local - browser](/docs/v8/basic-guides/browsers-overview). + in guide [How to launch Testplane in the local browser](/docs/basic-guides/browsers-overview). ### baseUrl {#base_url} diff --git a/docs/reference/testplane-events.mdx b/docs/reference/testplane-events.mdx index d5c2acf2..9c543322 100644 --- a/docs/reference/testplane-events.mdx +++ b/docs/reference/testplane-events.mdx @@ -1555,7 +1555,7 @@ module.exports = (testplane, opts) => { ```javascript module.exports = { // tests will be run in a local browser, - // see https://testplane.io/docs/v8/basic-guides/browsers-overview/ + // see https://testplane.io/docs/basic-guides/browsers-overview/ gridUrl: "local", // specify the path to the dev server baseUrl: "http://localhost:3000", diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 2c3690c3..24df414e 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -52,8 +52,11 @@ const config: Config = { breadcrumbs: false, versions: { current: { - label: "v8", - path: "v8", + label: "v9", + badge: false, + }, + v8: { + badge: true, }, }, }, @@ -144,15 +147,15 @@ const config: Config = { items: [ { label: "Overview", - to: "/docs/v8", + to: "/docs", }, { label: "Installation", - to: "/docs/v8/quickstart", + to: "/docs/quickstart", }, { label: "Why testplane?", - to: "/docs/v8#why-testplane", + to: "/docs#why-testplane", }, ], }, @@ -161,15 +164,15 @@ const config: Config = { items: [ { label: "Browser commands", - href: "/docs/v8/commands/overview", + href: "/docs/commands/overview", }, { label: "Testplane config", - href: "/docs/v8/reference/config/main", + href: "/docs/reference/config/main", }, { label: "Testplane UI", - href: "/docs/v8/html-reporter/html-reporter-setup", + href: "/docs/html-reporter/html-reporter-setup", }, ], }, @@ -178,15 +181,15 @@ const config: Config = { items: [ { label: "Testplane API", - href: "/docs/v8/reference/testplane-api", + href: "/docs/reference/testplane-api", }, { label: "Testplane events", - href: "/docs/v8/reference/testplane-events", + href: "/docs/reference/testplane-events", }, { label: "Plugins", - href: "/docs/v8/plugins/hermione-browser-version-changer", + href: "/docs/plugins/hermione-browser-version-changer", }, ], }, @@ -195,7 +198,7 @@ const config: Config = { items: [ { label: "Docs", - href: "/docs/v8", + href: "/docs", }, { label: "Blog", diff --git a/i18n/en/docusaurus-plugin-content-blog/cli-and-skill.mdx b/i18n/en/docusaurus-plugin-content-blog/cli-and-skill.mdx index 4eaa5262..858902c2 100644 --- a/i18n/en/docusaurus-plugin-content-blog/cli-and-skill.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/cli-and-skill.mdx @@ -35,7 +35,7 @@ npx @testplane/cli snapshot That turns a fuzzy task like "fix this flaky checkout test" into a tighter loop. The agent can reproduce the page state, inspect the DOM, update the test, and rerun the narrowest relevant command. -Learn more about Testplane Skill [in our docs](/docs/v8/ai/toolkit/testplane-skill) or visit the skill's page on [skills.sh](https://www.skills.sh/gemini-testing/testplane-skill/testplane-skill). +Learn more about Testplane Skill [in our docs](/docs/ai/toolkit/testplane-skill) or visit the skill's page on [skills.sh](https://www.skills.sh/gemini-testing/testplane-skill/testplane-skill). ## Testplane CLI @@ -109,7 +109,7 @@ Snapshots are text-first and optimized for agents. They omit noisy tags and attr ## HTML Reporter integration -The new report tools let agents inspect [Testplane HTML reports](/docs/v8/html-reporter/overview) without opening the browser UI. They work with local reports and remote report URLs, including reports published from CI. +The new report tools let agents inspect [Testplane HTML reports](/docs/html-reporter/overview) without opening the browser UI. They work with local reports and remote report URLs, including reports published from CI. Remote reports are downloaded and cached automatically. The agent can ask for failed tests, inspect a concrete attempt, and pull out the error, steps, images, metadata, and attachments that matter for the fix. @@ -384,6 +384,6 @@ In both cases, the important part is the same: agents can now work with real bro We hope this supercharged toolkit helps you turn the messy parts of browser testing into something more observable, more debuggable, and a little more pleasant to work with. -Try it on one real task: a failing report, a flaky test, or a page where selectors are hard to guess. Visit our [AI Toolkit Docs](/docs/v8/ai/toolkit/testplane-cli) page for more ideas, practical guidance, and examples of how these tools can fit into your workflow. +Try it on one real task: a failing report, a flaky test, or a page where selectors are hard to guess. Visit our [AI Toolkit Docs](/docs/ai/toolkit/testplane-cli) page for more ideas, practical guidance, and examples of how these tools can fit into your workflow. If something still feels awkward — tell us, we are always happy to [hear your feedback](https://github.com/gemini-testing/testplane-mcp/issues). diff --git a/i18n/en/docusaurus-plugin-content-blog/component-testing.mdx b/i18n/en/docusaurus-plugin-content-blog/component-testing.mdx index 41065990..9a12a76f 100644 --- a/i18n/en/docusaurus-plugin-content-blog/component-testing.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/component-testing.mdx @@ -38,7 +38,7 @@ We chose the option of using Vite because this approach provides testing of the ### How to use? -Read more about it in our documentation Component Testing. +Read more about it in our documentation [Component Testing](/docs/basic-guides/component-testing). ### Conclusion diff --git a/i18n/en/docusaurus-plugin-content-blog/local-browsers.mdx b/i18n/en/docusaurus-plugin-content-blog/local-browsers.mdx index 36f91c3b..4f17a966 100644 --- a/i18n/en/docusaurus-plugin-content-blog/local-browsers.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/local-browsers.mdx @@ -12,9 +12,9 @@ Testplane is now able to automatically download browsers for running tests local -Previously, Testplane with the webdriver automation protocol could only be launched locally with a manually started [selenium-standalone](https://github.com/webdriverio/selenium-standalone). Now, it is enough to specify `gridUrl: "local"` in the [Testplane Config](/docs/v8/reference/config/main) or run tests with the [CLI option](/docs/v8/reference/cli) `--local`. In this case, if necessary, the corresponding browsers and web drivers will be downloaded before running the tests, and they will also be launched for further use in these tests. +Previously, Testplane with the webdriver automation protocol could only be launched locally with a manually started [selenium-standalone](https://github.com/webdriverio/selenium-standalone). Now, it is enough to specify `gridUrl: "local"` in the [Testplane Config](/docs/reference/config/main) or run tests with the [CLI option](/docs/reference/cli) `--local`. In this case, if necessary, the corresponding browsers and web drivers will be downloaded before running the tests, and they will also be launched for further use in these tests. -You can also download the browsers and their web drivers separately using the [install-deps](/docs/v8/reference/cli#install-deps) command. +You can also download the browsers and their web drivers separately using the [install-deps](/docs/reference/cli#install-deps) command. Example of running tests on local browser with webdriver automation protocol: @@ -25,4 +25,4 @@ Example of running tests on local browser with webdriver automation protocol: ### How to use? -Learn more about this in our documentation [How to Run Testplane in a Local Browser](/docs/v8/basic-guides/browsers-overview). +Learn more about this in our documentation [How to Run Testplane in a Local Browser](/docs/basic-guides/browsers-overview). diff --git a/i18n/en/docusaurus-plugin-content-blog/selectivity.mdx b/i18n/en/docusaurus-plugin-content-blog/selectivity.mdx index c74f9a65..5aed8fd1 100644 --- a/i18n/en/docusaurus-plugin-content-blog/selectivity.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/selectivity.mdx @@ -13,7 +13,7 @@ Selectivity allows you to significantly speed up the testing process by running ### How to use -Learn more in our guide [How to configure selectivity when running tests](/docs/v8/guides/selectivity). +Learn more in our guide [How to configure selectivity when running tests](/docs/guides/selectivity). ### Conclusion diff --git a/i18n/en/docusaurus-plugin-content-blog/support-bidi-protocol.mdx b/i18n/en/docusaurus-plugin-content-blog/support-bidi-protocol.mdx index d05ca31a..0fa54318 100644 --- a/i18n/en/docusaurus-plugin-content-blog/support-bidi-protocol.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/support-bidi-protocol.mdx @@ -135,7 +135,7 @@ We encourage you to upgrade to the latest Testplane version and share your exper [webdriver]: https://www.w3.org/TR/webdriver1/ [cdp]: https://chromedevtools.github.io/devtools-protocol/ -[webvider-vs-cdp]: https://testplane.io/ru/docs/v8/reference/webdriver-vs-cdp/ +[webvider-vs-cdp]: /docs/reference/webdriver-vs-cdp/ [bidi-browsers-support]: https://wpt.fyi/results/webdriver/tests/bidi?label=master&label=stable&aligned [bidi-commands]: https://webdriver.io/docs/api/webdriverBidi [editors-draft]: https://www.w3.org/standards/types/#ED diff --git a/i18n/en/docusaurus-plugin-content-blog/testplane-vs-playwright.mdx b/i18n/en/docusaurus-plugin-content-blog/testplane-vs-playwright.mdx index 5e3238dd..9be28642 100644 --- a/i18n/en/docusaurus-plugin-content-blog/testplane-vs-playwright.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/testplane-vs-playwright.mdx @@ -129,7 +129,7 @@ Additionally, Testplane MCP provides the ability to run the browser in mobile de Testplane provides more customization capabilities -Testplane's architecture is built with customization and integration needs in mind. The rich [event model](/docs/v8/reference/testplane-events) provides numerous extension points, allowing developers to inject their own logic at any stage of test execution. This is especially important for projects that require integration with internal monitoring, reporting, and quality management systems. +Testplane's architecture is built with customization and integration needs in mind. The rich [event model](/docs/reference/testplane-events) provides numerous extension points, allowing developers to inject their own logic at any stage of test execution. This is especially important for projects that require integration with internal monitoring, reporting, and quality management systems. Testplane also provides a JS API that allows creating custom runners adapted to specific project needs. Playwright, despite its popularity, offers fewer extension points and requires independent development of most integrations. This increases the time for implementation and maintenance of the tool in a corporate environment. @@ -167,14 +167,14 @@ Playwright links tool updates with browser updates, which can lead to unexpected ✅ Testing across a wide range of desktop browsers and mobile devices is necessary\ ✅ Testing of native Android and iOS applications is required -[anti-aliasing-tolerance]: https://testplane.io/docs/v8/config/browsers/#antialiasing_tolerance +[anti-aliasing-tolerance]: /docs/reference/config/browsers/#antialiasing_tolerance [looks-same]: https://github.com/gemini-testing/looks-same [looks-same-benchmarks]: https://github.com/gemini-testing/looks-same/blob/master/benchmark/results.md [mpt]: https://learn.microsoft.com/en-us/azure/playwright-testing/ -[report-visual-testing]: https://testplane.io/docs/v8/html-reporter/overview/#superb-visual-testing-capabilities -[reporter]: https://testplane.io/docs/v8/html-reporter/overview/ +[report-visual-testing]: /docs/html-reporter/overview/ +[reporter]: /docs/html-reporter/overview/ [storybook]: https://storybook.js.org -[storybook-autotests]: https://testplane.io/docs/v8/visual-testing/with-storybook/ -[testplane-mcp]: https://testplane.io/docs/v8/testplane-mcp/ -[tolerance]: https://testplane.io/docs/v8/config/browsers/#tolerance -[time-travel]: https://testplane.io/docs/v8/guides/time-travel/ +[storybook-autotests]: /docs/basic-guides/visual-testing-with-storybook/ +[testplane-mcp]: /docs/ai/toolkit/testplane-mcp/ +[tolerance]: /docs/reference/config/browsers/#tolerance +[time-travel]: /docs/basic-guides/time-travel/ diff --git a/i18n/en/docusaurus-plugin-content-blog/time-travel-release.mdx b/i18n/en/docusaurus-plugin-content-blog/time-travel-release.mdx index 4f4a99b0..ae9c1cbd 100644 --- a/i18n/en/docusaurus-plugin-content-blog/time-travel-release.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/time-travel-release.mdx @@ -57,7 +57,7 @@ The interface remembers your preferences, and even after reloading the page, eve ### Other Improvements -- Significantly reworked the [`merge-reports`](/docs/v8/html-reporter/html-reporter-commands/#merge-reports) command — now it works better, more stable, and covers more cases +- Significantly reworked the [`merge-reports`](/docs/html-reporter/html-reporter-commands/#merge-reports) command — now it works better, more stable, and covers more cases - Testplane UI can now work with reports created in older versions — no need to worry about losing data when upgrading - [New API](https://github.com/gemini-testing/html-reporter/releases/tag/v10.17.0) for exporting snapshots in Time Travel - Option to select playback speed in the Time Travel player @@ -65,4 +65,4 @@ The interface remembers your preferences, and even after reloading the page, eve Stay tuned for new releases on our blog and in the [Release Notes on GitHub](https://github.com/gemini-testing/html-reporter/releases), and if you encounter any issues, please visit our [GitHub issues][gh-issues] — we'll be happy to help! [gh-issues]: https://github.com/gemini-testing/testplane/issues -[time-travel-guide]: /docs/v8/basic-guides/time-travel/ +[time-travel-guide]: /docs/basic-guides/time-travel/ diff --git a/i18n/en/docusaurus-plugin-content-blog/vscode-extension.mdx b/i18n/en/docusaurus-plugin-content-blog/vscode-extension.mdx index 0d3e55eb..3922d9da 100644 --- a/i18n/en/docusaurus-plugin-content-blog/vscode-extension.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/vscode-extension.mdx @@ -9,7 +9,7 @@ import Admonition from "@theme/Admonition"; import runTestsFromSidebarVideoUrl from "/video/blog/vscode-extension/run-tests-from-sidebar.mp4"; import runTestsFromEditorVideoUrl from "/video/blog/vscode-extension/run-tests-from-editor.mp4"; -We have implemented an extension for [VS Code][vscode] for Testplane, which allows you to configure Testplane from scratch, run tests, and conveniently work with the REPL mode. +We have implemented an extension for [VS Code][vscode] for Testplane, which allows you to configure Testplane from scratch, run tests, and conveniently work with the [REPL mode](/docs/reference/cli#testplane-repl). @@ -74,13 +74,13 @@ Example of running tests from a text editor: #### With the `devtools` settings -In the sidebar of the testing panel, there is also a section titled Testplane. Here you can manage settings at runtime. By clicking the `Enable devtools` checkbox and subsequently running tests, browsers will launch using the CDP protocol (regardless of what is specified in the config). You can read more about this mode here.. +In the sidebar of the testing panel, there is also a section titled Testplane. Here you can manage settings at runtime. By clicking the `Enable devtools` checkbox and subsequently running tests, browsers will launch using the CDP protocol (regardless of what is specified in the config). You can read more about this mode [here](/docs/guides/how-to-use-cdp/). ![Enabling devtools option](/img/blog/vscode-extension/enable-devtools.png) #### With the `REPL` settings -When you click the checkbox `Enable REPL` and subsequently run a test (only one test can be run simultaneously in REPL mode), it will be launched in a special REPL mode. You can read more about this mode here. +When you click the checkbox `Enable REPL` and subsequently run a test (only one test can be run simultaneously in REPL mode), it will be launched in a special REPL mode. You can read more about this mode [here](/docs/reference/cli#testplane-repl). ![Enabling the REPL option](/img/blog/vscode-extension/enable-repl.png) diff --git a/i18n/en/docusaurus-plugin-content-docs/current.json b/i18n/en/docusaurus-plugin-content-docs/current.json index 4ab9139a..03d82e87 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current.json +++ b/i18n/en/docusaurus-plugin-content-docs/current.json @@ -1,6 +1,6 @@ { "version.label": { - "message": "v8", + "message": "v9", "description": "The label for version current" }, "sidebar.mainSidebar.category.Config": { diff --git a/i18n/ru/docusaurus-plugin-content-blog/cli-and-skill.mdx b/i18n/ru/docusaurus-plugin-content-blog/cli-and-skill.mdx index 07ea9eb4..36d521ad 100644 --- a/i18n/ru/docusaurus-plugin-content-blog/cli-and-skill.mdx +++ b/i18n/ru/docusaurus-plugin-content-blog/cli-and-skill.mdx @@ -35,7 +35,7 @@ npx @testplane/cli snapshot Это превращает размытый запрос вроде "почини этот flaky checkout-тест" в более четкий цикл работы. Агент может воспроизвести состояние страницы, исследовать DOM, обновить тест и перезапустить самый узкий релевантный набор команд. -Подробнее о Testplane Skill читайте [в документации](/docs/v8/ai/toolkit/testplane-skill) или на странице skill в [skills.sh](https://www.skills.sh/gemini-testing/testplane-skill/testplane-skill). +Подробнее о Testplane Skill читайте [в документации](/docs/ai/toolkit/testplane-skill) или на странице skill в [skills.sh](https://www.skills.sh/gemini-testing/testplane-skill/testplane-skill). ## Testplane CLI @@ -109,7 +109,7 @@ Snapshots в первую очередь текстовые и оптимизи ## Интеграция с HTML Reporter -Новая интеграция с HTML Reporter позволяет агентам исследовать [отчеты Testplane](/docs/v8/html-reporter/overview) с помощью CLI. Они работают как с локальными отчетами, так и удаленными — работать с отчетами из CI можно так же удобно, как и с локальными. +Новая интеграция с HTML Reporter позволяет агентам исследовать [отчеты Testplane](/docs/html-reporter/overview) с помощью CLI. Они работают как с локальными отчетами, так и удаленными — работать с отчетами из CI можно так же удобно, как и с локальными. Удаленные отчеты автоматически скачиваются и кэшируются. Агент может запросить упавшие тесты, исследовать конкретный прогон и посмотреть на ошибку, шаги, изображения, метаданные и вложения, которые важны для исправления. @@ -382,6 +382,6 @@ npx @testplane/cli navigate http://localhost:3000 --timeout 60000 Надеемся, новые инструменты помогут вам сделать браузерное тестирование более прозрачным, отлаживаемым и просто приятным процессом. -Попробуйте на одной реальной задаче: отладка упавшего отчета, flaky-теста или страницы, где сложно угадать селекторы. Больше идей, практических рекомендаций и примеров того, как можно использовать эти инструменты, — на странице [документации AI инструментов](/docs/v8/ai/toolkit/testplane-cli). +Попробуйте на одной реальной задаче: отладка упавшего отчета, flaky-теста или страницы, где сложно угадать селекторы. Больше идей, практических рекомендаций и примеров того, как можно использовать эти инструменты, — на странице [документации AI инструментов](/docs/ai/toolkit/testplane-cli). Если что-то ощущается неудобным — пишите, мы всегда рады [вашему фидбеку](https://github.com/gemini-testing/testplane-mcp/issues). diff --git a/i18n/ru/docusaurus-plugin-content-blog/storybook-testing.mdx b/i18n/ru/docusaurus-plugin-content-blog/storybook-testing.mdx index 03b4c218..1c9d5e22 100644 --- a/i18n/ru/docusaurus-plugin-content-blog/storybook-testing.mdx +++ b/i18n/ru/docusaurus-plugin-content-blog/storybook-testing.mdx @@ -20,7 +20,7 @@ date: 2024-09-26T13:00 Как это использовать? -Узнайте больше об этом в нашей документации Скриншотное тестирование со Storybook. +Узнайте больше об этом в нашей документации [Скриншотное тестирование со Storybook](/docs/basic-guides/visual-testing-with-storybook). [Пример проекта][example] с настроенным скриншотным тестированием со Storybook можно посмотреть в нашем репозитории на GitHub. [storybook]: https://storybook.js.org diff --git a/i18n/ru/docusaurus-plugin-content-docs/current.json b/i18n/ru/docusaurus-plugin-content-docs/current.json index 5b7bcdf6..09da33ec 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current.json +++ b/i18n/ru/docusaurus-plugin-content-docs/current.json @@ -1,6 +1,6 @@ { "version.label": { - "message": "v8", + "message": "v9", "description": "The label for version current" }, "sidebar.mainSidebar.category.Config": { diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/selectors.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/selectors.mdx index ca1c2e79..c304b807 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/selectors.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/selectors.mdx @@ -342,7 +342,7 @@ describe("getByRole", () => { ```javascript describe("Поиск поля ввода с помощью метода getByLabelText", () => { it("Найти и использовать поле поиска", async ({ browser }) => { - await browser.url("https://testplane.io/ru/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/ru/docs/html-reporter/overview/"); // Находим кнопку поиска const searchButton = await browser.getByLabelText(/search|поиск/i); @@ -360,7 +360,7 @@ describe("Поиск поля ввода с помощью метода getByLab ```javascript describe("getByPlaceholderText", () => { it("Поиск поля ввода с помощью метода getByPlaceholderText", async ({ browser }) => { - await browser.url("https://testplane.io/ru/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/ru/docs/html-reporter/overview/"); // Открываем модальное окно поиска const searchButton = await browser.$(".DocSearch-Button"); @@ -416,7 +416,7 @@ describe("getByText", () => { ```javascript describe("Поиск с помощью метода getByDisplayValue", () => { it("Найти и проверить значение", async ({ browser }) => { - await browser.url("https://testplane.io/ru/docs/v8/html-reporter/overview/"); + await browser.url("https://testplane.io/ru/docs/html-reporter/overview/"); // Открываем поиск const searchButton = await browser.$(".DocSearch-Button"); @@ -465,7 +465,7 @@ describe("Поиск элемента с помощью метода getByAltTex describe("Поиск элемента с помощью метода getByTitle", () => { it("Поиск элемента", async ({ browser }) => { // Открываем страницу - await browser.url("https://testplane.io/docs/v8/"); + await browser.url("https://testplane.io/docs/"); // Находим элемент по атрибуту title const linkElement = await browser.getByTitle("Direct link to Rich Debugging Capabilities"); diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/typescript-esm.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/typescript-esm.mdx index 0709f44a..948e7faa 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/typescript-esm.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/typescript-esm.mdx @@ -113,7 +113,7 @@ declare global { } ``` -Подробнее об этом вы можете прочитать в статье про [кастомные команды](https://testplane.io/ru/docs/v8/basic-guides/custom-commands/). +Подробнее об этом вы можете прочитать в статье про [кастомные команды](https://testplane.io/ru/docs/basic-guides/custom-commands/). ## Работа с ESM diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/visual-testing.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/visual-testing.mdx index 0670b2da..69fd4557 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/visual-testing.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/basic-guides/visual-testing.mdx @@ -56,5 +56,5 @@ it("check search view", async ({ browser }) => { [html-reporter]: ../../html-reporter/html-reporter-setup [looks-same]: https://github.com/gemini-testing/looks-same -[browser-command]: https://testplane.io/docs/v8/commands/browser/assertView/ -[element-command]: https://testplane.io/docs/v8/commands/element/assertView/ +[browser-command]: https://testplane.io/docs/commands/browser/assertView/ +[element-command]: https://testplane.io/docs/commands/element/assertView/ diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/comparison/compare-with-playwright.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/comparison/compare-with-playwright.mdx index eeb69fa2..1a446da0 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/comparison/compare-with-playwright.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/comparison/compare-with-playwright.mdx @@ -125,7 +125,7 @@ Testplane имеет графический интерфейс, который Testplane предоставляет больше возможностей для кастомизации -Архитектура Testplane построена с учётом потребностей в кастомизации и интеграции. Богатая [событийная модель](/docs/v8/reference/testplane-events) предоставляет множество точек расширения, позволяя разработчикам внедрять собственную логику на любом этапе выполнения тестов. Это особенно важно для проектов, где требуется интеграция с внутренними системами мониторинга, отчётности и управления качеством. +Архитектура Testplane построена с учётом потребностей в кастомизации и интеграции. Богатая [событийная модель](/docs/reference/testplane-events) предоставляет множество точек расширения, позволяя разработчикам внедрять собственную логику на любом этапе выполнения тестов. Это особенно важно для проектов, где требуется интеграция с внутренними системами мониторинга, отчётности и управления качеством. Также Testplane предоставляет JS API, которое позволяет создавать собственные раннеры, адаптированные под специфические потребности проекта. Playwright, несмотря на свою популярность, предлагает меньше точек расширения и требует самостоятельной разработки большинства интеграций. Это увеличивает время на внедрение и поддержку инструмента в корпоративной среде. @@ -163,14 +163,14 @@ Playwright же связывает обновления инструмента ✅ Необходимо тестирование в широком спектре десктопных браузеров и мобильных устройств\ ✅ Требуется тестирование нативных приложений Android и iOS -[anti-aliasing-tolerance]: https://testplane.io/docs/v8/config/browsers/#antialiasing_tolerance +[anti-aliasing-tolerance]: https://testplane.io/docs/reference/config/browsers/#antialiasing_tolerance [looks-same]: https://github.com/gemini-testing/looks-same [looks-same-benchmarks]: https://github.com/gemini-testing/looks-same/blob/master/benchmark/results.md [mpt]: https://learn.microsoft.com/en-us/azure/playwright-testing/ -[report-visual-testing]: https://testplane.io/docs/v8/html-reporter/overview/#superb-visual-testing-capabilities -[reporter]: https://testplane.io/docs/v8/html-reporter/overview/ +[report-visual-testing]: https://testplane.io/docs/html-reporter/overview/#superb-visual-testing-capabilities +[reporter]: https://testplane.io/docs/html-reporter/overview/ [storybook]: https://storybook.js.org -[storybook-autotests]: https://testplane.io/docs/v8/visual-testing/with-storybook/ -[testplane-mcp]: https://testplane.io/ru/docs/v8/testplane-mcp/ -[tolerance]: https://testplane.io/docs/v8/config/browsers/#tolerance -[time-travel]: https://testplane.io/ru/docs/v8/guides/time-travel/ +[storybook-autotests]: https://testplane.io/docs/basic-guides/visual-testing-with-storybook/ +[testplane-mcp]: https://testplane.io/ru/docs/ai/toolkit/testplane-mcp/ +[tolerance]: https://testplane.io/docs/reference/config/browsers/#tolerance +[time-travel]: https://testplane.io/ru/docs/basic-guides/time-travel/ diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/how-to-run-on-github.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/guides/how-to-run-on-github.mdx index 954c6cc8..fb2e98f7 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/how-to-run-on-github.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/how-to-run-on-github.mdx @@ -4,7 +4,7 @@ Для запуска Testplane в GitHub CI имеется [специальный Github Action][gh-actions-testplane], который: -- Занимается кэшированием [локальных браузеров](/docs/v8/basic-guides/browsers-overview) (при использовании); +- Занимается кэшированием [локальных браузеров](/docs/basic-guides/browsers-overview) (при использовании); - Пишет статистику упавших тестов в [Job summary](https://github.blog/news-insights/product-news/supercharging-github-actions-with-job-summaries/); - Помогает с отображением [html-отчета](../../html-reporter/html-reporter-setup) с результатами прогона тестов в браузере. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/selectivity.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/guides/selectivity.mdx index 8a49a234..3525b63c 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/selectivity.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/selectivity.mdx @@ -25,7 +25,7 @@ import Admonition from "@theme/Admonition"; ## Настройка -Для включения селективности достаточно добавить в конфигурацию Testplane секцию [`selectivity`](/docs/v8/reference/config/browsers#selectivity) с параметром `enabled: true`: +Для включения селективности достаточно добавить в конфигурацию Testplane секцию [`selectivity`](/docs/reference/config/browsers#selectivity) с параметром `enabled: true`: ```typescript // testplane.config.ts @@ -183,7 +183,7 @@ describe("test examples", () => { ### Сбор браузерных зависимостей -Testplane записывает браузерные зависимости только в браузере Chrome, поскольку сбор зависимостей работает по [Chrome Devtools Protocol](/docs/v8/reference/webdriver-vs-cdp). Однако, если у вас несколько браузеров (например, Chrome и Firefox), то Firefox сможет использовать список браузерных зависимостей теста, собранных браузером Chrome. +Testplane записывает браузерные зависимости только в браузере Chrome, поскольку сбор зависимостей работает по [Chrome Devtools Protocol](/docs/reference/webdriver-vs-cdp). Однако, если у вас несколько браузеров (например, Chrome и Firefox), то Firefox сможет использовать список браузерных зависимостей теста, собранных браузером Chrome. ### Требование SourceMap diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/reference/cli.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/reference/cli.mdx index 8775debc..25f7af50 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/reference/cli.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/reference/cli.mdx @@ -581,7 +581,7 @@ testplane list-browsers --format json #### Пример {#list-browsers-example} -Если у вас имеется следующий раздел "browsers" в вашей конфигурации [Testplane](/docs/v8/reference/config/main): +Если у вас имеется следующий раздел "browsers" в вашей конфигурации [Testplane](/docs/reference/config/main): ```json { @@ -651,9 +651,9 @@ testplane config --help ## Команда `install-deps` {#install-deps} -Эта команда является частью рецепта [Как запустить Testplane в локальном браузере](/docs/v8/basic-guides/browsers-overview). +Эта команда является частью рецепта [Как запустить Testplane в локальном браузере](/docs/basic-guides/browsers-overview). -Используйте команду `install-deps`, чтобы загрузить все браузеры, указанные в [конфиге Testplane](/docs/v8/reference/config/main). +Используйте команду `install-deps`, чтобы загрузить все браузеры, указанные в [конфиге Testplane](/docs/reference/config/main). Если эта команда запущена на поддерживаемой версии Ubuntu, также будут загружены все отсутствующие необходимые пакеты Ubuntu. @@ -667,7 +667,7 @@ npx testplane install-deps Вы можете также указать, какие браузеры нужно загрузить. -Например, если у вас описаны браузеры "chrome-dark", "firefox-dark" в конфигурации Testplane, вы можете использовать следующую команду для загрузки только этих двух браузеров: +Например, если у вас описаны браузеры "chrome-dark", "firefox-dark" в конфигурации Testplane, вы можете использовать следующую команду для загрузки только этих двух браузеров: ```bash npx testplane install-deps chrome-dark firefox-dark diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/reference/config/browsers.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/reference/config/browsers.mdx index aae280f4..896a8361 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/reference/config/browsers.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/reference/config/browsers.mdx @@ -140,7 +140,7 @@ URL грида (адрес, на котором слушает ChromeDriver/Sele Также можно использовать значение `"local"`, чтобы запускать тесты на локальных браузерах, управляемых Testplane. Читайте больше в рецепте [Как запустить Testplane в локальном - браузере](/docs/v8/basic-guides/browsers-overview). + браузере](/docs/basic-guides/browsers-overview). ### baseUrl {#base_url} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/reference/testplane-events.mdx b/i18n/ru/docusaurus-plugin-content-docs/current/reference/testplane-events.mdx index fe09ca03..5df351e7 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/reference/testplane-events.mdx +++ b/i18n/ru/docusaurus-plugin-content-docs/current/reference/testplane-events.mdx @@ -1554,7 +1554,7 @@ module.exports = (testplane, opts) => { ```javascript module.exports = { // тесты будут запускаться в локальном браузере, - // см. https://testplane.io/ru/docs/v8/basic-guides/browsers-overview/ + // см. https://testplane.io/ru/docs/basic-guides/browsers-overview/ gridUrl: "http://localhost:4444/wd/hub", // указываем путь к dev-серверу baseUrl: "http://localhost:3000", diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8.json b/i18n/ru/docusaurus-plugin-content-docs/version-v8.json new file mode 100644 index 00000000..5b7bcdf6 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8.json @@ -0,0 +1,98 @@ +{ + "version.label": { + "message": "v8", + "description": "The label for version current" + }, + "sidebar.mainSidebar.category.Config": { + "message": "Конфиг testplane", + "description": "The label for category Config in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.HTML Reporter": { + "message": "HTML Отчет", + "description": "The label for category HTML Reporter in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Visual testing": { + "message": "Визуальное тестирование", + "description": "The label for category Visual testing in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Plugins": { + "message": "Плагины", + "description": "The label for category Plugins in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Commands": { + "message": "Команды в тестах", + "description": "The label for category Commands in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.browser": { + "message": "browser", + "description": "The label for category browser in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.element": { + "message": "element", + "description": "The label for category element in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.expect": { + "message": "expect", + "description": "The label for category expect in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.mock": { + "message": "mock", + "description": "The label for category mock in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Guides": { + "message": "Руководства", + "description": "The label for category Guides in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Migrations": { + "message": "Миграции", + "description": "The label for category Migrations in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Reference": { + "message": "Справочник", + "description": "The label for category Reference in sidebar mainSidebar" + }, + "sidebar.mainSidebar.doc.Quickstart": { + "message": "Быстрый старт", + "description": "The label for the doc item Quickstart in sidebar mainSidebar, linking to the doc quickstart/index" + }, + "sidebar.mainSidebar.doc.CLI": { + "message": "CLI", + "description": "The label for the doc item Command Line in sidebar mainSidebar, linking to the doc command-line/index" + }, + "sidebar.mainSidebar.category.Сomparison": { + "message": "Сравнение", + "description": "The label for category Comparison in sidebar mainSidebar" + }, + "sidebar.api.link.Testplane Commands": { + "message": "Команды Testplane", + "description": "The label for the link Testplane Commands in sidebar api" + }, + "sidebar.api.category.Config": { + "message": "Конфигурация", + "description": "The label for the link Testplane Commands in sidebar api" + }, + "sidebar.mainSidebar.category.Getting Started": { + "message": "Начало работы", + "description": "The label for category Getting Started in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Advanced Guides": { + "message": "Продвинутые руководства", + "description": "The label for category Advanced Guides in sidebar mainSidebar" + }, + "sidebar.mainSidebar.doc.Testplane MCP": { + "message": "Testplane MCP", + "description": "The label for the doc item Testplane MCP in sidebar mainSidebar" + }, + "sidebar.mainSidebar.category.Plugins Reference": { + "message": "Плагины", + "description": "The label for category Plugins Reference in sidebar mainSidebar" + }, + "sidebar.ui.category.API": { + "message": "API", + "description": "The label for category API in sidebar ui" + }, + "sidebar.mainSidebar.category.Visual Testing Best Practices": { + "message": "Лучшие практики визуальных проверок", + "description": "The label for category Visual Testing Best Practices in sidebar mainSidebar" + } +} diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/html-reporter-config-examples.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/html-reporter-config-examples.mdx new file mode 100644 index 00000000..c3877902 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/html-reporter-config-examples.mdx @@ -0,0 +1,62 @@ +import Admonition from "@theme/Admonition"; +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; + + + + ```javascript title="testplane.config.ts" + export = { + // ... + plugins: { + 'html-reporter/testplane': { + enabled: true, + path: 'html-report', + }, + }, + }; + ``` + + + + ```javascript title="playwright.config.ts" + // playwright.config.ts + export default defineConfig({ + // ... + reporter: [ + ['html-reporter/playwright', { + enabled: true, + defaultView: 'failed', + path: 'html-report', + }], + ], + }); + ``` + + + + ```javascript title="jest.config.ts" + const config = { + // ... + reporters: [ + 'html-reporter/jest', // Подключаем наш репортер + 'default' // Встроенный репортер Jest или любые другие необходимые (опционально) + ], + }; + ``` + + Если нужно передать параметры конфигурации, можно сделать так: + ```javascript title="jest.config.ts" + const config = { + // ... + reporters: [ + ['html-reporter/jest', { + path: 'html-report', + }] + ], + }; + ``` + + Если вы используете jest@27 или ниже, нужно указать следующий путь: `html-reporter/build/jest`. + + + diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/mcp-snapshot-example.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/mcp-snapshot-example.mdx new file mode 100644 index 00000000..a6ef9f53 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/mcp-snapshot-example.mdx @@ -0,0 +1,115 @@ +```yaml +- body: + - main.body__wrapper: + - div.headline: + - div.headline__personal: + - a.home-link2.alice.headline__personal-item.home-link2_color_quaternary[aria-label=Алиса href="https://alice.yandex.ru/?utm_source=yandex&utm_campaign=morda_header_oknyx&utm_medium=interface"]: + - svg.alice__icon + - div: + - div: + - a.home-link2.headline__personal-item.headline__personal-item_services[aria-label=Сервисы href=https://yandex.ru/all title=Сервисы role=button]: + - div.headline__personal-icon: + - svg + - a.home-link2.headline__personal-enter.home-link2_color_black[href="https://passport.yandex.ru/auth?retpath=https%3A%2F%2Fsso.passport.yandex.ru%2Fpush%3Fretpath%3Dhttp..."] "Войти" + - div: + - div.usermenu-portal: + - div: + - a.home-link2.headline__personal-menu.headline__personal-item[aria-label="Профиль, вход не выполнен" role=button tabindex=0 href="https://passport.yandex.ru/auth?origin=morda&retpath=https%3A%2F%2Fya.ru%2F%3Fnr%3D1%26redirect_ts%3..."]: + - div.headline__personal-icon: + - svg + - div[@hidden]: + - div.alerts[role=complementary aria-label=Уведомления]: + - h1.a11y-hidden[@hidden] "Уведомления" + - div.alert: + - a.home-link2.alert__content.home-link2_color_inherit[href="https://yandex.ru/pogoda/146?lat=44.948237&lon=34.100318&utm_content=GroupedTomorrow&utm_medium=aler..."]: + - "div.alert__left-content-wrapper[aria-label=\"Завтра: дождь, грозы · +15⁠…⁠+19⁠° · слабый ветер 3⁠–⁠5 м⁠/⁠с, порывы до 11 м⁠/⁠с\"]": + - span.alert__text "Завтра: дождь, грозы · +15⁠…⁠+19⁠° · слабый ветер 3⁠–⁠5 м⁠/⁠с, порывы до 11 м⁠/⁠с" + - button.alert__close[aria-label=Закрыть @hidden] + - div.body__content: + - form.mini-suggest.i-mini-bem.mini-suggest_search_yes.mini-suggest_personal_yes.mini-suggest_request_xhr.mini-suggest_favicon_yes.mini-suggest_hide-on-scroll_yes.mini-suggest_direct_yes.mini-suggest_re-request_yes.mini-suggest_direct-disclaimer_yes.mini-suggest_autofocus_yes.mini-suggest_delete-on-hover_yes.mini-suggest_grouping_yes.mini-suggest_theme_tile.mini-suggest_prevent-empty_yes.mini-suggest_entity-suggest_yes.mini-suggest_overlay_yaru.mini-suggest_type-icon_yes.mini-suggest_redesigned-navs_yes.mini-suggest_redesign-type_block.mini-suggest_expanding_yes.mini-suggest_reasoning_yes.mini-suggest_redesign-serp_yes.search3.search3_redesign-type_block.search3_keyboard_yes.search3_voice_yes.search3_camera_yes.mini-suggest_js_inited[action=https://ya.ru/search/ role=search aria-label="Поиск в интернете"]: + - div.search3__inner-wrapper: + - div: + - section.reasoning-section.reasoning-section_on-top_yes.reasoning-section_justify_center: + - ul.reasoning-section__list: + - li.reasoning-section__item.reasoning-section__item_type_rect: + - a.home-link2.reasoning-section__item-link.home-link2_color_inherit[href="https://yandex.ru/finance?utm_source=subclasses_product&utm_content=fin_5&utm_campaign=morda_web&per..."]: + - span.reasoning-section__item-title "Финансы" + - li.reasoning-section__item.reasoning-section__item_type_rect: + - a.home-link2.reasoning-section__item-link.home-link2_color_inherit[href="https://yandex.ru/products?utm_source=subclasses_product&utm_content=ecom&utm_campaign=morda_web&per..."]: + - span.reasoning-section__item-title "Товары" + - li.reasoning-section__item.reasoning-section__item_type_rect: + - a.home-link2.reasoning-section__item-link.home-link2_color_inherit[href="https://yandex.ru/realty?utm_source=subclasses_realty&utm_content=realty&utm_campaign=morda_web&pers..."]: + - span.reasoning-section__item-title "Квартиры" + - div.search3__inner: + - label.search3__input-wrapper-wrapper[for=text]: + - div.search3__input-wrapper: + - div.search3__input-outer-container: + - div.search3__input-inner-container: + - input.search3__input.mini-suggest__control[aria-label=Запрос name placeholder="Подробно опишите сложную задачу или вопрос" @hidden] + - textarea.search3__input.mini-suggest__input#text[placeholder="Подробно опишите сложную задачу или вопрос" name=text role=combobox] + - svg.search3__magnifier + - div.search3__action-buttons.search3__action-buttons_submit-button-icon_yes: + - div.search3__reasoning-root: + - div.search3__reasoning: + - div.reasoning-dropdown__root: + - div.reasoning-dropdown: + - button.reasoning-dropwdown__button[type=button aria-label=Подробнее title=Подробнее]: + - svg.search3__reasoning-qmark + - div: + - button.search3__keyboard.search3__action[title=Клавиатура type=button @hidden]: + - svg.search3__svg_keyboard + - div.search3__voice-wrapper: + - button.Button.VoiceInput.search3__voice.search3__voice_type_depot.VoiceInput_futuris[aria-label="Голосовой поиск" type=button title="Голосовой поиск"]: + - span.Button-Text: + - svg.VoiceInput-Icon + - div: + - button.search3__action.search3__camera#image-search[title="Поиск по картинке" type=button]: + - svg.search3__svg_camera + - button.search3__button.search3__button_icon_yes.mini-suggest__button[type=submit tabindex=-1 aria-label=Найти @hidden]: + - svg + - input[type=hidden name=lr value=146 @value=146 @hidden] + - input[type=hidden name=msid value=1749915681851623-7074561989186018597-balancer-l7leveler-kubr-yp-vla-119-BAL @value=1749915681851623-7074561989186018597-balancer-l7leveler-kubr-yp-vla-119-BAL @hidden] + - input[type=hidden name=search_source value=yaru_desktop_common @value=yaru_desktop_common @hidden] + - input[type=hidden name=search_domain value=yaru @value=yaru @hidden] + - aside.informers3[aria-label=Информеры]: + - a.home-link2.informers3__item.informers3-weather.home-link2_color_quaternary.home-link2_hover_tertiary[aria-label="Погода в Симферополе 21°, Облачно с прояснениями" href="https://yandex.ru/pogoda/146?lat=44.948237&lon=34.100318&utm_campaign=informer&utm_content=main_info..."]: + - div.informers3-weather__text "+21°" + - div: + - a.home-link2.informers3__pollen.informers3__item.informers3__pollen_level_yellow.informers3__pollen_animate_yes[aria-label="Низкая активность злаков" href="https://yandex.ru/pogoda/allergies?allergen=cereals&lat=44.948237&lon=34.100318&utm_campaign=informe..."]: + - div.simple-tooltip.force-dark.informers-tooltip.simple-tooltip_hidden_yes.simple-tooltip_direction_right[@hidden] "Низкая активность злаков" + - section.informers3__stocks: + - h2.a11y-hidden "Курсы ЦБ РФ" + - div.informers3__stocks-item-wrapper: + - a.home-link2.informers3__stocks-item.home-link2_color_quaternary.home-link2_hover_tertiary[aria-label="USD ЦБ 79,00" href="https://ya.ru/search/?lr=146&search_source=ya_morda_stocks&text=USD+%D0%A6%D0%91&wiz=finance"]: + - span "USD 79,00" + - div.informers3__stocks-item-wrapper: + - a.home-link2.informers3__stocks-item.home-link2_color_quaternary.home-link2_hover_tertiary[aria-label="EUR ЦБ 90,01" href="https://ya.ru/search/?lr=146&search_source=ya_morda_stocks&text=EUR+%D0%A6%D0%91&wiz=finance"]: + - span "EUR 90,01" + - div.informers3__stocks-item-wrapper: + - a.home-link2.informers3__stocks-item.home-link2_color_quaternary.home-link2_hover_tertiary[aria-label="YDEX 3998,50" href="https://ya.ru/search/?lr=146&search_source=ya_morda_stocks&text=YDEX&wiz=finance"]: + - span "YDEX 3998,50" + - a.home-link2.informers3__geo.home-link2_color_quaternary.home-link2_hover_tertiary[aria-label="Ваш город определён как Симферополь" href="https://ya.ru/tune/geo?retpath=https%3A%2F%2Fya.ru%2F%3Fnr%3D1%26redirect_ts%3D1749915681.00000&nosy..."] "Симферополь" + - div.main-home-banner: + - div[@hidden]: + - div.main-home-banner__content.banner-tgo.banner-tgo_title_m: + - div.banner-tgo__content: + - div.banner-tgo__title "Простой переход на Яндекс Браузер" + - div.banner-tgo__subtitle: + - div.banner-tgo__domain "yandex.ru" + - span.home-link2.banner-tgo__mark "Реклама • 0+" + - a.home-link2.banner-tgo__link[aria-label="Простой переход на Яндекс Браузер" href=https://yandex.ru/an/count/WgyejI_zOoVX2Lci0WqL00Eca4kmIQS4p0bKyOO9wCsxD-yN0juA2EWchcZT7ALIUK0NwFEvt...] + - div.direct-close-block.direct-close-block_state_idle.direct-close-block_tgo: + - button.direct-close-block__close-button.direct-close-block__close-button_idle[aria-label="Действия с рекламой"]: + - div.direct-close-block__close-icon: + - svg + - div.ladybug: + - span.home-link2.ladybug__item.ladybug__butterfly#butterfly: + - div#butterfly-button: + - div: + - div.YndxBug.Bug__container1k5BDO.Bug__container_position_left35lf2v: + - div.YndxBug-Icon.Bug__icon3lvpsr: + - svg[@hidden] + - div[@hidden]: + - div.page-info[@hidden] "{\"static\":\"2025-06-11-855\",\"content\":\"big\",\"domain\":\"ru\",\"nodeVersion\":\"v22.10.0\"}" + - span#requestId[@hidden] "1749915681851623-7074561989186018597-balancer-l7leveler-kubr-yp-vla-119-BAL" +``` diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/assert-view-options.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/assert-view-options.mdx new file mode 100644 index 00000000..c4884f28 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/assert-view-options.mdx @@ -0,0 +1,105 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
**Опция****Тип****Описание**
ignoreElementsArray или String + Элементы (задаются как селекторы), которые будут проигнорированы при сравнении + скриншотов. Игнор реализуется с помощью закраски перечисленных элементов черным + цветом. В случае одного элемента параметр можно задавать как строку. +
toleranceNumberЧувствительность к разнице в цветам.
antialiasingToleranceNumberЧувствительность в антиалиасинге.
allowViewportOverflowBoolean + По умолчанию Testplane выдает ошибку, если элемент находится за пределами границ + вьюпорта. Этот параметр отключает проверку на границы, позволяя снимать скриншоты + элементов, не влезающих во вьюпорт. При этом на скриншоте будут видны только те + части элемента, которые влезли во вьюпорт. Однако если _compositeImage_ равен + _true_, то части элемента, которые оказались за _нижней_ границей вьюпорта, тоже + будут видны на скриншоте. Аналогично если _captureElementFromTop_ равен _true_, то + на скриншот попадут и те части элемента, которые оказались за пределами _верхней_ + границы вьюпорта. +
captureElementFromTopBoolean + Снимать скриншот элемента с самого верха. Если элемент находится за пределами + вьюпорта, то к нему будет выполнен подскролл. +
compositeImageBoolean + Если элемент не помещается во вьюпорт, то при включении этой опции последовательно + будет сделано несколько скриншотов разных частей элемента, после чего скриншоты + будут склеены в один, чтобы отобразить элемент полностью. +
screenshotDelayNumber + Задержка в миллисекундах перед снятием скриншота. Может пригодиться, когда на + странице есть элементы, использующие анимацию, или скроллбар, который исчезает не + сразу и попадает на результирующий скриншот. +
selectorToScrollString + Селектор, который нужно скроллировать. Может пригодиться, когда надо сделать + скриншот модального окна, которое не помещается на экране. Иначе без указания + селектора скролл будет применяться к объекту _window_, и скроллироваться будет + задний фон, оставляя попап-окно на месте. +
disableAnimationBoolean + Отключение анимаций и переходов при снятии скриншота. По умолчанию `true` начиная с + версии `8.0.0` +
ignoreDiffPixelCount`` `${number}%` `` или Number + Процент пикселей, которые нужно игнорировать при диффе. Удобно для игнорирования + очень маленьких диффов. По умолчанию `0`. Доступен начиная с версии `8.2.0` +
waitForStaticToLoadTimeoutNumber + Таймаут для команды `waitForStaticToLoad`, автоматически вызываемой перед снятием + скриншота. При значении `0`. ожидание выключено. По умолчанию `5000`. Доступно + начиная с версии `8.32.0`. +
diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/version.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/version.mdx new file mode 100644 index 00000000..79979adb --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/_partials/specs/version.mdx @@ -0,0 +1 @@ +_Доступно начиная с testplane v{props.version}_ diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/overview.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/overview.mdx new file mode 100644 index 00000000..ea7ec181 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/overview.mdx @@ -0,0 +1,163 @@ +--- +sidebar_position: 1 +sidebar_label: Обзор +title: AI-инструменты Testplane +--- + +import { HelpMark } from "@site/src/components/HelpMark"; + +# AI-инструменты Testplane + +Testplane предоставляет набор инструментов для интеграции с AI, которые помогают агентам писать, проверять, отлаживать и исправлять ваши тесты на Testplane. + +Цель этих инструментов — превратить универсального coding-агента в эксперта по Testplane, который понимает, как обычно устроены проекты на Testplane, как нужно писать тесты и как разбирать падения. + +## Возможности + +- Позволяют AI-агентам исследовать приложение и "видеть", что происходит, через экономные по токенам DOM-снимки +- Генерируют новые тесты на основе фактического состояния приложения +- Помогают агентам из коробки придерживаться лучших практик при написании тестов +- Работают с аутентификацией без чтения секретов +- Позволяют агентам разбирать падения по отчетам из CI +- Дают агентам отлаживать тесты через REPL + +## Доступные инструменты + +[Testplane Skill](../toolkit/testplane-skill) обучает AI-агентов работе с проектами на Testplane end-to-end и использованию `@testplane/cli`. В него включены лучшие практики и подробная документация, которую агенты могут использовать в работе. + +[Testplane CLI](../toolkit/testplane-cli) лежит в основе Testplane Skill и дает доступ к автоматизации браузера прямо из CLI. + +[Testplane MCP](../toolkit/testplane-mcp) повторяет возможности `@testplane/cli`, но предлагает другой способ взаимодействия с браузером — через протокол MCP. + +## Какой инструмент выбрать? + +Если не уверены, выбирайте Testplane Skill. Он отлично подходит для большинства сценариев и в целом является лучшим вариантом: coding-агенты любят CLI, он экономно расходует токены и дает достаточно контекста про все, что связано с Testplane. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SkillCLIMCP
**Как работает** + LLM читает markdown-файл с инструкциями и обращается к `@testplane/cli` для + автоматизации браузера + LLM запускает shell-команды для взаимодействия с браузеромLLM взаимодействует с браузером через MCP tool calls
**Эффективность по токенам**Высокая, progressive discoveryВысокая, короткие CLI-вызовы + Ниже, зависит от agent harness{" "} + + Некоторые agent harness могут загружать все схемы MCP-инструментов сразу, + засоряя контекст и тратя токены. +
+
+ Однако некоторые инструменты оптимизируют этот этап: заранее генерируют схемы и подгружают + их лениво, и в таком случае расход токенов сопоставим с CLI-инструментами. + +
**Режим браузера по умолчанию**HeadlessHeadlessHeadful
**Поддерживаемые сценарии** + Сложные workflow + автоматизация браузера{" "} + + Кроме возможностей автоматизации браузера, skill учит агентa работать с auth, + отладкой, выбирать подходящий стиль кода, понимать распространенные паттерны + Testplane и многое другое. + + Взаимодействие с браузером, разбор отчетовТо же, что и CLI
+ +## Сравнение с другими решениями + +В целом мы рекомендуем использовать Testplane AI toolkit при работе с проектами на Testplane, потому что он разработан именно для этого сценария и дает глубокие интеграции с экосистемой Testplane, позволяя агентам: + +- Читать код Testplane, который был выполнен в каждом вызове инструментов CLI/MCP Testplane, и копировать его при написании тестов +- Анализировать отчеты Testplane (локальные и из CI) и исправлять упавшие тесты +- Исследовать Time Travel snapshots, чтобы понять, что пошло не так, и адаптировать тесты по мере развития приложения +- Отлаживать тесты через удобный для агентов REPL-дебаггер +- Понимать возможности Testplane и типовые паттерны использования по краткому справочнику в Testplane Skill + +Мы изучили и другие инструменты для агентной автоматизации браузера — ниже краткое сравнение наиболее заметных проектов, которое поможет сориентироваться в вариантах. + +### Встроенный браузер в Cursor, CC, Cline и т.д. + +[Cursor's Browser](https://cursor.com/docs/agent/tools/browser) и [Cline's Browser Automation](https://docs.cline.bot/tools-reference/browser-automation) — это встроенные способы взаимодействия с браузером: они дают инструменты для навигации, снятия снимков страницы, различных действий и чтения логов консоли браузера. + +У встроенного браузера Cursor есть удобная панель дизайна: она позволяет быстро менять дизайн приложения и указывать на конкретные элементы прямо во время написания промптов. + +Однако у этих инструментов есть серьезные ограничения для тестирования веб-приложений: + +- У Cline вообще нет инструмента DOM snapshot — он опирается только на скриншоты +- Инструмент snapshot в Cursor возвращает accessibility tree, где нет CSS-классов, почти всех HTML-атрибутов и плоская структура без иерархии DOM +- Поддержка браузеров сильно ограничена: только Chrome, без mobile emulation и специальных возможностей +- Нет безопасного способа работать с auth-данными + +### Playwright + +[Playwright CLI](https://github.com/microsoft/playwright-cli) — мощный и популярный инструмент автоматизации браузера. Среди заметных возможностей — анализ сетевых запросов и функции devtools. + +Основные ограничения: + +- Нет анализа отчетов, Time Travel snapshot inspection или REPL-отладки +- Ответы инструментов сфокусированы на коде Playwright, что может путать агентов в проектах на Testplane +- Snapshot строится на accessibility tree, без CSS-классов, точной DOM-структуры и многих полезных HTML-атрибутов + +Playwright CLI — популярный выбор, но ему не хватает ряда возможностей для продвинутых workflow и контекста, специфичного для Testplane. + +### Chrome DevTools MCP + +[Chrome Devtools MCP](https://github.com/ChromeDevTools/chrome-devtools-mcp), помимо обычных браузерных инструментов, дает нишевые возможности вроде снятия memory snapshots и управления browser extensions. + +Для проектов на Testplane основные ограничения такие: + +- Он специфичен для Chrome +- Snapshot строятся на accessibility tree, без CSS-классов и точной DOM-структуры +- Нет интеграции с Testplane tooling, отчетами, Time Travel snapshots или REPL Testplane + +В целом это глубокая низкоуровневая интеграция с возможностями Chrome devtools, но она не сфокусирована на тестировании веб-приложений и не интегрирована с инструментами Testplane. + +### Vercel's agent-browser + +Vercel [agent-browser](https://github.com/vercel-labs/agent-browser) — универсальный инструмент автоматизации браузера с большим набором возможностей, включая анализ сети и профилирование. + +Его сильная сторона — гибкость, но он не привязан к конкретному тест-раннеру или тестовому workflow. + +Для Testplane это означает: + +- Он не сфокусирован именно на тестировании веб-приложений +- Snapshot строятся на accessibility tree +- Нет интеграции с Testplane tooling, отчетами, Time Travel snapshots или REPL Testplane + +agent-browser может быть полезен для общей автоматизации браузера, но ему не хватает Testplane-специфичных интеграций, которые нужны агентам, чтобы эффективно писать, отлаживать и исправлять тесты. + +## Оставайтесь на связи + +Нашли баг, есть вопрос или идея? Дайте нам знать: + +- [Telegram](https://t.me/testplane) +- [GitHub](https://github.com/gemini-testing/testplane) + +За новыми релизами можно следить [здесь](https://github.com/gemini-testing/testplane-mcp/releases). diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/_category_.json b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/_category_.json new file mode 100644 index 00000000..f2d18444 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/_category_.json @@ -0,0 +1,4 @@ +{ + "label": "Инструментарий", + "collapsed": false +} diff --git a/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/testplane-cli.mdx b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/testplane-cli.mdx new file mode 100644 index 00000000..d01109ae --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/version-v8/ai/toolkit/testplane-cli.mdx @@ -0,0 +1,357 @@ +# Testplane CLI + +Testplane CLI позволяет управлять браузером из терминала. + +Вы можете открывать страницы, проходить пользовательские сценарии, сохранять компактные DOM-снимки, смотреть логи консоли, сохранять состояние аутентификации, отлаживать отчеты Testplane и воспроизводить Time Travel snapshots. Инструмент полезен сам по себе, а также является основой для Testplane Skill. + +## Установка + +Установите пакет в проект: + +```shell +npm install --save-dev @testplane/cli +``` + +Затем запускайте его так: + +```shell +npx @testplane/cli --help +``` + +## Типовой сценарий + +Самый простой способ использования — начинать с `navigate`. Если браузер еще не запущен, CLI запустит его автоматически. + +```shell +npx @testplane/cli navigate https://example.com +npx @testplane/cli snapshot +``` + +По умолчанию браузеры CLI работают в headless-режиме. Если вы хотите видеть браузер во время отладки, сначала запустите его явно: + +```shell +npx @testplane/cli launch --headless false +npx @testplane/cli navigate http://localhost:3000 +``` + +Когда закончите: + +```shell +npx @testplane/cli close-browser +``` + +Если не закрыть браузер вручную, по умолчанию он закроется через 5 минут неактивности. + +## Как выглядит вывод + +Большинство браузерных команд возвращают три полезных блока информации: результат действия, эквивалентный код Testplane и текущее состояние браузера. + +```text +Successfully navigated to https://example.com + +## Testplane Code + +await browser.openAndWait("https://example.com"); + +## Browser Tabs + + 1. Title: Example Domain; URL: https://example.com/ (current) + +## Current Tab Snapshot + +The snapshot was saved to: /tmp/.testplane/snapshots/2026-05-14T21-24-40-811Z.yml +``` + +Снапшоты оптимизированы для людей и агентов, читающих вывод терминала. По умолчанию они убирают шумные теги и атрибуты, обрезают очень длинный текст и сохраняют большие снимки во временный файл вместо переполнения терминала. + +## Навигация и инспекция страниц + +Используйте `navigate` с увеличенным таймаутом для медленных локальных приложений или CI-окружений: + +```shell +npx @testplane/cli navigate http://localhost:3000 --timeout 60000 +``` + +Используйте `snapshot`, чтобы понять структуру страницы: + +```shell +npx @testplane/cli snapshot +``` + +Вы можете настроить снимок, если вывод по умолчанию скрывает что-то важное: + +```shell +npx @testplane/cli snapshot --include-attrs data-qa href class --max-text-length 200 +``` + +Используйте `screenshot`, когда нужны визуальные подтверждения: + +```shell +npx @testplane/cli screenshot ./tmp/page.png +``` + +Для большинства задач отладки тестов начинайте с `snapshot`. Его быстрее читать, проще искать по нему, и обычно этого достаточно, чтобы найти нужный селектор или состояние. + +## Взаимодействие с элементами + +Команды принимают либо селектор, либо семантические опции в стиле Testing Library. + +```shell +npx @testplane/cli click '[data-testid="submit"]' +npx @testplane/cli click --role button --name "Submit" +npx @testplane/cli type --label-text "Email" --value "user@example.com" +npx @testplane/cli wait --text "Saved" --timeout 5000 +``` + +Для нативных элементов `` или `