{"id":15012807,"url":"https://github.com/jaktestowac/vscode-playwright-helpers","last_synced_at":"2025-07-23T00:06:20.290Z","repository":{"id":252559430,"uuid":"839965288","full_name":"jaktestowac/vscode-playwright-helpers","owner":"jaktestowac","description":"Visual Studio Code extension with commands for Playwright🎭 ","archived":false,"fork":false,"pushed_at":"2025-04-16T00:13:03.000Z","size":1748,"stargazers_count":3,"open_issues_count":4,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T11:51:08.115Z","etag":null,"topics":["nodejs","playwright","test-automation","visual-studio-code","visual-studio-code-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=jaktestowac-pl.playwright-helpers","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jaktestowac.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-08-08T17:24:10.000Z","updated_at":"2025-04-16T00:13:07.000Z","dependencies_parsed_at":"2024-08-18T18:58:44.769Z","dependency_job_id":"17463298-ed7b-4d85-85d6-0a0869fdd7f9","html_url":"https://github.com/jaktestowac/vscode-playwright-helpers","commit_stats":{"total_commits":194,"total_committers":2,"mean_commits":97.0,"dds":"0.020618556701030966","last_synced_commit":"06037360e15f7cf0c95b8ac0317496cb11fed37a"},"previous_names":["jaktestowac/vscode-playwright-helpers"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jaktestowac/vscode-playwright-helpers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaktestowac%2Fvscode-playwright-helpers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaktestowac%2Fvscode-playwright-helpers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaktestowac%2Fvscode-playwright-helpers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaktestowac%2Fvscode-playwright-helpers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jaktestowac","download_url":"https://codeload.github.com/jaktestowac/vscode-playwright-helpers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaktestowac%2Fvscode-playwright-helpers/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266592209,"owners_count":23953109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nodejs","playwright","test-automation","visual-studio-code","visual-studio-code-extension"],"created_at":"2024-09-24T19:43:15.001Z","updated_at":"2025-07-23T00:06:20.267Z","avatar_url":"https://github.com/jaktestowac.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/playwright-logo.png?raw=true\" width=\"200px\" alt=\"Playwright Logo\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eVS Code - Playwright Helpers\u003c/h1\u003e\n\n# Description\n\nThis Visual Studio Code extension adds predefined commands for **Node.js Playwright**.\n\n# Table of Contents\n\n- [Description](#description)\n- [How to Use This Extension in VS Code](#how-to-use-this-extension-in-vs-code)\n  - [Command Palette](#command-palette)\n  - [Side View](#side-view)\n- [Features](#features)\n\n  - [Commands List](#commands-list)\n  - [Command Composer](#command-composer)\n  - [Codegen Composer](#codegen-composer)\n  - [Trace Viewer](#trace-viewer)\n  - [Report Viewer](#report-viewer)\n  - [Playwright Scripts Runner](#playwright-scripts-runner)\n  - [Context Menu Commands](#context-menu-commands)\n  - [CodeLenses](#codelenses)\n\n- [Contributing](#contributing)\n- [For more information](#for-more-information)\n\n# How to Use This Extension in VS Code\n\n## Side View\n\nExtensions adds new view called **Playwright Helpers**. You can open it by clicking on the icon in the Activity Bar.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-1.gif?raw=true\" alt=\"Preview of Side View\"\u003e\n\u003c/p\u003e\n\nThe Side View provides a convenient way to access all features from this extension.\n\n## Command Palette\n\nThis extension provides a set of commands that can be executed from the Command Palette.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-2.gif?raw=true\" alt=\"Preview of Command Palette\"\u003e\n\u003c/p\u003e\n\n1. Open the Command Palette by pressing `Ctrl+Shift+P` (Windows/Linux) or `Cmd+Shift+P` (macOS).\n2. Type the name of the command you wish to execute and select it from the list.\n3. All commands from this extensions are grouped under category **PW Helpers**, e.g.:\n\n```\nPW Helpers: Initiate New Playwright Project\n```\n\n# Features\n\nThis extension provides the following features:\n\n- **Commands** for Playwright\n- **Running scripts** from package.json\n- **Command Composer** - allows you to compose your own commands\n- **Codegen Composer** - allows you to compose your own codegen commands\n- **Trace Viewer** - allows you to view Playwright traces\n- **Report Viewer** - allows you to view Playwright reports\n- **Context Menu Commands** - additional commands in the context menu\n- **CodeLenses** - additional CodeLenses for test annotations and assertions\n\n## Commands List\n\nThe extension provides the following commands, organized by category:\n\n### Playwright\n\n| Command                                            | Description                                 |\n| -------------------------------------------------- | ------------------------------------------- |\n| `playwright-helpers.checkPlaywrightVersion`        | Check Version - Playwright                  |\n| `playwright-helpers.checkPlaywrightTestVersion`    | Check Version - @playwright/test            |\n| `playwright-helpers.checkForPlaywrightTestUpdates` | Check Updates - @playwright/test            |\n| `playwright-helpers.installPlaywrightTest`         | Install @playwright/test (specific version) |\n| `playwright-helpers.installLatestPlaywrightTest`   | Install/Update Latest @playwright/test      |\n| `playwright-helpers.uninstallPlaywrightTest`       | Uninstall @playwright/test                  |\n| `playwright-helpers.installNextPlaywrightTest`     | Install/Update Next @playwright/test        |\n\n### Browsers\n\n| Command                                               | Description                                          |\n| ----------------------------------------------------- | ---------------------------------------------------- |\n| `playwright-helpers.installAllPlaywrightBrowsers`     | Install All Playwright Browsers                      |\n| `playwright-helpers.installChromiumPlaywrightBrowser` | Install Chromium Playwright Browser                  |\n| `playwright-helpers.installWebkitPlaywrightBrowser`   | Install Webkit Playwright Browser                    |\n| `playwright-helpers.installFirefoxPlaywrightBrowser`  | Install Firefox Playwright Browser                   |\n| `playwright-helpers.uninstallAllPlaywrightBrowsers`   | Uninstall All Playwright Browsers                    |\n| `playwright-helpers.uninstallPlaywrightBrowsers`      | Uninstall Playwright Browsers (current project only) |\n\n### Project\n\n| Command                                     | Description                            |\n| ------------------------------------------- | -------------------------------------- |\n| `playwright-helpers.initNewProject`         | Init New Project                       |\n| `playwright-helpers.initNewProjectQuick`    | Init New Project Quick (with defaults) |\n| `playwright-helpers.installPackages`        | Install Node Packages                  |\n| `playwright-helpers.checkOutdatedPackages`  | Check Outdated Packages                |\n| `playwright-helpers.updateOutdatedPackages` | Update Outdated Packages               |\n| `playwright-helpers.installPackagesNpmCi`   | Install Node Packages (package-lock)   |\n\n### Testing\n\n| Command                                           | Description                    |\n| ------------------------------------------------- | ------------------------------ |\n| `playwright-helpers.openUiMode`                   | Open UI Mode                   |\n| `playwright-helpers.runCodegen`                   | Run Codegen                    |\n| `playwright-helpers.runCodegenWithSaveStorage`    | Run Codegen with Save Storage  |\n| `playwright-helpers.runCodegenWithLoadStorage`    | Run Codegen with Load Storage  |\n| `playwright-helpers.runShowReport`                | Run Show Report                |\n| `playwright-helpers.runDefaultTests`              | Run Tests                      |\n| `playwright-helpers.runDefaultTestsMultipleTimes` | Run Tests Multiple Times       |\n| `playwright-helpers.runTestsFiles`                | Run Test File                  |\n| `playwright-helpers.runTestsWithDebug`            | Run Tests with Debug           |\n| `playwright-helpers.runTestsWithHeadedBrowser`    | Run Tests with Headed Browser  |\n| `playwright-helpers.runTestsWithTitle`            | Run Tests with Title           |\n| `playwright-helpers.runOnlyChangedTests`          | Run Only Changed Tests         |\n| `playwright-helpers.runSpecificTestProject`       | Run Specific Test Project      |\n| `playwright-helpers.runTestsWithWorkers`          | Run Tests with Workers         |\n| `playwright-helpers.runTestWithUpdateSnapshots`   | Run Test with Update Snapshots |\n| `playwright-helpers.runOnlyLastFailedTests`       | Run Only Last Failed Tests     |\n| `playwright-helpers.runTestsWithTimeout`          | Run Tests with Timeout         |\n| `playwright-helpers.runTestsWithReporter`         | Run Tests with Reporter        |\n| `playwright-helpers.showTrace`                    | Show Trace                     |\n\n### MCP (Model Context Protocol)\n\n| Command                               | Description        |\n| ------------------------------------- | ------------------ |\n| `playwright-helpers.addPlaywrightMcp` | Add Playwright MCP |\n| `playwright-helpers.listMcpServer`    | List MCP Servers   |\n| `playwright-helpers.addMcpServer`     | Add MCP Servers    |\n\n### Miscellaneous\n\n| Command                                          | Description                         |\n| ------------------------------------------------ | ----------------------------------- |\n| `playwright-helpers.closeAllTerminals`           | Close All Terminals                 |\n| `playwright-helpers.listInstalledPackages`       | List Installed Packages             |\n| `playwright-helpers.listInstalledGlobalPackages` | List Installed Global Packages      |\n| `playwright-helpers.listSystemInfo`              | List System Info (using envinfo)    |\n| `playwright-helpers.runPrettierOnAllFiles`       | Run Prettier on All Files           |\n| `playwright-helpers.openVSCodeSettingsFile`      | Open VS Code Settings File          |\n| `playwright-helpers.openVSCodeSettingsFileMacOs` | Open VS Code Settings File (Mac OS) |\n| `playwright-helpers.refreshPlaywrightScripts`    | Refresh Playwright Scripts View     |\n| `playwright-helpers.refreshTraces`               | Refresh Playwright Traces           |\n| `playwright-helpers.refreshReports`              | Refresh Playwright Reports          |\n| `playwright-helpers.toggleHideShowCommands`      | Toggle Hide/Show Commands           |\n\n## Command Composer\n\nThe Command Composer allows you to create custom Playwright commands with various options and parameters.\n\nFrom graphical user interface you can select options described in documentation and then execute the command:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-3.gif?raw=true\" alt=\"Preview of Command Composer\"\u003e\n\u003c/p\u003e\n\nYou can configure the following settings:\n\n- **Config file path** - Specify a custom configuration file (default: playwright.config.ts)\n- **TypeScript config** - Use a custom tsconfig (default: tsconfig.test.json)\n- **Workers** - Set the number of parallel workers (default: 1)\n- **Debug mode** - Run tests in debug mode\n- **Headed mode** - Run tests in headed browser mode\n- **Test filtering** - Run only changed files, tests with specific title, etc.\n- **Timeout** - Set custom timeout in milliseconds (default: 60000)\n- **Retries** - Configure test retry count\n- **Reporters** - Choose from multiple reporter options: dot, line, list, json, junit, blob, verbose, github\n- **Projects** - Run tests for specific project configuration\n- **Snapshots** - Update or ignore snapshots\n- **Tracing** - Configure when trace files should be created\n- **Sharding** - Run a specific shard of tests for distributed execution\n\n## Codegen Composer\n\nThe Codegen Composer allows you to compose your own codegen command by selecting the desired options and parameters:\n\n- **Output** - Save the generated script to a file\n- **Target language** - Choose from multiple languages and frameworks:\n  - JavaScript\n  - Playwright Test\n  - Python (sync, async, pytest)\n  - C# (plain, MSTest, NUnit)\n  - Java (plain, JUnit)\n- **Browser** - Select which browser to use (chromium, firefox, webkit)\n- **Device emulation** - Emulate specific devices (iPhone, iPad, etc.)\n- **Geolocation** - Set geolocation for testing location-aware applications\n- **Language/Locale** - Test with specific language settings\n- **Viewport size** - Configure custom viewport dimensions\n- **Color scheme** - Test with light or dark mode\n- **Storage** - Save and load browser storage state\n- **Network** - Configure proxy settings, save HAR files\n- **Timezone** - Test with specific timezone settings\n- **User agent** - Set custom user agent string\n\n## Trace Viewer\n\nThe Trace Viewer provides a convenient way to view and analyze Playwright traces. Features include:\n\n- Trace file browser in the side panel (tree view)\n- Quick access to open traces in the Playwright Trace Viewer\n- Quick access to run the trace viewer on selected files\n- Context menu integration for `.zip` trace files\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-5-trace.gif?raw=true\" alt=\"Preview of Trace Viewer\"\u003e\n\u003c/p\u003e\n\n## Report Viewer\n\nThe Report Viewer makes it easy to view and analyze Playwright HTML reports:\n\n- Report file browser in the side panel\n- Quick access to open reports in your browser\n- Context menu integration for report `index.html` files\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-6-reports.gif?raw=true\" alt=\"Preview of Report Viewer\"\u003e\n\u003c/p\u003e\n\n## Playwright Scripts Runner\n\nRun your Playwright scripts defined in package.json directly from the VS Code interface:\n\n- View all available npm scripts related to Playwright\n- Run scripts with a single click\n- See script execution status\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-4-scripts.gif?raw=true\" alt=\"Preview of Playwright Scripts Runner\"\u003e\n\u003c/p\u003e\n\n## Settings\n\nThe extension provides several settings to customize your experience:\n\n- **Reuse Terminal** - Control whether to reuse the existing terminal or create a new one\n- **Playwright Verbose API logs** - Enable detailed API logging\n- **Never Open HTML Report** - Disable automatic opening of HTML reports\n- **Test Annotations CodeLens** - Enable or disable CodeLens for test annotations\n\n## Context Menu Commands\n\nAdditional commands available in the Explorer context menu:\n\n- **Show Playwright Trace** - View trace files directly from the Explorer\n- **Show Playwright Reports** - Open HTML reports from the Explorer\n- **Run Playwright Tests from This File** - Execute tests in a specific file\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-show-trace-from-context.gif?raw=true\" alt=\"Preview of Show Trace from Context Menu\"\u003e\n\u003c/p\u003e\n\n- **Show Playwright Reports** (on `index.html`) - you can quickly view the report via clicking on `index.html` file in the Explorer and selecting `Show Report` from the context menu.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/jaktestowac/vscode-playwright-helpers/blob/main/media/preview-show-report-from-context.gif?raw=true\" alt=\"Preview of Show Report from Context Menu\"\u003e\n\u003c/p\u003e\n\n- **Run Playwright Tests from This File** (on `*.spec.ts`) - you can quickly run the tests via clicking on `.spec.ts` file in the Explorer and selecting `Run Tests` from the context menu.\n\n## CodeLenses\n\nThe extension provides additional CodeLenses for the following items:\n\n- test annotations (`test`, `only`, `skip`) - you can quickly change the test annotations via clicking on the annotation above the test\n- assertions (`expect`) - you can quickly add **soft** or **hard** assertions via clicking on the annotation above the `expect`\n\n# Contributing\n\nThis project is open source and we welcome contributions from the community. If you would like to contribute, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Make your changes and commit them to your branch.\n4. Push your branch to your forked repository.\n5. Open a pull request to merge your changes into the main repository.\n\nPlease ensure that your code follows our coding guidelines and includes appropriate tests. We appreciate your contributions and look forward to reviewing your pull requests!\n\n# For more information\n\n- [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)\n- [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)\n\n**Enjoy!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaktestowac%2Fvscode-playwright-helpers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaktestowac%2Fvscode-playwright-helpers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaktestowac%2Fvscode-playwright-helpers/lists"}