jasmine-node

library3.0.0jsnpmunverified

Jasmine-node is a command-line utility designed for running Jasmine BDD specifications (specifically version 1.3.1, a forked version from the Karma project) within a Node.js environment without requiring a browser DOM. It provides a simple CLI for executing tests written in JavaScript or CoffeeScript, offering features like automatic test execution on file changes (`--autotest`), colorized output, and optional Growl notifications. The project is explicitly in maintenance mode, and its authors recommend using the official `jasmine` or `jasmine-npm` packages for any new development due to `jasmine-node`'s reliance on an older Jasmine version and limited future development. It supports Node.js versions 10 and 12, with older Node.js versions being deprecated.

testing

npm install jasmine-node

github ↗package ↗

INSTALL

IMPORT

SIG · JASMINE-NODE

jasmine-node

testingjavascriptv3.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CLI Tool Execution

✓ Install globally: npm install jasmine-node -g Run tests: jasmine-node spec/

✗ import { jasmineNode } from 'jasmine-node'

jasmine-node is primarily a command-line interface tool. Its core functionality for running tests is invoked via the CLI after global installation, not typically through direct programmatic imports for standard testing workflows. This entry refers to its main CLI usage pattern.

describe, it, expect

✓ // These functions are made globally available by the jasmine-node runner when executing tests.

✗ import { describe, it, expect } from 'jasmine-node'

Jasmine-node, like the Jasmine framework it bundles, exposes its core BDD functions (like `describe`, `it`, `expect`, `beforeEach`, `afterEach`) as global variables within the test execution context. They are not intended to be imported as modules from the `jasmine-node` package itself in test files.

Programmatic Runner Access

✓ const cliRunner = require('jasmine-node/lib/jasmine-node/cli'); // Highly discouraged, use CLI instead

✗ import * as jasmineNode from 'jasmine-node'

While it is technically possible to `require` internal modules like the CLI runner for advanced, non-standard programmatic invocation, this approach is strongly discouraged. The package's internal structure is not guaranteed to be stable or part of a public API for direct programmatic access.

Demonstrates the global installation of `jasmine-node`, the creation of a standard Jasmine spec file (including sync, async, and `ddescribe` examples), and how to execute these tests using the `jasmine-node` command-line interface.

npm install jasmine-node -g // Create a spec file (e.g., 'spec/example-spec.js') // NOTE: The filename MUST end with 'spec.js', 'spec.coffee', or 'spec.litcoffee' describe('A basic Jasmine suite', function() { // Synchronous test it('should verify true is true', function() { expect(true).toBe(true); }); // Asynchronous test with 'done' it('should handle async operations', function(done) { setTimeout(function() { expect('async').toBe('async'); done(); }, 50); }); // Using ddescribe to run only this suite (feature from Karma fork) ddescribe('A focused suite example', function() { it('should be the only test suite executed', function() { expect(1).not.toBe(2); }); }); }); // Run tests from the command line in your project's root directory jasmine-node spec/

jasmine-node --version

Debug

Known issues

breakingThe `jasmine-node` project is in maintenance mode and relies on an outdated Jasmine 1.3.1. It is highly recommended to migrate to the actively maintained official `jasmine` or `jasmine-npm` packages for modern testing environments and newer Jasmine versions (2.x+).

fix

Migrate your existing tests to use the official `jasmine` package or a modern alternative like `Jest`. Be aware of API changes between Jasmine 1.x and 2.x, particularly around asynchronous testing (e.g., `done()` callbacks instead of `runs`/`waitsFor`).

affects: >=0.0.1

deprecatedSupport for Node.js versions 8, 6, and 4 is deprecated and has reached End-of-Life. The package only officially supports Node.js versions 10 and 12.

fix

Upgrade your Node.js runtime environment to version 10 or 12 to ensure compatibility and receive any potential bug fixes. For environments requiring newer Node.js versions, consider migrating to a more actively maintained testing framework.

affects: <10.0.0

gotchaThe `Jasmine2.0` branch, which aimed to support Jasmine 2.0 with a CoffeeScript rewrite, has been explicitly abandoned and is no longer supported. Do not attempt to use it or expect Jasmine 2.x features within `jasmine-node`.

fix

Stick to the main `jasmine-node` branch for Jasmine 1.3.1 compatibility, or migrate entirely to the `jasmine` / `jasmine-npm` packages for proper Jasmine 2.x and later support.

affects: >=0.0.1

gotchaSpec files must adhere to a specific naming convention to be discovered by the runner: their filenames must match the regular expression `/spec\.(js|coffee|litcoffee)$/i`. This means they typically end with `spec.js`, `spec.coffee`, or `spec.litcoffee`.

fix

Rename your test files to follow the convention (e.g., `myFeatureSpec.js` instead of `myFeature.js`). Alternatively, you can use the `--matchall` flag when running `jasmine-node` to relax this filename requirement, though adhering to the convention is generally best practice.

affects: >=0.0.1

Errors

Common errors & fixes

ReferenceError: describe is not defined

This error occurs when a test file is executed directly using `node` (e.g., `node spec/my-test-spec.js`) instead of through the `jasmine-node` command-line runner. The runner is responsible for setting up Jasmine's global functions like `describe`, `it`, and `expect`.

fix

Always run your tests using the `jasmine-node` CLI command, specifying the directory where your specs are located (e.g., `jasmine-node spec/`).

No specs found

This usually indicates that `jasmine-node` could not locate any test files. Common causes include spec files not being in the specified directory, or their filenames not matching the required `*spec.js` (or `.coffee`, `.litcoffee`) pattern.

fix

Verify that your spec files are correctly placed in the directory you're passing to `jasmine-node` (e.g., `spec/`) and that their names conform to the `*spec.js` pattern. If you've used non-standard naming, try running with the `--matchall` flag.

Upgrade

Version history

3.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

28 hits · last 30 days

node

Resources

githubhttps://github.com/mhevery/jasmine-node ↗

packagehttps://www.npmjs.com/package/jasmine-node ↗