@neo4j/cypher-builder

Cypher Builder - Beta

The Cypher builder is a library for building Cypher for Neo4j queries with a programmatic API.

Note that this library is still under development.

Try it live on CodePen.

Getting Started

import Cypher from "@neo4j/cypher-builder";

const movieNode = new Cypher.Node({
    labels: ["Movie"],
});

const matchQuery = new Cypher.Match(movieNode)
    .where(movieNode, {
        title: new Cypher.Param("The Matrix"),
    })
    .return(movieNode.property("title"));

const { cypher, params } = matchQuery.build();

console.log(cypher);
console.log(params);

In this example, cypher will be a string containing the following:

MATCH (this0:`Movie`)
WHERE this0.title = $param0
RETURN this0.title

params will contain the parameters used in that query as an object:

{
    "param0": "The Matrix",
}

Examples

You can find usage examples in the examples folder and in CodePen.

Development

• yarn test to run cypher builder tests
• yarn build to compile cypher builder library
• yarn docs to generate the API reference docs

Changelog

0.2.0

Minor Changes

• #2855 d4455881c Thanks @angrykoala! - Support for patterns with multiple relationships and variable-length patterns

Patch Changes

• #2827 81df28ed9 Thanks @angrykoala! - Add support for square brackets syntax on variable properties

• #2862 4fdb5135f Thanks @angrykoala! - Add XOR operation