@rdfjs/serializer-jsonld

JSON-LD serializer that implements the RDFJS Sink interface

Usage no npm install needed!

<script type="module">
  import rdfjsSerializerJsonld from 'https://cdn.skypack.dev/@rdfjs/serializer-jsonld';
</script>

README

@rdfjs/serializer-jsonld

Build Status

npm version

JSON-LD serializer that implements the RDFJS Sink interface.

Usage

The package exports the serializer as a class, so an instance must be created before it can be used. The .import method, as defined in the RDFJS specification, must be called to do the actual serialization. It expects a quad stream as argument. The method will return a stream which emits the JSON-LD as a plain object or string.

The constructor accepts an options object with the following optional keys:

  • encoding: Defines the encoding of the output. Supported encodings are string and object. By default object is used.

It's also possible to pass options as second argument to the .import method. The options from the constructor and the .import method will be merged together.

Example

This example shows how to create a serializer instance and how to feed it with a stream of quads. The object emitted by the serializer will be written to the console.

const rdf = require('@rdfjs/data-model')
const Readable = require('stream').Readable
const SerializerJsonld = require('@rdfjs/serializer-jsonld')

const serializerJsonld = new SerializerJsonld()
const input = new Readable({
  objectMode: true,
  read: () => {
    input.push(rdf.quad(
      rdf.namedNode('http://example.org/sheldon-cooper'),
      rdf.namedNode('http://schema.org/givenName'),
      rdf.literal('Sheldon')))
    input.push(rdf.quad(
      rdf.namedNode('http://example.org/sheldon-cooper'),
      rdf.namedNode('http://schema.org/familyName'),
      rdf.literal('Cooper')))
    input.push(rdf.quad(
      rdf.namedNode('http://example.org/sheldon-cooper'),
      rdf.namedNode('http://schema.org/knows'),
      rdf.namedNode('http://example.org/amy-farrah-fowler')))
    input.push(null)
  }
})
const output = serializerJsonld.import(input)

output.on('data', jsonld => {
  console.log(jsonld)
})