This is a web application for JavaScript exercises with test cases. These particular exercises are designed for students in CS325 Introduction to AI Programming.
For a more generic set of exercises, see this repo.
Download and serve this application locally to see the exercises, write solutions, and test them.
Recommended for editing and running the code:
The tester is a web application that you run locally. Download it using a command shell like Terminal in MacOS or Git Bash on Windows. In a command shell, cd to the directory where you want to create a directory for your JavaScript solutions.
If you have Node installed, use degit:
npx degit criesbeck/cs325-js-tester your-js-folder-name
If you don't have and don't want to install Node, use git clone:
git clone https://github.com/criesbeck/cs325-js-tester.git your-js-folder-name
npx degit is faster and downloads fewer files.
Run this web app in a local server and open index.html. Any web server will do, but a simple approach is to run Live Server inside VS Code:
- In VS Code, use File | Open to open the entire downloaded directory (not a specific file)
- Start Live Server to serve index.html.
- The exercise tester page should open on http://localhost:5500.
If you don't have VS Code, consider installing it. It is a fine JavaScript editor. But feel free to use any editor that properly indents JavaScript code and any web server to test your solutions.
The local test page hould look like this.
The tester page displays a list of JavaScript exercise modules. The color of each module indicates its status:
- gray means none of the exercises in the module have been started
- red means one or more exercises in the module have failing test cases
- orange means some of the exercises in module are done
- green means all the exercises in the module are done
Click on a module to see the exercises in it. The exercises are also color coded:
- gray means the exercise has not been started
- red means one or more test cases are failing
- green means all the test cases are passing
Click on a specific exercise to see the requirements and test cases.
For demonstration purposes, the repository comes with a broken solution to the first exercise in the first module. That's why that module is red.
Click on the first module to open it up. That will show that the first exercise is also red. It has a broken solution.
Click on the first exercise to see what function has to be defined, what arguments the function takes, what the function returns, and what test cases have to be passed.
Each test case has:
- a call to the function
- the value that should be returned by the function call
- the value that the current solution returns, if a solution has been defined
In this case, all of the test results are red because all of the tests fail.
The tester loads the file solutions.js. Open that file. Out of the box, it contains
// export * from './solutions/warmup.js';
// export * from './solutions/mapping.js';
// export * from './solutions/match.js';
export const sumOfSquares = (x, y) => x + y;
This definition of sumOfSquares() is incorrect. Delete it, uncomment the first line, and put the correct solution in the file solutions/warmup.js.
export const sumOfSquares = (x, y) => x * x + y * y;
Save the file and go back to the web page again. Live Server should have updated the page automatically. The test cases should now all be green.
The module name should now be orange. That means it has no failing cases, but it does have exercises with no solutions.
warmup-json: This includes tests for conditionals using the ternary conditional operator and looping using array iteration methods.
mapping.json: More exercises doing loops using JavaScript iteration methods, rather than for and while.
Match: A sequence of increasingly challenging modules that incrementally develops a recursive object pattern matcher.
As you write code for these modules, uncomment the appropriate export line of solutions.js and put your code in the corresponding file in the solutions subdirectory.
Code you put into the solutions subdirectory will not be overwritten if you do
git pullto update the testing code.
Solutions are functions. They must be exported for the tester to see them.
Feel free to define helper functions. Don't export those.
Use modern JavaScript features.
Unless required by the exercise, solutions should not
- destructively modify input objects
- print anything
Code should be readable. That means indented properly, with lines no longeer than 70 characters.
When the exercises or tests are updated, you can update the tester without losing your solution code. In a command shell, cd into the folder you created to hold the tester.
If you installed using npx degit then update with
npx degit criesbeck/cs325-js-tester
If you installed using git clone then update with
git pull
You will need to update the export lines that you've changed in the file solutions.js.
Hello, JavaScript! is the primary resource for these exercises. It emphasizes the modern parts of JavaScript. It deliberately ignores and does not recommend elements such as var, function, for, and so on.
For a longer introduction to JavaScript, see The Modern JavaScript Tutorial. Note that to be complete it covers many features in JavaScript that are no longer recommended practice.
A good reference for specific details about various JavaScript functions and methods is
the Mozilla Developer site.
- Chris Riesbeck - home page
This project is licensed under the MIT License - see the LICENSE.md file for details.