How to create an interactive React.js lab with Vitest?
Coding labs is a powerful feature of Fermion. Using coding labs in your platform, you can increase user retention, provide hands-on experience to them, and make them learn-by-doing.
Let’s take a look at how you can setup a React.js interactive coding lab in this guide.
Attach to course item
button. Once that is done, click the three dots again and click on “Edit” to edit the lab.Once you click on Edit
button a new page will open. On this page you need to setup instructions for lab. These instructions would be visible to the user when they’re attempting the lab. Therefore, include all the helper material, lab setup instructions here.
Lab defaults section include how your lab environment boots. It is one of the most important parts because a wrong default environment might confuse your students. Therefore it is important to set it up properly.
When a playground boots, it can setup a filesystem for user by default. You can specify what the starting files could be, by specifying a git repository and a branch name:
::: info
For React playground, we recommend you to fork the following repository and use it as a starter template: React vite playground starter
Avoid using webpack to setup React.js playgrounds as vite is much faster.
:::
You will find a .cdmrc
file in the repository given to you above. It is highly recommend, at this point, that you go through the .cdmrc guide and how to use .cdmrc in playgrounds to understand what .cdmrc
file exactly is. Once you understand how to work with .cdmrc
come back to this area.
Evaluation script is actually what runs when the user on the playground clicks on “Run Tests” button.
Remember that we’re using React Vite playground setup. This means we can assume that we already have vite installed.
However, we still need to setup a lot of things: jsdom
, vitest
, and react-testing-library
. Therefore, we can write our evaluation bash script to install all of this and run our tests. Here’s how the React vitest script looks like:
You might need to have a little understanding of bash scripting. Let us understand how the evaluation bash script is working:
set -e 1
we effectively say that the script should stop on any errors/home/damner/code
and then install the required NPM packages. Note that this assumes we already have vite
installed. If you’re using a different react setup (like create-react-app
), you might have to install vite
as well..labtests
folder inside of the /home/damner/code
user code directory. Note that .labtests
is a special folder that can be used to place your test code. This folder will not be visible in the file explorer user sees, and the files placed in this folder are not “backed up to cloud” for user./home/damner/code/.labtests/reactcheck.test.jsx
. Note that it is important to give it an extension of .test.jsx
for vitest to pick it as a JSX test file./home/damner/code/.labtests/setup.js
with just jsdom
as the import. This is because vitest can then use JSDOM to parse the DOM without browser. More information about this setup file can be found in vitest docs here.config.js
. This is because we don’t want to override your (or users’) custom vite.config.js
file if present. This file only loads jsdom
and marks the globals: true
hence importing describe
, test
, etc. automatically available without importing. More information about the configuration can be found here in vitest docs.process.js
file that can be used to process our results into a single file of boolean values. This is important because on the playground page, the way challenges work, is that they get green or red based on a JSON boolean array written inside the file in environment variable: $UNIT_TEST_OUTPUT_FILE
[true,false,true,true]
inside $UNIT_TEST_OUTPUT_FILE
, it would reflect as PASS, FAIL, PASS, PASS for 4 challenges available inside playground UI (as shown below)Then we run the actual test using yarn vitest run
command, specifying the output as JSON (read by process.js
) and in a single thread (as we want ordered results).
Finally we run the process.js
file that writes the correct JSON boolean array on $UNIT_TEST_OUTPUT_FILE
which is then read by the playground UI and marks the lab challenges as pass or fail.
Note: You can setup a full testing environment in this block of evaluation script (installing more packages, etc. if you want). However, your bash script test file will be timed out after 30 seconds. Therefore, make sure, all of your testing can happen within 30 seconds.
Next step is to setup test file for this lab.
In the same Evaluation
tab, you’ll see another section called “Custom test file”. You can use this test file to add custom code for testing user work.
When you click on it, a new window will open. This is a test file area.
You can write anything here. Whatever script you write here, can be executed from the Test command to run section
inside the evaluation tab we were in earlier.
The point of having a file like this to provide you with a place where you can write your evaluation script.
For React.js labs, you can use the React (Vitest) evaluation script:
Let us understand what is happening here exactly:
The number of test(...)
blocks inside your describe
suite must match the number of challenges added in the creator area.
Note: If your number of test
blocks are less than challenges added back in the UI, the “extra” UI challenges would automatically stay as “false”. If you add more challenges in test file, the results would be ignored. Therefore, it is important that the results.length
is same as the number of challenges you added in the challenges UI.
We then also add jQuery and chai for assisting with testing. Although it is not required as long as you can populate the results
array properly.
This completes your evaluation script for the lab. Your lab is now almost ready for users.
Finally, in the UI below, add friendly name of challenges that must be visible to the user. Note that the order of challenges is important here and must match the boolean array you write using the bash script + test file above.