Testing & code quality

H5P-Nodejs-Library

Github Twitter Homepage

Search…

README

Core updates

Project Status

Testing & code quality

Running Tests
After installation, you can run the tests with
1
npm run test
2
npm run test:integration
3
npm run test:e2e
4
npm run test:db # (require running MongoDB server)
Copied!
You can run the e2e tests with h5p packages on your local system like this:
1
H5P_FILES=test/data/hub-content ERROR_FILE=errors.txt npm run test:server+upload
Copied!
Debugging
The library emits log messages with debug. To see those messages you have to set the environment variable DEBUG to h5p:*. There are several log levels. By default you'll only see the messages sent with the level info. To get the verbose log, set the environment variable LOG_LEVEL to debug (mind the capitalization).
Example (for Linux):
1
DEBUG=h5p:* LOG_LEVEL=debug node script.js
Copied!
Other scripts
Check out the many other npm scripts in package.json for other development functionality.
Core updates
Check out this page for more details on how to update the H5P core files when there is a new release of the H5P core or the H5P editor core.
Code quality
We aim at achieving high code quality by following these principles:
All public methods and all classes must contain JSDoc comments that contain a full documentation of the entity's function, all of its parameters and return values.
We try to follow the patterns of object oriented programming.
All code must be formatted by prettier.
All code must pass the TS Lint checks.
Every piece of functionality that is added to the library should be covered by a test.
When fixing a bug, a test proving that the bug has been fixed should be added to the project whenever possible.
All logical code branches should be covered by test except.
All tests should be part of the CI pipeline.
All code that is merged into master must pass the CI pipeline's tests.
You can check whether your own code passes most of these requirements by running npm run ci (doesn't include tests requiring a database).

Getting started

Core updates

Last modified 7mo ago

Copy link

Contents