# vowsjs/vows

Asynchronous BDD & continuous testing for node.js

Repository: https://github.com/vowsjs/vows
Canonical: https://ross.abutalabs.com/products/vows
Homepage: http://vowsjs.org
Language: JavaScript
License: Apache-2.0
License Family: permissive
Last push: 2026-02-21T02:08:11+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 68, release rhythm 35, longevity 100
- inputs: {"age_days": 6084, "days_push": 194, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1557, forks 163 (observed 2026-08-28T04:05:03.356446+00:00)

## What it is
Vows is a behavior-driven development (BDD) testing framework for Node.js, built specifically for testing asynchronous code. It organizes tests into hierarchical batches with topics and assertions, running tests in parallel when possible and sequentially when there are dependencies.

## Use cases
- test asynchronous node.js code
- write BDD-style test suites
- run I/O tests concurrently for speed
- structure tests with nested contexts and shared topics
- clean up test resources with teardown functions

## When to choose
- you maintain an existing codebase already using vows
- you want BDD-style hierarchical test batches for async Node.js code
- you need parallel execution of independent I/O-bound tests

## When to avoid
- you are starting a new Node.js project - modern frameworks like mocha, jest, or vitest are better maintained
- you need extensive ecosystem support, plugins, or active community development
- you need snapshot testing, mocking, or built-in coverage tooling

## Facets
- artifact type: library
- maturity: maintenance
- function: testing, e2e-testing
- domain: testing, developer-tools, backend
- platform: cli
- tags: bdd, asynchronous-testing, test-runner, assert-macros, nodejs

## Member repositories
- vowsjs/vows (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:03.356446+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:29:58.451126+00:00, confidence not recorded.
  - readme: https://github.com/vowsjs/vows (fetched 2026-08-28T04:05:03.356446+00:00, sha 6ac27a47d35b)
  - homepage: http://vowsjs.org (fetched 2026-08-29T11:30:18.010281+00:00, sha 7b35173217a4)
- Data as of 2026-08-30T08:39:29.467469+00:00.