Promote the new --devtools command line argument and link to debuggin…

…g online documentation
mozilla · Sep 8, 2022 · 6f58053 · 6f58053
1 parent 94989fa
commit 6f58053
Show file tree

Hide file tree

Showing 4 changed files with 49 additions and 4 deletions.
diff --git a/src/extension-runners/firefox-desktop.js b/src/extension-runners/firefox-desktop.js
@@ -243,6 +243,7 @@ export class FirefoxDesktopExtensionRunner {
       firefoxBinary,
       binaryArgs,
       extensions,
+      devtools,
     });
 
     this.runningInfo.firefox.on('close', () => {

diff --git a/src/firefox/index.js b/src/firefox/index.js
@@ -90,6 +90,7 @@ export type FirefoxRunOptions = {
   binaryArgs?: Array<string>,
   args?: Array<any>,
   extensions: Array<Extension>,
+  devtools: boolean,
 };
 
 /*
@@ -103,6 +104,7 @@ export async function run(
     firefoxBinary,
     binaryArgs,
     extensions,
+    devtools,
   }: FirefoxRunOptions = {}
 ): Promise<FirefoxInfo> {
 
@@ -164,9 +166,13 @@ export async function run(
     throw error;
   });
 
-  log.info(
-    'Use --verbose or open Tools > Web Developer > Browser Console ' +
-    'to see logging');
+  if (!devtools) {
+    log.info('Use --verbose or --devtools to see logging');
+  }
+  if (devtools) {
+    log.info('More info about WebExtensions debugging:');
+    log.info('https://extensionworkshop.com/documentation/develop/debugging/');
+  }
 
   firefox.stderr.on('data', (data) => {
     log.debug(`Firefox stderr: ${data.toString().trim()}`);

diff --git a/tests/functional/fake-firefox-binary.js b/tests/functional/fake-firefox-binary.js
@@ -9,6 +9,7 @@ const REQUEST_INSTALL_ADDON = {
   to: 'fakeAddonsActor',
   type: 'installTemporaryAddon',
   addonPath: process.env.addonPath,
+  openDevTools: false, // Introduced in Firefox 106 (Bug 1787409 / Bug 1789245)
 };
 const REPLY_INSTALL_ADDON = {
   from: 'fakeAddonsActor',

diff --git a/tests/unit/test-firefox/test.firefox.js b/tests/unit/test-firefox/test.firefox.js
@@ -11,6 +11,9 @@ import {fs} from 'mz';
 import * as firefox from '../../../src/firefox/index.js';
 import {onlyInstancesOf, UsageError, WebExtError} from '../../../src/errors.js';
 import {withTempDir} from '../../../src/util/temp-dir.js';
+import {
+  consoleStream, // instance is imported to inspect logged messages
+} from '../../../src/util/logger.js';
 import {
   basicManifest,
   fixturePath,
@@ -240,6 +243,41 @@ describe('firefox', () => {
         });
     });
 
+    it('logs link to debugging docs', async () => {
+      const runner = createFakeFxRunner();
+      consoleStream.flushCapturedLogs();
+      consoleStream.startCapturing();
+
+      const expectedMessage = 'More info about WebExtensions debugging:';
+      const expectedURLToDocs =
+        'https://extensionworkshop.com/documentation/develop/debugging/';
+      await runFirefox({fxRunner: runner, devtools: false});
+      assert.notOk(consoleStream.capturedMessages.find(
+        (msg) => msg.includes(expectedMessage)
+      ));
+      assert.notOk(consoleStream.capturedMessages.find(
+        (msg) => msg.includes(expectedURLToDocs)
+      ));
+
+      consoleStream.flushCapturedLogs();
+
+      await runFirefox({fxRunner: runner, devtools: true});
+      const foundMessage = consoleStream.capturedMessages.find(
+        (msg) => msg.includes(expectedMessage)
+      );
+      const foundDocURL = consoleStream.capturedMessages.find(
+        (msg) => msg.includes(expectedURLToDocs)
+      );
+
+      // Expect the logs to be found.
+      assert.ok(foundMessage);
+      assert.ok(foundDocURL);
+
+      // Expected to be emitted as info level logs.
+      assert.ok(foundMessage?.includes('[info]'));
+      assert.ok(foundDocURL?.includes('[info]'));
+    });
+
   });
 
   describe('copyProfile', () => {
@@ -1003,7 +1041,6 @@ describe('firefox', () => {
         sinon.assert.calledOnce(fakeAsyncFsStat);
       }
     ));
-
   });
 
 });