Rename reportError to logError to avoid new global type

There's a relatively recent addition to the DOM global types, due to a
real method available for web workers, which means it's very very easy
to accidentally call reportError without importing it, which fails
everywhere except web workers, where it merely does completely the wrong
thing.

logError is exactly the same, but without that problem.

Author: pimterry

src/api/api-model.ts

@@ -6,7 +6,7 @@ import { getSystemProxy } from 'os-proxy-config';
 
 import { SERVER_VERSION } from "../constants";
 import { delay } from '../util/promise';
-import { reportError, addBreadcrumb } from '../error-tracking';
+import { logError, addBreadcrumb } from '../error-tracking';
 import { HtkConfig } from "../config";
 import { ActivationError, Interceptor } from "../interceptors";
 import { getDnsServer } from '../dns-server';
@@ -170,7 +170,7 @@ export class ApiModel {
         // After 30s, don't stop activating, but report an error if we're not done yet
         let activationDone = false;
         delay(30000).then(() => {
-            if (!activationDone) reportError(`Timeout activating ${id}`)
+            if (!activationDone) logError(`Timeout activating ${id}`)
         });
 
         try {
@@ -183,7 +183,7 @@ export class ApiModel {
             activationDone = true;
             if (activationError.reportable !== false) {
                 addBreadcrumb(`Failed to activate ${id}`, { category: 'interceptor' });
-                reportError(err);
+                logError(err);
             }
             return {
                 success: false,
@@ -202,7 +202,7 @@ export class ApiModel {
         const interceptor = this.interceptors[id];
         if (!interceptor) throw new Error(`Unknown interceptor ${id}`);
 
-        await interceptor.deactivate(proxyPort, options).catch(reportError);
+        await interceptor.deactivate(proxyPort, options).catch(logError);
         return { success: !interceptor.isActive(proxyPort) };
     }
 
@@ -219,7 +219,7 @@ export class ApiModel {
 const withFallback = <R>(p: () => Promise<R>, timeoutMs: number, defaultValue: R) =>
     Promise.race([
         p().catch((error) => {
-            reportError(error);
+            logError(error);
             return defaultValue;
         }),
         delay(timeoutMs).then(() => defaultValue)

src/api/rest-api.ts

@@ -12,7 +12,7 @@ import type {
 import type { ParsedQs } from 'qs';
 
 import { ErrorLike, StatusError } from '../util/error';
-import { reportError } from '../error-tracking';
+import { logError } from '../error-tracking';
 import { ApiModel } from './api-model';
 import * as Client from '../client/client-types';
 
@@ -175,7 +175,7 @@ function handleErrors<
             const error = e as ErrorLike;
 
             console.log(`Error handling request to ${req.path}: ${error.message ?? error}`);
-            reportError(error);
+            logError(error);
 
             // Use default error handler if response started (kills the connection)
             if (res.headersSent) return next(error)

src/browsers.ts

@@ -10,7 +10,7 @@ import {
     update as updateBrowserCacheCb
 } from '@httptoolkit/browser-launcher';
 
-import { reportError } from './error-tracking';
+import { logError } from './error-tracking';
 import { delay } from './util/promise';
 import { isErrorLike } from './util/error';
 import { readFile, deleteFile } from './util/fs';
@@ -40,7 +40,7 @@ export async function checkBrowserConfig(configPath: string) {
             if (isErrorLike(err) && err.code === 'ENOENT') return;
 
             console.error('Failed to clear broken config file:', err);
-            reportError(err);
+            logError(err);
         });
     }
 }
@@ -63,13 +63,13 @@ function getLauncher(configPath: string) {
                 // Need to reload the launcher after updating the cache:
                 launcher = getBrowserLauncher(browserConfig);
             } catch (e) {
-                reportError(e)
+                logError(e)
             }
         });
 
         // Reset & retry if this fails somehow:
         launcher.catch((e) => {
-            reportError(e);
+            logError(e);
             launcher = undefined;
         });
     }
@@ -92,7 +92,7 @@ export const launchBrowser = async (url: string, options: LaunchOptions, configP
         // fallback error handling: log & report & don't crash.
         if (browserInstance.process.listenerCount('error') === 1) {
             console.log('Browser launch error');
-            reportError(e);
+            logError(e);
         }
     });
 

src/commands/start.ts

@@ -22,7 +22,7 @@ function maybeBundleImport<T>(moduleName: string): T {
         return require('../' + moduleName);
     }
 }
