From 55f69133569a65fb310e8317ac1f57fb93c5e8c8 Mon Sep 17 00:00:00 2001
From: Yury Semikhatsky <yurys@chromium.org>
Date: Thu, 7 Nov 2024 16:14:53 -0800
Subject: [PATCH] docs: note about screenshot environment

Fixes https://github.com/microsoft/playwright/issues/33375
---
 docs/src/test-snapshots-js.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/src/test-snapshots-js.md b/docs/src/test-snapshots-js.md
index d2c7606adf..a1ece1a6e5 100644
--- a/docs/src/test-snapshots-js.md
+++ b/docs/src/test-snapshots-js.md
@@ -16,6 +16,10 @@ test('example test', async ({ page }) => {
 });
 ```
 
+:::warning
+Browser rendering can vary based on the host OS, version, settings, hardware, power source (battery vs. power adapter), headless mode, and other factors. For consistent screenshots, run tests in the same environment where the baseline screenshots were generated.
+:::
+
 ## Generating screenshots
 
 When you run above for the first time, test runner will say: