Configuring tests

To determine what tests to run and how to access them the test harness uses the following algorithm:

1. In the current directory it tries to read tape6.json file.
2. If it is not present, it tries to read tape6 section of package.json file.
3. Otherwise it assumes the default value: {"tests": ["/tests/test-*.*js"]}.

When the configuration snippet is found, it is used to configure the test harness:

1. A type-related subsection is read. It can be one of the following: node, deno, bun, or browser depending on the type of the test harness. It is a list of test patterns.
2. A tests subsection is read. It is a list of test patterns. It is added to the list of patterns retrieved previously.
3. A browser reads the importmap section. It is used to configure the browser test harness.

importmap is the standard import map used in browser tests. See importmap for more details.

Example of tape6.json or the tape6 section of package.json:

{
  "tests": [
    "/tests/test-*.*js"
  ],
  "importmap": {
    "imports": {
      "tape-six": "../index.js",
      "tape-six/": "../src/"
    }
  }
}

The example above is taken from package.json of tape-six.

Example of tape6 section of package.json with tests for different environments:

{
  "tape6": {
    "node": ["/tests/node/test-*.js", "/node/tests/test-*.js"],
    "deno": ["/tests/deno/test-*.js", "/deno/tests/test-*.js"],
    "tests": ["/tests/test-*.js"],
    "importmap": {
      "imports": {
        "tape-six": "/node_modules/tape-six/index.js",
        "tape-six/": "/node_modules/tape-six/src/"
      }
    }
  }
}