testing

Testing

Use only @iobroker/testing for integration tests — https://github.com/ioBroker/testing

Unit tests use Mocha (not Jest).

Scripts

• npm run test — unit (test:js) + package validation (CI default)
• npm run test:js — Mocha unit tests (*.test.js, test/**)
• npm run test:package — validates package.json, io-package.json, admin JSON
• npm run test:integration — integration tests via dev-server (local only)

Integration test pattern

const path = require("node:path");
const { tests } = require("@iobroker/testing");

tests.integration(path.join(__dirname, ".."), {
  defineAdditionalTests({ suite }) {
    suite("Test adapter with specific configuration", (getHarness) => {
      let harness;
      before(() => { harness = getHarness(); });

      it("should configure and start adapter", function () {
        return new Promise(async (resolve, reject) => {
          // configure via harness.objects.setObject()
          // start via harness.startAdapterAndWait()
          // verify via harness.states.getState() / getStateIDs()
        });
      }).timeout(40000);
    });
  }
});

Rules

• Configure via harness.objects.setObject() before start
• Start via harness.startAdapterAndWait()
• Verify via harness.states.getState() / getStateIDs()
• Plan sufficient timeouts for async operations
• Mock external APIs in unit tests; never bypass the harness
• Never test Board Manager URLs directly in integration tests

CI order

Lint first (check-and-lint), then adapter-tests — adapter tests do not run if lint fails.