National Palace Museum

    TypeScript icon, indicating that this package has built-in type declarations

    2.4.0 • Public • Published

    Comunica SPARQL Solid

    npm version Docker Pulls

    Comunica SPARQL Solid is a SPARQL query engine for JavaScript that can query over Solid data pods.

    This package is safe to use in both Node.js and browser environments.

    This module is part of the Comunica framework. Click here to learn more about Comunica and Solid.

    Known issues

    This library has the following known issues in certain cases, that are out of our control (but have been reported).

    No issues are known with the Community Solid Server


    $ yarn add @comunica/query-sparql-solid


    $ npm install -g @comunica/query-sparql-solid


    Show 100 triples from a private resource by authenticating through the identity provider (when using, your IDP will be

    $ comunica-sparql-solid --idp \ \
      "SELECT * WHERE {
           ?s ?p ?o
       } LIMIT 100"

    This command will connect with the given identity provider, and open your browser to log in with your WebID. After logging in, the query engine will be able to access all the documents you have access to.

    Show the help with all options:

    $ comunica-sparql-solid --help

    Just like Comunica SPARQL, a dynamic variant (comunica-dynamic-sparql-solid) also exists.

    Read more about querying from the command line.

    Usage within application

    This engine can be used in JavaScript/TypeScript applications as follows:

    const QueryEngine = require('@comunica/query-sparql-solid').QueryEngine;
    const { interactiveLogin } = require('solid-node-interactive-auth');
    // This will open your Web browser to log in
    const session = await interactiveLogin({ oidcIssuer: '' });
    const myEngine = new QueryEngine();
    const bindingsStream = await myEngine.queryBindings(`
      SELECT * WHERE {
          ?s ?p ?o
      } LIMIT 100`, {
      sources: [], // Sets your profile as query source
      '@comunica/actor-http-inrupt-solid-client-authn:session': session,
    // Consume results as a stream (best performance)
    bindingsStream.on('data', (binding) => {
      console.log(binding.toString()); // Quick way to print bindings for testing
      console.log(binding.has('s')); // Will be true
      // Obtaining values
    bindingsStream.on('end', () => {
      // The data-listener will not be called anymore once we get here.
    bindingsStream.on('error', (error) => {
    // Consume results as an array (easier)
    const bindings = await bindingsStream.toArray();

    Note that solid-node-interactive-auth only works within Node.js apps. Please refer to @inrupt/solid-client-authn-browser if yoyou want to login via a browser app.

    Read more about querying an application.

    Usage as a SPARQL endpoint

    Start a webservice exposing a private resource via the SPARQL protocol, i.e., a SPARQL endpoint, by authenticating through the identity provider.

    $ comunica-sparql-solid-http --idp \

    Show the help with all options:

    $ comunica-sparql-solid-http --help

    The SPARQL endpoint can only be started dynamically. An alternative config file can be passed via the COMUNICA_CONFIG environment variable.

    Use bin/http.js when running in the Comunica monorepo development environment.

    Read more about setting up a SPARQL endpoint.


    npm i @comunica/query-sparql-solid

    DownloadsWeekly Downloads






    Unpacked Size

    126 kB

    Total Files


    Last publish


    • jeswr
    • joachimvh
    • rubensworks
    • rubenverborgh
    • dexagod