From aefecb35c7fbed85d5b081c5394de70d6c770dbf Mon Sep 17 00:00:00 2001
From: Martin Fischer <martin@push-f.com>
Date: Mon, 6 Mar 2023 19:47:06 +0100
Subject: [PATCH 1/2] feat(cli): better error message for ChromeDriver version
 mismatch

Fixes #679.
---
 packages/cli/src/bin/index.ts | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/packages/cli/src/bin/index.ts b/packages/cli/src/bin/index.ts
index 541a2d9e..15c4678c 100644
--- a/packages/cli/src/bin/index.ts
+++ b/packages/cli/src/bin/index.ts
@@ -15,6 +15,7 @@ import {
 import axeTestUrls from '../lib/axe-test-urls';
 import event from '../lib/events';
 import { startDriver } from '../lib/webdriver';
+import { error as selenium_error } from 'selenium-webdriver';
 
 const cli = async (
   args: OptionValues,
@@ -107,7 +108,31 @@ const cli = async (
     disable
   };
   try {
-    const outcome = await axeTestUrls(urls, testPageConfigParams, events);
+    let outcome;
+    try {
+      outcome = await axeTestUrls(urls, testPageConfigParams, events);
+    } catch (e) {
+      // Provide a more user-friendly error message when there's a ChromeDriver/Chrome version mismatch.
+      if (
+        e instanceof selenium_error.SessionNotCreatedError &&
+        e.message.includes(
+          'This version of ChromeDriver only supports'
+          // This string has to match the error message printed by chromedriver, see
+          // https://chromium.googlesource.com/chromium/src/+/refs/tags/110.0.5481.194/chrome/test/chromedriver/chrome_launcher.cc#300.
+        )
+      ) {
+        console.error(error('Error: %s'), e.message);
+        console.log(`\nPlease install a matching version of ChromeDriver and run axe with the --chromedriver-path option:
+
+    $ npm install -g chromedriver@<version>
+    $ axe --chromedriver-path $(npm root -g)/chromedriver/bin/chromedriver <url...>
+
+(where <version> is the first number of the "current browser version" reported above.)`);
+        process.exit(2);
+      } else {
+        throw e;
+      }
+    }
     if (silentMode) {
       process.stdout.write(JSON.stringify(outcome, null, 2));
       return;

From 9693d7dddaaf82a9fa89e5756860c0855af42eb9 Mon Sep 17 00:00:00 2001
From: Steven Lambert <steven.lambert@deque.com>
Date: Tue, 22 Aug 2023 16:27:19 -0600
Subject: [PATCH 2/2] reduce branch coverage to 91

---
 packages/cli/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/cli/package.json b/packages/cli/package.json
index 4e87abea..7fef3338 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -75,7 +75,7 @@
       "html"
     ],
     "statements": 95,
-    "branches": 92,
+    "branches": 91,
     "functions": 94,
     "lines": 95,
     "exclude": [