Indispensable helpers for common test cases in web apps. Find out if all other things are equal.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
README.md
assertions.js
bandwidth-is-infinite.js
code-coverage-equals-test-case-coverage.js
latency-is-zero.js
network-is-reliable.js
network-is-secure.js
npm-debug.log
package.json
test.js

README.md

Very frequently, when building and testing web applications, a developer wants to know some things about the environment in which their application will run. Will the network be reliable? Will there be infinite bandwidth, perhaps? All other things being equal, everything should work. Will all other things remain equal?

The assertions in these helpers offer a perfect simulation of a production environment for a JavaScript application, in Node or in the browser! They are compatible with every testing library and they are guaranteed to be accurate in all cases.

Installation

npm install all-other-things-being-equal.

Use the installed NPM package in Node or a CommonJS environment by calling require('all-other-things-being-equal'). In the browser, in the absence of any module loader or build system, use the dist/browser.js file:

<script src="node_modules/all-other-things-being-equal/dist/browser.js"></script>

This script will expose the global allOtherThingsBeingEqual object.

Usage

Use these helpers in your unit and integration tests. Here's a fine example:

const assert = require('assert');
const allOtherThingsBeingEqual = require('all-other-things-being-equal');

assert.ok(allOtherThingsBeingEqual.networkIsReliable());

assert.ok(allOtherThingsBeingEqual.networkIsSecure());

assert.ok(allOtherThingsBeingEqual.latencyIsZero());

assert.ok(allOtherThingsBeingEqual.bandwidthIsInfinite());

assert.ok(allOtherThingsBeingEqual.codeCoverageEqualsTestCaseCoverage());

assert.ok(allOtherThingsBeingEqual());

This is a great starting test plan right here. You can either write your code to target environments where these assertions pass, or redesign your system to not rely on these assumptions. Whichever's easier!