Skip to content

Latest commit

 

History

History
70 lines (49 loc) · 3.37 KB

README.md

File metadata and controls

70 lines (49 loc) · 3.37 KB
Raw

Comunica Browser

This repository consists of ready-to-use browser builds of Comunica engines.

While it is recommended to bundle the Comunica packages yourself via tools such as Webpack, you can also make use of the pre-built browser builds in this package.

This repository is updated on every new Comunica build and release. This means that these scripts can be used directly in any Webpage. The packages for which browser scripts are available can be explored in this repo (also make sure to check their corresponding usage README over at the Comunica repo).

Learn more about Comunica browser builds on our website.

Three categories of scripts are exposed:

Major release (recommended)

Each Comunica release is published the URL identified by its major version and will change on every minor update and patch. Use this if you want to stay up-to-date with the latest fixes, but do not want any problems due to breaking changes.

Source template: http://rdf.js.org/comunica-browser/versions/[major-version]/engines/[package]/comunica-browser.js

Source example (query-sparql-rdfjs at version 2.x.x): http://rdf.js.org/comunica-browser/versions/v2/engines/query-sparql-rdfjs/comunica-browser.js

Specific release

Each Comunica release is published to a specific URL and is immutable. Use this if you want certainty that your script usage will not break.

Source template: http://rdf.js.org/comunica-browser/versions/[version]/engines/[package]/comunica-browser.js

Source example (query-sparql-rdfjs at version 2.2.1): http://rdf.js.org/comunica-browser/versions/v2.2.1/engines/query-sparql-rdfjs/comunica-browser.js

Latest build

The latest version of Comunica engines, updated with every commit to the Comunica repo. Use this if you automatically want to stay up-to-date with the latest version, including breaking changes and potential bugs.

Source template: http://rdf.js.org/comunica-browser/versions/latest/engines/[package]/comunica-browser.js

Source example (query-sparql-rdfjs at latest version): http://rdf.js.org/comunica-browser/versions/latest/engines/query-sparql-rdfjs/comunica-browser.js

Example usage

The following example executes a simple SPARQL query using query-sparql at version 2.x.x.

<script src="http://rdf.js.org/comunica-browser/versions/v2/engines/query-sparql/comunica-browser.js"></script>
<script language="JavaScript">
  (new Comunica.QueryEngine()).queryBindings('SELECT * { ?s ?p <http://dbpedia.org/resource/Belgium>. ?s ?p ?o } LIMIT 100',
    { sources: [ 'http://fragments.dbpedia.org/2015/en' ] })
    .then(function (bindingsStream) {
      bindingsStream.on('data', function (data) {
        // Each variable binding is an RDFJS term
        console.log(data.get('?s').value + ' ' + data.get('?p').value + ' ' + data.get('?o').value);
      });
      bindingsStream.on('end', () => {
          // The data-listener will not be called anymore once we get here.
      });
      bindingsStream.on('error', (error) => {
          console.error(error);
      });
    });
</script>

License

This code is copyrighted by Ghent University – imec and released under the MIT license.