Giter Site home page Giter Site logo

js-exercises's Introduction

CS325 JavaScript Exercise Tester

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.

Requirements

Recommended for editing and running the code:

Installation

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.

Running in VS Code

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 interface

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.

Viewing results

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.

Fixing a solution

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.

Overview of the modules

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 pull to update the testing code.

Exercise code guidelines

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.

Updating

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.

Resources

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.

Authors

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

js-exercises's People

Contributors

cbugayer avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.