comunicaComunica Jest helpers
Jest test helpers for Comunica
This module is part of the Comunica framework, and should only be used by developers that want to build their own query engine.
Click here if you just want to query with Comunica.
Install
$ yarn add --save-dev @comunica/utils-jest
Configuration
In order to use matchers in your tests, you'll have to make sure that they are imported. This can be done by adding the following entry to your Jest configuration:
{
"jest": {
"setupFilesAfterEnv": ["@comunica/utils-jest"]
}
}
If you are already using an existing test framework script file, make sure to add @comunica/utils-jest as follows to your file:
...
require('@comunica/utils-jest');
Optional: Typescript typings configuration
If you are using TypeScript, possibly in combination with ts-jest, you will need to import the typings of this package to make the TS compiler recognise the new matchers.
For this, include the following import at the top of each applicable test file:
import "@comunica/utils-jest";
API
All examples below make use of these helpers:
import { BindingsFactory } from '@comunica/utils-bindings-factory';
import { DataFactory } from 'rdf-data-factory';
const BF = new BindingsFactory(DF);
const DF = new DataFactory();
toEqualBindings
Check if two Bindings are equal.
expect(BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
])).toEqualBindings(BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
]));
toEqualBindingsArray
Check if two Bindings arrays are equal.
expect([
BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
]),
BF.bindings([
[ DF.variable('b'), DF.namedNode('b1') ],
[ DF.variable('c'), DF.namedNode('c1') ],
]),
]).toEqualBindingsArray([
BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
]),
BF.bindings([
[ DF.variable('b'), DF.namedNode('b1') ],
[ DF.variable('c'), DF.namedNode('c1') ],
]),
]);
toEqualBindingsStream
Check if a Bindings stream equals a Bindings array.
import { ArrayIterator } from 'asynciterator';
expect(new ArrayIterator([
BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
]),
BF.bindings([
[ DF.variable('b'), DF.namedNode('b1') ],
[ DF.variable('c'), DF.namedNode('c1') ],
]),
], { autoStart: false })).toEqualBindingsStream([
BF.bindings([
[ DF.variable('a'), DF.namedNode('a1') ],
[ DF.variable('b'), DF.namedNode('b1') ],
]),
BF.bindings([
[ DF.variable('b'), DF.namedNode('b1') ],
[ DF.variable('c'), DF.namedNode('c1') ],
]),
]);