add error-handling exercise

config.json

@@ -2720,6 +2720,14 @@
         "practices": [],
         "prerequisites": [],
         "difficulty": 2
+      },
+      {
+        "slug": "error-handling",
+        "name": "Error Handling",
+        "uuid": "de1c75f2-2461-4347-b5ca-b3cfaafe4d79",
+        "practices": [],
+        "prerequisites": [],
+        "difficulty": 1
       }
     ]
   },

exercises/practice/error-handling/.docs/instructions.md

@@ -0,0 +1,8 @@
+# Instructions
+
+Implement various kinds of error handling and resource management.
+
+An important point of programming is how to handle errors and close resources even if errors occur.
+
+This exercise requires you to handle various errors.
+Because error handling is rather programming language specific you'll have to refer to the tests for your track to see what's exactly required.

exercises/practice/error-handling/.docs/introduction.md

@@ -0,0 +1,19 @@
+# Error Handling
+
+In this exercise, you will implement a function called `processString` that processes a given input string with proper error handling.
+
+You will learn how to:
+
+- Check input types and handle invalid inputs by throwing errors.
+- Throw custom errors for specific cases (e.g., empty strings).
+- Use a `try...finally` block to ensure certain code runs regardless of success or failure (such as cleanup or logging).
+- Return the uppercase version of the string if it is valid.
+
+Your function should:
+
+- Throw a `TypeError` if the input is not a string.
+- Throw an `Error` with the message `EmptyStringError` if the input string is empty.
+- Return the uppercase form of the input string if valid.
+- Use a `finally` block to log a cleanup message every time the function runs.
+
+This exercise is a great way to practice writing robust functions that can gracefully handle unexpected inputs while always executing necessary cleanup logic.

exercises/practice/error-handling/.gitignore

@@ -0,0 +1,5 @@
+/node_modules
+/bin/configlet
+/bin/configlet.exe
+/package-lock.json
+/yarn.lock

exercises/practice/error-handling/.meta/config.json

@@ -0,0 +1,15 @@
+{
+  "authors": ["Obinna Obi-Akwari"],
+  "files": {
+    "solution": [
+      "error-handling.js"
+    ],
+    "test": [
+      "error-handling.spec.js"
+    ],
+    "example": [
+      ".meta/proof.ci.js"
+    ]
+  },
+  "blurb": "Implement various kinds of error handling and resource management."
+}

exercises/practice/error-handling/.npmrc

@@ -0,0 +1 @@
+audit=false

exercises/practice/error-handling/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Exercism
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

exercises/practice/error-handling/babel.config.js

@@ -0,0 +1,4 @@
+module.exports = {
+  presets: [['@exercism/babel-preset-javascript', { corejs: '3.40' }]],
+  plugins: [],
+};

exercises/practice/error-handling/error-handling.spec.js

@@ -0,0 +1,35 @@
+import { describe, expect, it, jest } from '@jest/globals';
+import { processString } from './error-handling';
+
+describe('Error Handling', () => {
+  it('returns uppercase if valid string', () => {
+    expect(processString('hello')).toBe('HELLO');
+  });
+
+  it('throws TypeError if input is not a string', () => {
+    expect(() => processString(42)).toThrow(TypeError);
+    expect(() => processString(42)).toThrow('input must be a string');
+  });
+
+  it('throws Error with EmptyStringError if string is empty', () => {
+    expect(() => processString('')).toThrow(Error);
+    expect(() => processString('')).toThrow('EmptyStringError');
+  });
+
+  it('always logs cleanup message', () => {
+    console.log = jest.fn();
+
+    try {
+      processString('');
+    } catch {
+      /*
+                intentionally left empty,
+                I expext this call to throw,
+                but only care about verifying that the finally block is executed
+                and clean up message logged.
+            */
+    }
+
+    expect(console.log).toHaveBeenCalledWith('Resource cleaned up');
+  });
+});

exercises/practice/error-handling/eslint.config.mjs

@@ -0,0 +1,45 @@
+// @ts-check
+
+import config from '@exercism/eslint-config-javascript';
+import maintainersConfig from '@exercism/eslint-config-javascript/maintainers.mjs';
+
+import globals from 'globals';
+
+export default [
+  ...config,
+  ...maintainersConfig,
+  {
+    files: maintainersConfig[1].files,
+    rules: {
+      'jest/expect-expect': ['warn', { assertFunctionNames: ['expect*'] }],
+    },
+  },
+  {
+    files: ['scripts/**/*.mjs'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+  },
+  // <<inject-rules-here>>
+  {
+    ignores: [
+      // # Protected or generated
+      '/.appends/**/*',
+      '/.github/**/*',
+      '/.vscode/**/*',
+
+      // # Binaries
+      '/bin/*',
+
+      // # Configuration
+      '/config',
+      '/babel.config.js',
+
+      // # Typings
+      '/exercises/**/global.d.ts',
+      '/exercises/**/env.d.ts',
+    ],
+  },
+];

exercises/practice/error-handling/jest.config.js

@@ -0,0 +1,22 @@
+module.exports = {
+  verbose: true,
+  projects: ['<rootDir>'],
+  testMatch: [
+    '**/__tests__/**/*.[jt]s?(x)',
+    '**/test/**/*.[jt]s?(x)',
+    '**/?(*.)+(spec|test).[jt]s?(x)',
+  ],
+  testPathIgnorePatterns: [
+    '/(?:production_)?node_modules/',
+    '.d.ts$',
+    '<rootDir>/test/fixtures',
+    '<rootDir>/test/helpers',
+    '__mocks__',
+  ],
+  transform: {
+    '^.+\\.[jt]sx?$': 'babel-jest',
+  },
+  moduleNameMapper: {
+    '^(\\.\\/.+)\\.js$': '$1',
+  },
+};

exercises/practice/error-handling/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@exercism/javascript-practice-error-handling",
+  "description": "Exercism practice exercise on error-handling",
+  "author": "Katrina Owen",
+  "contributors": [
+    "Derk-Jan Karrenbeld <derk-jan+git@karrenbeld.info> (https://derk-jan.com)",
+    "Tejas Bubane (https://tejasbubane.github.io/)"
+  ],
+  "private": true,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/exercism/javascript",
+    "directory": "exercises/practice/error-handling"
+  },
+  "devDependencies": {
+    "@exercism/babel-preset-javascript": "^0.5.1",
+    "@exercism/eslint-config-javascript": "^0.8.1",
+    "@jest/globals": "^29.7.0",
+    "@types/node": "^22.15.29",
+    "@types/shelljs": "^0.8.17",
+    "babel-jest": "^29.7.0",
+    "core-js": "~3.42.0",
+    "diff": "^8.0.2",
+    "eslint": "^9.28.0",
+    "expect": "^29.7.0",
+    "globals": "^16.2.0",
+    "jest": "^29.7.0"
+  },
+  "dependencies": {},
+  "scripts": {
+    "lint": "corepack pnpm eslint .",
+    "test": "corepack pnpm jest",
+    "watch": "corepack pnpm jest --watch",
+    "format": "corepack pnpm prettier -w ."
+  },
+  "packageManager": "pnpm@9.15.2"
+}