refactor: choose some more expressive names in errorHandling.ts

Author: PhilippMa

src/ElectronBackend/errorHandling/errorHandling.ts

@@ -17,7 +17,7 @@ import { getGlobalBackendState } from '../main/globalBackendState';
 import logger from '../main/logger';
 import { getLoadedFilePath } from '../utils/getLoadedFile';
 
-async function reportListenerErrorInBackend(
+async function showListenerErrorInMessageBox(
   mainWindow: BrowserWindow,
   error: unknown,
 ): Promise<void> {
@@ -40,17 +40,18 @@ async function reportListenerErrorInBackend(
   }
 }
 
-function reportListenerErrorInFrontend(_: BrowserWindow, error: unknown): void {
+function sendListenerErrorToFrontend(_: BrowserWindow, error: unknown): void {
+  // NOTE: these log messages are forwarded to the frontend
   if (error instanceof Error) {
     logger.error(error.message);
   } else {
     logger.error('Unexpected internal error');
   }
 }
 
-export const ListenerErrorReporter = {
-  Backend: reportListenerErrorInBackend,
-  Frontend: reportListenerErrorInFrontend,
+export const ListenerErrorReporting = {
+  ShowMessageBox: showListenerErrorInMessageBox,
+  SendToFrontend: sendListenerErrorToFrontend,
 };
 
 type FuncType<T> = T extends (...args: infer P) => infer R
@@ -68,7 +69,7 @@ export function createVoidListenerCallbackWithErrorHandling<F>(
   reportError: (
     mainWindow: BrowserWindow,
     error: unknown,
-  ) => Promise<void> | void = reportListenerErrorInBackend,
+  ) => Promise<void> | void = showListenerErrorInMessageBox,
 ): (...args: FTParameters<F>) => Promise<void> {
   return async (...args: FTParameters<F>): Promise<void> => {
     try {
@@ -86,7 +87,7 @@ export function createListenerCallbackWithErrorHandling<F>(
   reportError: (
     mainWindow: BrowserWindow,
     error: unknown,
-  ) => Promise<void> | void = reportListenerErrorInBackend,
+  ) => Promise<void> | void = showListenerErrorInMessageBox,
 ): (...args: FTParameters<F>) => Promise<ReturnTypeWithoutPromise<F>> {
   return async (
     ...args: FTParameters<F>

src/ElectronBackend/main/__tests__/listeners.test.ts

@@ -508,7 +508,7 @@ describe('getImportFileSelectSaveLocationListener', () => {
     expect(returnedFilePath).toBe(selectedFilePath);
   });
 
-  it('returns null when no save location was selected', async () => {
+  it('returns an empty string when no save location was selected', async () => {
     const mainWindow = await initWindowAndBackendState();
 
     const listener = getImportFileSelectSaveLocationListener(mainWindow);

src/ElectronBackend/main/listeners.ts

@@ -29,7 +29,7 @@ import { LoadedFileFormat } from '../enums/enums';
 import {
   createListenerCallbackWithErrorHandling,
   createVoidListenerCallbackWithErrorHandling,
-  ListenerErrorReporter,
+  ListenerErrorReporting,
 } from '../errorHandling/errorHandling';
 import { loadInputAndOutputFromFilePath } from '../input/importFromFile';
 import { serializeAttributions } from '../input/parseInputData';
@@ -236,7 +236,7 @@ export function getImportFileConvertAndLoadListener(
 
       return true;
     },
-    ListenerErrorReporter.Frontend,
+    ListenerErrorReporting.SendToFrontend,
   );
 }