-const { initErrorTracking, reportError } = maybeBundleImport<ErrorTrackingModule>('error-tracking');
+const { initErrorTracking, logError } = maybeBundleImport<ErrorTrackingModule>('error-tracking');
 initErrorTracking();
 
 import { Command, flags } from '@oclif/command'
@@ -49,7 +49,7 @@ class HttpToolkitServer extends Command {
             configPath: flags.config,
             authToken: envToken || flags.token
         }).catch(async (error) => {
-            await reportError(error);
+            await logError(error);
             throw error;
         });
     }
@@ -65,7 +65,7 @@ class HttpToolkitServer extends Command {
 
         // Be careful - if the server path isn't clearly ours somehow, ignore it.
         if (!isOwnedPath(serverUpdatesPath)) {
-            reportError(`Unexpected server updates path (${serverUpdatesPath}), ignoring`);
+            logError(`Unexpected server updates path (${serverUpdatesPath}), ignoring`);
             return;
         }
 
@@ -84,19 +84,19 @@ class HttpToolkitServer extends Command {
             filename !== '.DS_Store' // Meaningless Mac folder metadata
         )) {
             console.log(serverPaths);
-            reportError(
+            logError(
                 `Server path (${serverUpdatesPath}) contains unexpected content, ignoring`
             );
             return;
         }
 
-        const maybeReportError = (error: Error & { code?: string }) => {
+        const maybeLogError = (error: Error & { code?: string }) => {
             if ([
                 'EBUSY',
                 'EPERM'
             ].includes(error.code!)) return;
 
-            else reportError(error);
+            else logError(error);
         };
 
         if (serverPaths.every((filename) => {
@@ -107,7 +107,7 @@ class HttpToolkitServer extends Command {
             // a new server standalone (not just from an update), because otherwise the
             // update dir can end up in a broken state. Better to clear it completely.
             console.log("Downloaded server directory is entirely outdated, deleting it");
-            deleteFolder(serverUpdatesPath).catch(maybeReportError);
+            deleteFolder(serverUpdatesPath).catch(maybeLogError);
         } else {
             // Some of the servers are outdated, but not all (maybe it includes us).
             // Async delete all server versions older than this currently running version.
@@ -116,7 +116,7 @@ class HttpToolkitServer extends Command {
 
                 if (version && semver.lt(version, currentVersion)) {
                     console.log(`Deleting old server ${filename}`);
-                    deleteFolder(path.join(serverUpdatesPath, filename)).catch(maybeReportError);
+                    deleteFolder(path.join(serverUpdatesPath, filename)).catch(maybeLogError);
                 }
             });
         }
@@ -151,7 +151,7 @@ function isOwnedPath(input: string) {
     if (input.split(path.sep).includes('httptoolkit-server')) {
         return true;
     } else {
-        reportError(`Unexpected unowned path ${input}`);
+        logError(`Unexpected unowned path ${input}`);
         return false;
     }
 }

src/error-tracking.ts

@@ -113,7 +113,7 @@ export function addBreadcrumb(message: string, data: Sentry.Breadcrumb) {
     Sentry.addBreadcrumb(Object.assign({ message }, data));
 }
 
-export function reportError(error: Error | string | unknown): undefined | Promise<void> {
+export function logError(error: Error | string | unknown): undefined | Promise<void> {
     console.warn(error);
     if (!sentryInitialized) return;
 

src/index.ts

@@ -18,7 +18,7 @@ import updateCommand from '@oclif/plugin-update/lib/commands/update';
 
 import { HttpToolkitServerApi } from './api/api-server';
 import { checkBrowserConfig } from './browsers';
-import { reportError } from './error-tracking';
+import { logError } from './error-tracking';
 import { MOCKTTP_ALLOWED_ORIGINS } from './constants';
 
 import { delay } from './util/promise';
@@ -207,7 +207,7 @@ export async function runHTK(options: {
                 }
 
                 console.log(error);
-                reportError('Failed to check for updates');
+                logError('Failed to check for updates');
             })
         );
     });

src/interceptors/android/adb-commands.ts

@@ -1,7 +1,7 @@
 import * as stream from 'stream';
 import * as path from 'path';
 import adb, * as Adb from '@devicefarmer/adbkit';
-import { reportError } from '../../error-tracking';
+import { logError } from '../../error-tracking';
 import { isErrorLike } from '../../util/error';
 import { delay, waitUntil } from '../../util/promise';
 import { getCertificateFingerprint, parseCert } from '../../certificates';
@@ -35,7 +35,7 @@ export function createAdbClient() {
 
     // We listen for errors and report them. This only happens if adbkit completely
     // fails to handle or listen to a connection error. We'd rather report that than crash.
-    client.on('error', reportError);
+    client.on('error', logError);
 
     return client;
 }
@@ -92,7 +92,7 @@ export const getConnectedDevices = batchCalls(async (adbClient: Adb.Client) => {
             }
             return [];
         } else {
-            reportError(e);
+            logError(e);
             throw e;
         }
     }
@@ -222,7 +222,7 @@ export async function getRootCommand(adbClient: Adb.DeviceClient): Promise<RootC
             : undefined; // Still not root, no luck.
     } catch (e) {
         console.error(e);
-        reportError('ADB root check crashed');
+        logError('ADB root check crashed');
         return undefined;
     } finally {
         // Try to clean up the root test script, just to be tidy

src/interceptors/android/android-adb-interceptor.ts

@@ -6,7 +6,7 @@ import { Interceptor } from '..';
 import { HtkConfig } from '../../config';
 import { generateSPKIFingerprint } from 'mockttp';
 
-import { reportError } from '../../error-tracking';
+import { logError } from '../../error-tracking';
 import { delay } from '../../util/promise';
 import { isErrorLike } from '../../util/error';
 import {
@@ -89,7 +89,7 @@ export class AndroidAdbInterceptor implements Interceptor {
         await bringToFront(
             deviceClient,
             'tech.httptoolkit.android.v1/tech.httptoolkit.android.MainActivity'
-        ).catch(reportError); // Not that important, so we continue if this fails somehow
+        ).catch(logError); // Not that important, so we continue if this fails somehow
 
         // Build a trigger URL to activate the proxy on the device:
         const setupParams = {
@@ -225,7 +225,7 @@ export class AndroidAdbInterceptor implements Interceptor {
             ]);
             console.log('Android Chrome flags set');
         } catch (e) {
-            reportError(e);
+            logError(e);
         }
     }
 }

