# @rdfjs/fetch-lite

> Wrapper for fetch to simplify sending and receiving RDF data

Latest version **3.3.0** (published 2024-10-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install @rdfjs/fetch-lite
pnpm add @rdfjs/fetch-lite
yarn add @rdfjs/fetch-lite
bun add @rdfjs/fetch-lite
```

## Health

**Score 53/100 (C)** — status: stable.

Positive: has types package; esm support; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 3.3.0 |
| Published | 2024-10-12 |
| First published | 2019-04-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/rdfjs__fetch-lite) |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 42.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 9 |
| Author | Thomas Bergwinkl |
| Maintainers | bergos |
| Keywords | fetch, light, lite, rdf, rdfjs |

## Links

- npm: https://www.npmjs.com/package/@rdfjs/fetch-lite
- Repository: https://github.com/rdfjs-base/fetch-lite
- Issues: https://github.com/rdfjs-base/fetch-lite/issues
- npm.io page: https://npm.io/package/@rdfjs/fetch-lite

## Dependencies (3)

- [is-stream](https://npm.io/package/is-stream.md) ^4.0.1
- [nodeify-fetch](https://npm.io/package/nodeify-fetch.md) ^3.1.0
- [readable-stream](https://npm.io/package/readable-stream.md) ^4.5.2

## Alternatives

- [@oh-my-pi/pi-natives](https://npm.io/package/@oh-my-pi/pi-natives.md) — 51.8K weekly downloads
- [@capgo/capacitor-light-sensor](https://npm.io/package/@capgo/capacitor-light-sensor.md) — 3.0K weekly downloads
- [@heyhuynhgiabuu/pi-diff](https://npm.io/package/@heyhuynhgiabuu/pi-diff.md) — 492 weekly downloads
- [@lotsa/verdant-lang-asm](https://npm.io/package/@lotsa/verdant-lang-asm.md) — 38 weekly downloads
- [new-era-syntax](https://npm.io/package/new-era-syntax.md) — 20 weekly downloads

## Recent versions

- 3.3.0 (latest) — 2024-10-12
- 3.2.3 — 2024-05-23
- 3.2.2 — 2023-11-11
- 3.2.1 — 2022-12-15
- 3.2.0 — 2022-12-15
- 3.1.0 — 2021-12-29
- 3.0.1 — 2021-11-22
- 3.0.0 — 2021-10-14
- 2.1.2 — 2021-06-30
- 2.1.1 — 2021-05-17
- 2.1.0 — 2020-04-23
- 2.0.1 — 2019-07-29
- 2.0.0 — 2019-04-04

## README

# @rdfjs/fetch-lite

[![build status](https://img.shields.io/github/actions/workflow/status/rdfjs-base/fetch-lite/test.yaml?branch=master)](https://github.com/rdfjs-base/fetch-lite/actions/workflows/test.yaml)
[![npm version](https://img.shields.io/npm/v/@rdfjs/fetch-lite.svg)](https://www.npmjs.com/package/@rdfjs/fetch-lite)

Wrapper for fetch to simplify sending and retrieving RDF data.

This is a light version of the `@rdfjs/fetch` package, without the `@rdfjs/formats-common` dependency.
It is useful when you want to make a build for the browser with a reduced set of parsers and serializers.

The `formats` options is required for this package.
See also the `@rdfjs/fetch` documentation.

Since version 3.0, this packages is [ESM](https://nodejs.org/api/esm.html) only.
Check version 2.x if you are looking for a CommonJS package.

## Usage

The package exports a `fetch` function which wraps the request and response object for on-the-fly RDF quad processing.
The function accepts the same parameters as [fetch](https://fetch.spec.whatwg.org/) and some additional options. It also provides extra methods.

### Options

The `options` object accepts the following additional parameters:

- `formats`: A [formats-common](https://github.com/rdfjs-base/formats-common)-compatible object which contains a set of parsers and serializers.
  This parameter is required.
- `factory`: If given, the factory will be used to create a Dataset when `dataset()` is called.
  If the parameter is not given, the `dataset()` method will not be attached to the response.
- `fetch`: An alternative fetch implementation.
  By default [nodeify-fetch](https://github.com/bergos/nodeify-fetch) will be used.

The following `options` influence the logic of RDF quad processing: 

- `headers.accept`: The accept header field will be automatically set base on the list of available parsers from the `formats` object.
  If it's already set it will not be overwritten.
  This can be useful when only a subset of the available parsers should be used. 
- `headers.content-type`: When the request has a body, this header field will be automatically set to use matching media type for the corresponding serializer.
  By setting this field manually a specific serializer can be enforced.
- `body`: If the request should send quads, the quads must be given either as a stream or as an iterable.
  Iterables will be converted to streams before they are handed over to the serializer.
- `prefixes`: A map of prefixes that will be handed over to the serializer.

### Response

The following methods are attached to the standard fetch response object:

- async `quadStream()`: This method returns the quads of the response as stream.
  The parser is selected based on the content type header field.
- async `dataset()`: This method uses the `quadStream()` method to parse the content and will pipe it into a dataset, which is also the return value.
  This method is only available when the `factory` option is given.

The `Content-Type` header of the response can be changed or set before calling `quadStream()` or `dataset()`.
That allows enforcing a specific parser or can be used to fix a lacking header.

### Example

This example fetches data from a resource on Wikidata.
The stream API is used to process all quads.
For all `rdfs:label` quads of the defined entity, the object language and value will be written to the console.

```javascript
import formats from '@rdfjs/formats-common'
import fetch from '@rdfjs/fetch-lite'

const entity = 'http://www.wikidata.org/entity/Q2'
const label = 'http://www.w3.org/2000/01/rdf-schema#label'

const res = await fetch('https://www.wikidata.org/wiki/Special:EntityData/Q2.ttl', { formats })
const quadStream = await res.quadStream()

quadStream.on('error', err => console.error(err))

quadStream.on('data', quad => {
  if (quad.subject.value === entity && quad.predicate.value === label) {
    console.log(`${quad.object.language}: ${quad.object.value}`)
  }
})
```

---
_Source: https://npm.io/package/@rdfjs/fetch-lite · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._