2c:null 2d:["$","title",null,{"children":"Neo4j Driver for JavaScript | Nhogs | Observable"}] 32:T8c5,md`# Neo4j Driver for JavaScript A database driver for Neo4j 4.4.1. Resources to get you started: - [Doc](https://neo4j.com/developer/javascript/) - [Detailed API docs](http://neo4j.com/docs/api/javascript-driver/current/). - [Sample small project using the driver](https://github.com/neo4j-examples/movies-javascript-bolt) - [Sample application using the driver](https://github.com/neo4j-examples/neo4j-movies-template) - [Neo4j Manual](https://neo4j.com/docs/) - [Neo4j Refcard](https://neo4j.com/docs/cypher-refcard/current/) See GitHub repository for more details: [neo4j-javascript-driver](https://github.com/neo4j/neo4j-javascript-driver) `33:[] 30:{"id":"4c98a800cb998051","slug":"neo4j-driver-for-javascript","title":"Neo4j Driver for JavaScript","thumbnail":"30c809370e7979c185cf6ea7e6b320049001070db91d8c810b85a8c0910899fc","access_level":"public","create_time":"$D2018-03-26T12:25:33.688Z","update_time":"$D2023-07-01T08:40:30.107Z","view_time":null,"first_public_time":"$D2019-06-21T01:28:49.481Z","has_unpublished_edits":null,"fork":false,"stars":16,"starred":false,"owner":{"type":"team","id":"41a2166948bbf4e5","login":"nhogs","name":"Nhogs","avatar_url":"https://avatars-next.observableusercontent.com/1ef66c39acd4e65cbecc8e415cf2c2c2a7a2e44850d9164200d67384008e3280","tier":"starter_2024","bio":""},"version":1084,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"c76836bd57aa9076","login":"popotojs","name":"Frederic Ciminera","avatar_url":"https://avatars-next.observableusercontent.com/f35a0c3fe1bbf6c7109d71d66829b7483733fd335c24d62b116d4bc79ba18048","tier":null,"bio":""}],"members":[{"type":"team","id":"41a2166948bbf4e5","login":"nhogs","name":"Nhogs","avatar_url":"https://avatars-next.observableusercontent.com/1ef66c39acd4e65cbecc8e415cf2c2c2a7a2e44850d9164200d67384008e3280","tier":"starter_2024","role":"editor"}],"comments":[],"custom_thumbnail":true,"trashed":false,"lapsed":null,"subscribed":null,"forks":20,"collection":{"id":"5056d591e4d9c9a7","slug":"neo4j","title":"Neo4j","owner":{"id":"41a2166948bbf4e5","login":"nhogs","name":"Nhogs"}},"type":"notebook","body":{"titling":"auto","title":"Neo4j Driver for JavaScript","cells":[{"id":573,"value":"$32","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":185,"value":"md`\n---\n### Get neo4j driver:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":2,"value":"neo4j = require(\"neo4j-driver@4.4.1\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":159,"value":"md`\n---\n### Setup the database access:\n\nConnect your own database, create a simple one for test on [Neo4j Sandbox](https://sandbox.neo4j.com/) using movie dataset or use [Neo4j Aura](https://neo4j.com/cloud/aura/).\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1051,"value":"md`\n---\n### Scheme Usage:\n| Unencrypted | neo4j | neo4j | bolt |\n|----------------------------------------|-----------|-----------|----------|\n| Encrypted with Full Certificate | neo4j+s | neo4j+s | bolt+s |\n| Encrypted with Self-Signed Certificate | neo4j+ssc | neo4j+ssc | bolt+ssc |\n| Neo4j AuraDB | neo4j+s | N/A | N/A |\n---\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":110,"value":"viewof scheme = select({\n title: \"SCHEME\",\n description: \"Select the scheme to access the database.\",\n options: [\"neo4j\", \"neo4j+s\", \"neo4j+ssc\", \"bolt\", \"bolt+s\", \"bolt+ssc\"],\n value: \"bolt\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":137,"value":"viewof host = text({\n title: \"HOST\",\n placeholder: \"Database host\",\n value: \"demo.neo4jlabs.com\",\n description: \"Set the database host.\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":142,"value":"viewof port = number({\n placeholder: \"database port number\",\n description: \"Set the database port number.\",\n title: \"PORT:\",\n value: 7687,\n min: \"0\",\n max: \"65535\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":146,"value":"viewof user = text({\n title: \"USER:\",\n placeholder: \"Database user\",\n value: \"movies\",\n description: \"User name with access on database.\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":152,"value":"viewof password = passwordInput({\n title: \"PASSWORD:\",\n description: \"User password.\",\n value: \"movies\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1080,"value":"viewof database = text({\n title: \"DATABASE:\",\n description: \"Database to use\",\n value: \"movies\"\n})","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":193,"value":"md`\n---\n### Create a driver instance:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":25,"value":"driver = neo4j.driver(\n scheme + \"://\" + host + \":\" + port,\n neo4j.auth.basic(user, password)\n)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1068,"value":"serverStatus = driver\n .verifyConnectivity()\n .then(() => ({ running: true }))\n .catch((reason) => ({ running: false, reason }))","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":882,"value":"md`\n### Run a Query:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":880,"value":"async function runQuery(statement) {\n const session = driver.session({ database: database });\n let results;\n\n await session\n .run(statement)\n .then((r) => {\n results = r.records.map((d) => d.toObject());\n session.close();\n })\n .catch((error) => {\n results = error.message;\n });\n\n return results;\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":206,"value":"md`\n---\n### Run a query and return result records:`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":28,"value":"persons = await runQuery(\n \"MATCH (p:Person) return p.name as name ORDER BY name\"\n).catch(() => [])","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":671,"value":"movies = await runQuery ('MATCH (m:Movie) return m.title as title ORDER BY title')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":645,"value":"roles = await runQuery(\n \"MATCH (p:Person)-[r:ACTED_IN]->(m:Movie) return {source: p.name, roles:r.roles, target: m.title} AS role\"\n)","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":978,"value":"allNodes = await runQuery(\"MATCH (n) RETURN n\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":984,"value":"allPaths = await runQuery(\"MATCH p=()-[]->() RETURN p\")","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":341,"value":"md`\n---\n### Cypher query runner:\n\nUsing [CodeMirror](https://codemirror.net/) for Cypher syntax hilighting.\n\nYou can edit and run queries here.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":368,"value":"viewof cypherRunner = {\n const mainDiv = html`

`;\n const editorDiv = html`

`;\n const runButton = html``;\n\n mainDiv.append(editorDiv);\n mainDiv.append(runButton);\n\n mainDiv.value = [];\n\n yield mainDiv;\n\n let editor = CodeMirror(editorDiv, { mode: \"application/x-cypher-query\" });\n\n editor.setValue(\n `MATCH (p:Person)-[:ACTED_IN]->(m:Movie{title:\"The Matrix\"}) RETURN p.name AS name`\n );\n editor.setSize(width - 20, 200);\n\n runButton.onclick = (e) => {\n mainDiv.value = runQuery(editor.getValue());\n mainDiv.dispatchEvent(new CustomEvent(\"input\"));\n };\n\n return mainDiv;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":412,"value":"cypherRunner","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":401,"value":"md`---\n### Run shortest path query and display result with dot:\nBacon path example, the shortest path of any relationships to Meg Ryan:\n\\`\\`\\`cypher\nMATCH p = shortestPath((from:Person {name:\"${fromPerson}\"})-[*]-(to:Person {name:\"${toPerson}\"})) RETURN p\n\\`\\`\\`\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":902,"value":"shortestPaths = await runQuery(\n `MATCH p = shortestPath((from:Person {name:\"${fromPerson}\"})-[*]-(to:Person {name:\"${toPerson}\"})) RETURN p AS shortestPath`\n)","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":547,"value":"viewof fromPerson = select({\n title: \"From\",\n options: persons.map(a => a.name),\n value: \"Kevin Bacon\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":554,"value":"viewof toPerson = select({\n title: \"To\",\n options: persons.map(a => a.name),\n value: \"Meg Ryan\"\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":434,"value":"shortestPathDot = dot`${pathSegmentsToDot(\n shortestPaths[0].shortestPath.segments\n)}`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":525,"value":"md`---\n### Display full graph:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":632,"value":"chart = ForceGraph(graph, {\n nodeId: (d) => d.id,\n nodeGroup: (d) => d.group,\n nodeTitle: (d) => `${d.name} (${d.group})`,\n nodeRadius: 5,\n colors: d3.schemeSet1,\n linkStrokeWidth: (d) => (d.isShortestPath ? 8 : 1.5),\n width,\n height: 680,\n invalidation // a promise to stop the simulation when the cell is re-run\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":704,"value":"md`---`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":724,"value":"graph = {\n return {\n links: links,\n nodes: nodes\n };\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":962,"value":"links = allPaths.map((d) => ({\n source: d.p.start.identity.toInt(),\n target: d.p.end.identity.toInt(),\n isShortestPath: isShortestPath(\n d.p.start.identity.toInt() + \"-\" + d.p.end.identity.toInt()\n )\n}))","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":990,"value":"nodes = allNodes.map((d) => {\n return {\n id: d.n.identity.toInt(),\n name: d.n.properties.name || d.n.properties.title,\n radius: 5,\n group:\n d.n.properties.name === fromPerson || d.n.properties.name === toPerson\n ? \"ShortestPathNode\"\n : d.n.labels[0]\n };\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":959,"value":"isShortestPath = (id) => {\n return pths.indexOf(id) >= 0;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":1002,"value":"pths = shortestPaths[0].shortestPath.segments.reduce((acc, s) => {\n acc.push(s.start.identity.toInt() + \"-\" + s.end.identity.toInt());\n acc.push(s.end.identity.toInt() + \"-\" + s.start.identity.toInt());\n return acc;\n}, [])","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":443,"value":"dot = require(\"@observablehq/graphviz@0.2\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":113,"value":"import {select, text, number, password as passwordInput} from \"@jashkenas/inputs\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":361,"value":"CodeMirror = require('https://unpkg.com/codemirror@5/lib/codemirror').then(CodeMirror => {\n return require('https://unpkg.com/codemirror@5/mode/cypher/cypher.js').then(() => CodeMirror);\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":737,"value":"pathSegmentsToDot = pathSegments => {\n let dot = \"digraph { rankdir = LR; \"\n\n let dotRels = pathSegments.map(\n ps => {\n let start,end;\n\n if(new neo4j.types.Integer(ps.relationship.start).equals(new neo4j.types.Integer(ps.start.identity))){\n start = ps.start\n end = ps.end\n } else {\n start = ps.end\n end = ps.start\n }\n\n let dotRel = \"\\\"\" + (start.properties.name !== undefined ? start.properties.name : start.properties.title) + \"\\\"\"\n dotRel += \" -> \"; \n dotRel += \"\\\"\" + (end.properties.name !== undefined ? end.properties.name : end.properties.title) + \"\\\"\"\n dotRel += \" [label = \\\"\"+ ps.relationship.type + \"\\\"];\";\n return dotRel;\n }\n );\n\n dot += dotRels.join(\"\\n\")\n\n dot += \"}\";\n\n return dot;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":375,"value":"stylesheet = html``","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":634,"value":"d3 = require(\"d3@5\")","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":917,"value":"import { ForceGraph } from \"@d3/disjoint-force-directed-graph\"","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W33","stdlib":"1"}} 31:"$30:body"