From d908886c03d27d11e89371a63ed66bf05c059850 Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Wed, 20 Mar 2024 21:55:34 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20add=20tip=20about=20running=20ka?=
 =?UTF-8?q?rma=20js=20tests=20on=20mac=20(#12140)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
---
 doc/internals/contributing.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/internals/contributing.rst b/doc/internals/contributing.rst
index b62746806..35f17574d 100644
--- a/doc/internals/contributing.rst
+++ b/doc/internals/contributing.rst
@@ -197,6 +197,14 @@ To run JavaScript tests, use ``npm``::
     npm install
     npm run test
 
+.. tip::
+
+  `karma` requires a Firefox binary to use as a test browser.
+
+  For Unix-based systems, you can specify the path to the Firefox binary using::
+
+    FIREFOX_BIN="/Applications/Firefox.app/Contents/MacOS/firefox" npm test
+
 New unit tests should be included in the ``tests`` directory where
 necessary: