@@ Line 1: / Line 1: @@
-== Installing browsers for playwright under NixOS ==
+Playwright Test is an end-to-end test framework for modern web apps. It bundles test runner, assertions, isolation, parallelization and rich tooling.
-Normally, at first run, [https://playwright.dev/ playwright] will tell you to run <code>playwright install</code>. The purpose of this is to install browsers for you that it can then use for testing. The installation itself will technically work. Unfortunately, the installed browsers will not be suitable to be used inside NixOS. This is due to the fact that dependencies will not be at places where the browsers expect them to be. To mitigate this problem, nixpkgs has a package called <code>playwright-driver.browsers</code>. Before you start your script, make sure to set
+== Installing browsers for Playwright under NixOS ==
-<syntaxHighlight lang=nix>
+At first run, Playwright will prompt the user to run <code>playwright install</code> to install browsers. However, the browsers will not function due to missing dependencies.
-export PLAYWRIGHT_BROWSERS_PATH=/path/to/drivers
-</syntaxHighlight>
+The nixpkgs package <code>playwright-driver.browsers</code> provides a packaged form of the browsers that can be assigned to the PLAYWRIGHT_BROWSERS_PATH environment variable.
-You can for example put this <code>shell.nix</code> in the directory with your playwright-related code:
+An example <code>shell.nix</code> that installs [[ Visual Studio Code ]] and Playwright.
 <syntaxHighlight lang=nix>
 { pkgs ? import <nixpkgs> {} }:
    pkgs.mkShell {
-     nativeBuildInputs = [
+     nativeBuildInputs = with pkgs; [
-       pkgs.playwright-driver.browsers
+       vscode # if you want vscode
+      nodejs_latest
+      playwright-driver.browsers # !!! Make sure it has the same version as npm's version!!
      ];
@@ Line 18: / Line 20: @@
        export PLAYWRIGHT_BROWSERS_PATH=${pkgs.playwright-driver.browsers}
        export PLAYWRIGHT_SKIP_VALIDATE_HOST_REQUIREMENTS=true
+      export PLAYWRIGHT_HOST_PLATFORM_OVERRIDE="ubuntu-24.04" # Seems like it is not needed?
      '';
 }
 </syntaxHighlight>
-== Playwright with Visual Studio Code ==
+{{Note|The version of Playwright in Nixpkgs and your node developer environment (in <code>package[-lock].json</code>) must match. See [https://www.nixhub.io/packages/playwright nixhub] to see if there is a version that matches npm in nixpkgs, if not you can also downgrade npm's version via <code>npm install playwright@nixversion</code>. See also [https://discourse.nixos.org/t/running-playwright-tests/25655 this discussion].}}
-If you are using playwright with [https://wiki.nixos.org/wiki/Visual_Studio_Code Visual Studio Code], you may want to add <code>vscode</code> to the package list shown earlier. With Visual Studio Code installed you can  run <code>nix-shell --run "code ."</code> to open your playwright-related directory.
+== Using flake ==
+This can easily be adapted within a flake like:
+<syntaxHighlight lang=nix>
+{
+  description = "A very basic flake";
-Don't forget to install the <code>Playwright Test for VSCode</code> extension in Visual Studio Code.
+  inputs = {
+    flake-parts.url = "github:hercules-ci/flake-parts";
+    nixpkgs.url = "github:nixos/nixpkgs";
+  };
+  outputs = { flake-parts, ... } @ inputs: flake-parts.lib.mkFlake { inherit inputs; } {
+    perSystem = { config, self', inputs', pkgs, system, ... }: {
+      devShells.default = pkgs.mkShell {
+        nativeBuildInputs = with pkgs; [
+          nodejs_latest
+          playwright-driver.browsers
+        ];
-Then you should be able to run your tests in Visual Studio Code.
+        shellHook = ''
+          export PLAYWRIGHT_BROWSERS_PATH=${pkgs.playwright-driver.browsers}
+          export PLAYWRIGHT_SKIP_VALIDATE_HOST_REQUIREMENTS=true;
+        '';
+      };
+    };
+    # Declared systems that your flake supports. These will be enumerated in perSystem
+    systems = [ "x86_64-linux" "aarch64-linux" "x86_64-darwin" "aarch64-darwin" ];
+  };
+}
-{{Note|Keep in mind that you need to use the same version of playwright in your node playwright project as in your nixpkgs, or else playwright will try to use browsers versions that aren't installed!}}
+</syntaxHighlight>
-== Playwright with Devenv ==
+== Using Devenv ==
 With [https://devenv.sh/ Devenv] you can also set certain environment variables and pin packages to make playwright work.
@@ Line 132: / Line 161: @@
 }
 </syntaxHighlight>
+== Bun + Playwright ==
+Here is a <code>flake.nix</code> that is working with bun instead of nodejs (working today 2026-01-23).
+Put <code>flake.nix</code>, <code>playwright.config.ts</code>, <code>package.json</code> and <code>tests/example.spec.ts</code> in the root directory of your project and run
+* <code>nix develop</code> to install packages and enter the devShell
+* <code>bun install</code> to download playwright dependencies to node_modules
+* <code>bun --bun playwright test --headed</code> to test the setup
+* <code>bun playwright test --headed</code> to verify that without <code>--bun</code> flag the nodejs version is run and bun library is not available.
+==== flake.nix ====
+<syntaxHighlight lang=nix>
+{
+  description = "Bun + Playwright dev shell";
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+  outputs =
+    {
+      self,
+      nixpkgs,
+      flake-utils,
+      ...
+    }:
+    flake-utils.lib.eachDefaultSystem (
+      system:
+      let
+        pkgs = import nixpkgs { inherit system; };
+        browsers =
+          (builtins.fromJSON (builtins.readFile "${pkgs.playwright-driver}/browsers.json")).browsers;
+        chromium-rev = (builtins.head (builtins.filter (x: x.name == "chromium") browsers)).revision;
+      in
+      {
+        devShells.default = pkgs.mkShell {
+          packages = with pkgs; [
+            bun
+            playwright-driver.browsers
+          ];
+          shellHook = ''
+            export PLAYWRIGHT_LAUNCH_OPTIONS_EXECUTABLE_PATH="${pkgs.playwright-driver.browsers}/chromium-${chromium-rev}/chrome-linux64/chrome";
+          '';
+        };
+      }
+    );
+}
+</syntaxHighlight>
+==== playwright.config.ts ====
+<syntaxHighlight lang=typescript>
+import { defineConfig, devices } from '@playwright/test';
+export default defineConfig({
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        ...devices['Desktop Chrome'],
+        launchOptions: {
+          executablePath: process.env.PLAYWRIGHT_LAUNCH_OPTIONS_EXECUTABLE_PATH,
+        },
+      },
+    },
+  ],
+});
+</syntaxHighlight>
+==== package.json ====
+<syntaxHighlight lang=json>
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "playwright_with_bun",
+  "version": "1.0.0",
+  "description": "Playwright tests with Bun",
+  "scripts": {
+    "test": "bun --bun playwright test"
+  },
+  "dependencies": {
+    "@playwright/test": "^1.58.0",
+    "playwright-core": "^1.58.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.6"
+  }
+}
+</syntaxHighlight>
+==== tests/example.spec.ts ====
+<syntaxHighlight lang=typescript>
+import { test, expect } from '@playwright/test';
+test('basic test', async ({ page }) => {
+  await page.goto('https://example.com');
+  await expect(page).toHaveTitle(/Example/);
+});
+test('Bun.stripANSI available', async () => {
+  expect(typeof Bun.stripANSI).toBe('function');
+});
+</syntaxHighlight>
+==== test output ====
+<syntaxHighlight lang="shell-session" style="color: inherit; background-color: #000;">
+[michi@nixos:~/dev/playwright_with_bun]$ bun --bun playwright test --headed
+Running 2 tests using 1 worker
+  ✓  1 [chromium] › tests/example.spec.ts:3:0 › basic test (1.1s)
+  ✓  2 [chromium] › tests/example.spec.ts:8:0 › Bun.stripANSI available (3ms)
+passed (2.9s)
+[michi@nixos:~/dev/playwright_with_bun]$ bun playwright test --headed
+ReferenceError: Bun is not defined
+    at Object.<anonymous> (/home/michi/dev/playwright_with_bun/playwright.config.ts:10:27)
+    at Module._compile (node:internal/modules/cjs/loader:1706:14)
+    at Module.newCompile2 (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/third_party/pirates.js:46:29)
+    at Object.<anonymous> (node:internal/modules/cjs/loader:1839:10)
+    at Object.newLoader2 [as .ts] (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/third_party/pirates.js:52:22)
+    at Module.load (node:internal/modules/cjs/loader:1441:32)
+    at Function._load (node:internal/modules/cjs/loader:1263:12)
+    at TracingChannel.traceSync (node:diagnostics_channel:328:14)
+    at wrapModuleLoad (node:internal/modules/cjs/loader:237:24)
+    at Module.require (node:internal/modules/cjs/loader:1463:12)
+    at require (node:internal/modules/helpers:147:16)
+    at requireOrImport (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/transform/transform.js:225:18)
+    at loadUserConfig (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/common/configLoader.js:107:89)
+    at loadConfig (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/common/configLoader.js:119:28)
+    at loadConfigFromFile (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/common/configLoader.js:331:10)
+    at runTests (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/program.js:197:18)
+    at i.<anonymous> (/home/michi/dev/playwright_with_bun/node_modules/playwright/lib/program.js:70:7)
+error: "playwright" exited with code 1
+</syntaxHighlight>
+=== Notes ===
+* The [https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright Playwright Test for VSCode] extension does not currently support Bun. The Node.js runtime may be used instead.
+* Playwright version 1.58 is the first version where the command <code>bun --bun playwright test</code> works.
+* see also https://github.com/MBanucu/bun-playwright-nix

Playwright: Difference between revisions