neo4j / cypher-builder

A library for building Cypher queries for Neo4j programmatically.
https://neo4j.github.io/cypher-builder/
Apache License 2.0
52 stars 14 forks source link
cypher cypher-query-language javascript neo4j query-builder typescript

Cypher Builder

npm version Test Lint

Cypher Builder is a JavaScript programmatic API to create Cypher queries for Neo4j.

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

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

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

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

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

Cypher

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

Params

{
    "param0": "The Matrix",
}

Examples

You can find usage examples in the examples folder.

This library is for JavaScript and TypeScript only. If you are using Java, check Neo4j Cypher DSL.