@comunica/actor-rdf-parse-jsonld

Comunica JSON-LD RDF Parse Actor

An RDF Parse actor that handles JSON-LD.

This module is part of the Comunica framework, and should only be used by developers that want to build their own query engine.

Click here if you just want to query with Comunica.

Install

$ yarn add @comunica/actor-rdf-parse-jsonld

Configure

After installing, this package can be added to your engine's configuration as follows:

{
  "@context": [
    ...
    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-rdf-parse-jsonld/^1.0.0/components/context.jsonld"  
  ],
  "actors": [
    ...
    {
      "@id": "config-sets:rdf-parsers.json#myRdfParserJsonLd",
      "@type": "ActorRdfParseJsonLd",
      "priorityScale": 0.9,
      "crpjl:Actor/RdfParse/JsonLd/mediatorHttp": { "@id": "config-sets:http.json#mediatorHttp" }
    }
  ]
}

Config Parameters

• caam:Actor/AbstractMediaTypedFixed/priorityScale: An optional priority for this parser, used for content negotiation, defaults to 1.
• crpjl:Actor/RdfParse/JsonLd/mediatorHttp: A mediator over the HTTP bus, for fetching remote JSON-LD contexts.

Passing custom options

If you want to pass custom options to the JSON-LD parser, you can use the '@comunica/actor-rdf-parse-jsonld:parserOptions' context entry to provide parser options as a hash.

Using a custom document loader

If you want to override how the JSON-LD parser loads external contexts, you can pass a custom document loader via the '@comunica/actor-rdf-parse-jsonld:documentLoader' context entry. This document loader must implement the IDocumentLoader interface.

Enabling stricter parsing mode

Via the '@comunica/actor-rdf-parse-jsonld:strictValues' context entry, you can set the JSON-LD parser to run in a more strict mode. This corresponds to the strictValues option in JSON-LD Streaming Parser.

Changelog

v1.22.0 - 2021-08-30

Added

• Add support for SPARQL extension functions
• Allow custom fetch function to be provided via context
• Support AbortControllers in native http actor
• Report FILTER errors as warnings in the logger, Closes #767
• Add SPARQL endpoint-based hypermedia update actor
• Allow resource creation via HTTP PUT:
  • Add RDF update hypermedia actor for LDP PUT destinations
  • Configure RDF update hypermedia actor for LDP PUT destinations
  • Allow RDF dereference actors to return on non-200 responses
  • Add metadata extractor for HTTP Accept-Put header
  • Add metadata extractor for HTTP Allow header

Changed

• Refactor CLI arguments handling using yargs
• Optimize node-fetch HTTP actor and set as default
• Include response body in dereference errors
• Bump fetch-sparql-endpoint with improved error reporting for SPARQL endpoints
• Update dependency htmlparser2 to v7 (#851)
• Migrate to @rdfjs/types
• Bump to sparqlalgebrajs 3
• Notify downstream clients on worker timeout
• Bump fetch-sparql-endpoint with AbortControllers
• Make HTTP accept headers deterministic
• Add URL-based heuristic to determine SPARQL endpoints to top-level actor

Fixed

• Update to AsyncIterator 3.2.0 to fix memory issue
• Fix http proxy not working with immutable node-fetch response
• Fix invalid hash implementation for hash-join
• Fix node-fetch actor not supporting body.cancel
• Do not reset sparql.js blank-node counter (Closes #836)
• Fix SPARQL-based update actors not being able to handle quads

<a name="v1.21.3"></a>