src/interceptors/android/fetch-apk.ts

@@ -6,7 +6,7 @@ import fetch from 'node-fetch';
 
 import { readDir, createTmp, moveFile, deleteFile } from '../../util/fs';
 import { HtkConfig } from '../../config';
-import { reportError } from '../../error-tracking';
+import { logError } from '../../error-tracking';
 
 async function getLatestRelease(): Promise<{ version: string, url: string } | undefined> {
     try {
@@ -53,7 +53,7 @@ async function getLatestLocalApk(config: HtkConfig) {
         else return latestLocalApk;
     } catch (e) {
         console.log("Could not check for local Android app APK", e);
-        reportError(e);
+        logError(e);
     }
 }
 
@@ -131,7 +131,7 @@ export async function streamLatestApk(config: HtkConfig): Promise<stream.Readabl
             const apkOutputStream = new stream.PassThrough({ highWaterMark: 10485760 });
             apkStream.pipe(apkOutputStream);
 
-            updateLocalApk(latestApkRelease.version, apkFileStream, config).catch(reportError);
+            updateLocalApk(latestApkRelease.version, apkFileStream, config).catch(logError);
             return apkOutputStream;
         }
     }
@@ -147,7 +147,7 @@ export async function streamLatestApk(config: HtkConfig): Promise<stream.Readabl
     fetch(latestApkRelease.url).then((apkResponse) => {
         const apkStream = apkResponse.body;
         return updateLocalApk(latestApkRelease.version, apkStream, config);
-    }).catch(reportError);
+    }).catch(logError);
 
     console.log('Streaming local APK, and updating it async');
     return fs.createReadStream(localApk.path);

src/interceptors/chromium-based-interceptors.ts

@@ -15,7 +15,7 @@ import { readFile, deleteFolder } from '../util/fs';
 import { listRunningProcesses, windowsClose, waitForExit } from '../util/process-management';
 import { HideWarningServer } from '../hide-warning-server';
 import { Interceptor } from '.';
-import { reportError } from '../error-tracking';
+import { logError } from '../error-tracking';
 import { WEBEXTENSION_INSTALL } from '../webextension';
 
 const getBrowserDetails = async (config: HtkConfig, variant: string): Promise<Browser | undefined> => {
@@ -135,7 +135,7 @@ abstract class FreshChromiumBasedInterceptor implements Interceptor {
 
                 const profilePath = browserDetails.profile;
                 if (!profilePath.startsWith(this.config.configPath)) {
-                    reportError(
+                    logError(
                         `Unexpected ${this.variantName} profile location, not deleting: ${profilePath}`
                     );
                 } else {