From b5321aff06d6ea8d730d62aec2ffd8e9271c1ffc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Thu, 14 Apr 2022 20:12:10 +0200 Subject: Adding upstream version 1.34.0. Signed-off-by: Daniel Baumann --- tests/README.md | 148 -------------------------------------------------------- 1 file changed, 148 deletions(-) delete mode 100644 tests/README.md (limited to 'tests/README.md') diff --git a/tests/README.md b/tests/README.md deleted file mode 100644 index 256b482cf..000000000 --- a/tests/README.md +++ /dev/null @@ -1,148 +0,0 @@ - - -# Testing - -This readme is a manual on how to get started with unit testing on javascript and nodejs - -Original author: BrainDoctor (github), July 2017 - -## Installation - -Tested on Linux Mint 18.2 Sara (Ubuntu/debian derivative) - -Make sure you are the user who is developer (permissions, except sudo ofc) - -```sh -sudo apt-get install nodejs npm chromium-browser - -cd /path/to/your/netdata -npm install -``` - -That should install the necessary node modules. - -Other browsers work too (Chrome, Firefox). However, only the Chromium Browser 59 has been tested for headless unit testing. - -### Versions - -The commands above leave me with the following versions (July 2017): - -- nodejs: v4.2.6 -- npm: 3.5.2 -- chromium-browser: 59.0.3071.109 -- WebStorm (optional): 2017.1.4 - -## Configuration - -### NPM - -The dependencies are installed in `netdata/package.json`. If you install a new NPM module, it gets added here. Future developers just need to execute `npm install` and every dep gets added automatically. - -### Karma - -Karma configuration is in `tests/web/karma.conf.js`. Documentation is provided via comments. - -### WebStorm - -If you use the JetBrains WebStorm IDE, you can integrate the karma runtime. - -#### for Karma (Client side testing) - -Headless Chromium: - -1. Run > Edit Configurations -2. "+" > Karma -3. - Name: Karma Headless Chromium - - Configuration file: /path/to/your/netdata/tests/web/karma.conf.js - - Browsers to start: ChromiumHeadless - - Node interpreter: /usr/bin/nodejs (MUST be absolute, NVM works too) - - Karma package: /path/to/your/netdata/node_modules/karma - -GUI Chromium is similar: - -1. Run > Edit Configurations -2. "+" > Karma -3. - Name: Karma Chromium - - Configuration file: /path/to/your/netdata/tests/web/karma.conf.js - - Browsers to start: Chromium - - Node interpreter: /usr/bin/nodejs (MUST be absolute, NVM works too) - - Karma package: /path/to/your/netdata/node_modules/karma - -You may add other browsers too (comma separated). With the "Browsers to start" field you can override any settings in karma.conf.js. - -Also it is recommended to install WebStorm IDE Extension/Addon to Chrome/Chromium for awesome debugging. - -#### for node.d plugins (nodejs) - -1. Run > Edit Configurations -2. "+" > Node.js -3. - Name: Node.d plugins - - Node interpreter: /usr/bin/nodejs (MUST be absolute, NVM works too) - - JavaScript file: node_modules/jasmine-node/bin/jasmine-node - - Application parameters: --captureExceptions tests/node.d - -## Running - -### In WebStorm - -#### Karma - -Just run the configured run configurations and they produce nice test trees: - -![karma_run_2](https://user-images.githubusercontent.com/12159026/28277789-559149f6-6b1b-11e7-9cc7-a81d81d12c35.png) - -#### node.js - -Debugging is awesome too! -![node_debug](https://user-images.githubusercontent.com/12159026/28277879-8beee5ee-6b1b-11e7-9356-3156956f2282.png) - -### From CLI - -#### Karma - -```sh -cd /path/to/your/netdata - -nodejs ./node_modules/karma/bin/karma start tests/web/karma.conf.js --single-run=true --browsers=ChromiumHeadless -``` - -will start the karma server, start chromium in headless mode and exit. - -If a test fails, it produces even a stack trace: -![karma_run_1](https://user-images.githubusercontent.com/12159026/28277754-3682bebe-6b1b-11e7-8b7e-66b23d87177d.png) - -#### Node.d plugins - -```sh -cd /path/to/your/netdata - -nodejs node_modules/jasmine-node/bin/jasmine-node --captureExceptions tests/node.d -``` - -will run the tests in `tests/node.d` and produce a stacktrace too on error: -![node_run](https://user-images.githubusercontent.com/12159026/28277812-65bb69b0-6b1b-11e7-8500-bcdbb3436574.png) - -### Coverage - -#### Karma - -A nice HTML is produced from Karma which shows which code paths were executed. It is located somewhere in `/path/to/your/netdata/coverage/` - -![coverage_2](https://user-images.githubusercontent.com/12159026/28277719-142146c4-6b1b-11e7-9992-3e88dee2efd2.png) -and -![coverage_1](https://user-images.githubusercontent.com/12159026/28277687-fa93e360-6b1a-11e7-995f-cbb4c5d012a7.png) - -#### Node.d - -Apparently, jasmine-node can produce a junit report with the `--junitreport` flag. But that output was not very useful. Maybe it's configurable? - -### CI - -The karma and node.d runners can be integrated in Travis (AFAIK), but that is outside my ability. - -Note: Karma is for browser-testing. On a build server, no GUI or browser might by available, unless browsers support headless mode. - -[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Ftests%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)](<>) -- cgit v1.2.3