add error-handling exercise (#2732)

* add error-handling exercise

* [CI] Format code

* add github username and update proof.ci.js and  error-handling.js

* Edit introduction and update proof.ci.js, error-handling.js, and error-handling.spec.js

* Update exercises/practice/error-handling/error-handling.js

Co-authored-by: Derk-Jan Karrenbeld <derk-jan+github@karrenbeld.info>

* edit introduction.md proof.ci.js and error-handling.js

* fix test passing by default

* add handling for empty string

* remove generic line

* edit instructions.md, add more tests

* Edit error-handling.spec.js to include test for specific errors and test for generic errors and test for error messages

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

Co-authored-by: Cool-Katt <stani_s1@abv.bg>

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

Co-authored-by: Cool-Katt <stani_s1@abv.bg>

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

Co-authored-by: Cool-Katt <stani_s1@abv.bg>

* edit test file and change difficulty level to 4 which is medium

* [CI] Format code

* Update introduction.md

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Derk-Jan Karrenbeld <derk-jan+github@karrenbeld.info>
Co-authored-by: Cool-Katt <stani_s1@abv.bg>

Author: 4 people

config.json

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

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

@@ -0,0 +1,7 @@
+# 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.

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

@@ -0,0 +1,26 @@
+# 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 throw errors for invalid inputs.
+- Throw errors for specific cases (e.g., empty strings).
+- Return the uppercase version of the string if it is valid.
+- Handle and catch errors using a try..catch block
+
+
+Implement the processString function using a `try…catch` block.
+
+Inside the `try` block:
+- If the input is not a string, throw a `TypeError`.
+- If the input is an empty string, return `null`.
+- If input length is greater than 100, or less than 10, throw a `RangeError`
+- If input contains a mix of letters and numbers, throw a `SyntaxError`.
+- Otherwise, return the input in `uppercase`.
+
+*Don't forget to attach appropriate error messages then you throw! An informative and well structured error message can save you hours of debugging.*
+
+Inside the `catch` block:
+- log the error's message using `console.log`
+- `throw` the `error` so it can be tested for its type.

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,17 @@
+{
+  "authors": [
+    "A-O-Emmanuel"
+  ],
+  "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/.meta/proof.ci.js

@@ -0,0 +1,26 @@
+export const processString = (input) => {
+  try {
+    if (typeof input !== 'string') {
+      throw new TypeError('Input must be a string');
+    }
+    if (input === '') {
+      return null;
+    }
+    if (input.length > 100) {
+      throw new RangeError('Input is too long');
+    }
+    if (input.length < 10) {
+      throw new RangeError('Input is too short');
+    }
+    if (/[a-zA-Z]/.test(input) && /\d/.test(input)) {
+      throw new SyntaxError(
+        'Input cannot contain a mix of letters and numbers',
+      );
+    }
+
+    return input.toUpperCase();
+  } catch (error) {
+    console.log(error.message);
+    throw error;
+  }
+};

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.js

@@ -0,0 +1,8 @@
+//
+// This is only a SKELETON file for the 'Error handling' exercise. It's been provided as a
+// convenience to get you started writing code faster.
+//
+
+export const processString = (input) => {
+  throw new Error('Remove this line and implement the function');
+};