@inrupt/solid-client / resource/solidDataset

# Module: resource/solidDataset¶

## Type aliases¶

### ParseOptions¶

Ƭ ParseOptions: Object

Custom parsers to load SolidDatasets serialised in different RDF formats.

Provide your own parsers by providing an object on the parsers property with the supported content type as the key, and the parser as a value. For documentation on how to provide a parser, see Parser.

#### Type declaration¶

Name

Type

parsers

Record<ContentType, Parser>

#### Defined in¶

src/resource/solidDataset.ts:159

### Parser¶

Ƭ Parser: Object

A Parser takes a string and generates RDF/JS Quads.

By providing an object conforming to the Parser interface, you can handle RDF serialisations other than text/turtle, which @inrupt/solid-client supports by default. This can be useful to retrieve RDF data from sources other than a Solid Pod.

A Parser has the following properties:

• onQuad: Registers the callback with which parsed RDF/JS Quads can be provided to @inrupt/solid-client.

• onError: Registers the callback with which @inrupt/solid-client can be notified of errors parsing the input.

• onComplete: Registers the callback with which @inrupt/solid-client can be notified that parsing is complete.

• parse: Accepts the serialised input string and an object containing the input Resource’s metadata. The input metadata can be read using functions like getSourceUrl and getContentType.

For example, the following defines a parser that reads an RDFa serialisation using the rdfa-streaming-parser library:

import { RdfaParser } from "rdfa-streaming-parser";

// ...

const getRdfaParser = () => {
const onCompleteCallbacks = [];
const onErrorCallbacks = [];

return {
onError: (callback) => onErrorCallbacks.push(callback),
onComplete: (callback) => onCompleteCallbacks.push(callback),
parse: async (source, resourceInfo) => {
const parser = new RdfaParser({
baseIRI: getSourceUrl(resourceInfo),
contentType: getContentType(resourceInfo) ?? "text/html",
});
});
parser.on("error", (error) => {
onErrorCallbacks.forEach((callback) => callback(error));
});
parser.write(source);
parser.end();
onCompleteCallbacks.forEach((callback) => callback());
},
};
};


#### Type declaration¶

Name

Type

onComplete

(onCompleteCallback: () => void) => void

onError

(onErrorCallback: (error: unknown) => void) => void

onQuad

(onQuadCallback: (quad: Quad) => void) => void

parse

(source: string, resourceInfo: WithServerResourceInfo) => void

#### Defined in¶

src/resource/solidDataset.ts:145

## Functions¶

### changeLogAsMarkdown¶

changeLogAsMarkdown(solidDataset): string

Gets a human-readable representation of the local changes to a Resource to aid debugging.

Note that changes to the exact format of the return value are not considered a breaking change; it is intended to aid in debugging, not as a serialisation method that can be reliably parsed.

since 0.3.0

#### Parameters¶

Name

Type

Description

solidDataset

SolidDataset & WithChangeLog

The Resource of which to get a human-readable representation of the changes applied to it locally.

#### Returns¶

string

#### Defined in¶

src/resource/solidDataset.ts:924

### createContainerAt¶

createContainerAt(url, options?): Promise<SolidDataset & WithServerResourceInfo>

Create an empty Container at the given URL.

Throws an error if creating the Container failed, e.g. because the current user does not have permissions to, or because the Container already exists.

Note that a Solid server will automatically create the necessary Containers when storing a Resource; i.e. there is no need to call this function if it is immediately followed by saveSolidDatasetAt or overwriteFile.

since 0.2.0

#### Parameters¶

Name

Type

Description

url

URL of the empty Container that is to be created.

options

Partial<typeof internal_defaultFetchOptions>

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<SolidDataset & WithServerResourceInfo>

#### Defined in¶

src/resource/solidDataset.ts:505

### createContainerInContainer¶

createContainerInContainer(containerUrl, options?): Promise<SolidDataset & WithResourceInfo>

Create an empty Container inside the Container at the given URL.

Throws an error if creating the Container failed, e.g. because the current user does not have permissions to.

The Container in which to create the new Container should itself already exist.

since 0.2.0

#### Parameters¶

Name

Type

Description

containerUrl

URL of the Container in which the empty Container is to be created.

options

SaveInContainerOptions

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<SolidDataset & WithResourceInfo>

#### Defined in¶

src/resource/solidDataset.ts:774

### createSolidDataset¶

createSolidDataset(): SolidDataset

Initialise a new SolidDataset in memory.

#### Returns¶

SolidDataset

An empty SolidDataset.

#### Defined in¶

src/resource/solidDataset.ts:77

### deleteContainer¶

deleteContainer(container, options?): Promise<void>

Deletes the Container at a given URL.

since 0.6.0

#### Parameters¶

Name

Type

container

options

Partial<typeof internal_defaultFetchOptions>

#### Returns¶

Promise<void>

#### Defined in¶

src/resource/solidDataset.ts:832

### deleteSolidDataset¶

deleteSolidDataset(solidDataset, options?): Promise<void>

Deletes the SolidDataset at a given URL.

If operating on a container, the container must be empty otherwise a 409 CONFLICT will be raised.

since 0.6.0

#### Parameters¶

Name

Type

solidDataset

options

Partial<typeof internal_defaultFetchOptions>

#### Returns¶

Promise<void>

#### Defined in¶

src/resource/solidDataset.ts:468

### getContainedResourceUrlAll¶

getContainedResourceUrlAll(solidDataset): UrlString[]

Given a SolidDataset representing a Container (see isContainer), fetch the URLs of all contained resources. If the solidDataset given is not a container, or is missing resourceInfo, throw an error.

since 1.3.0

#### Parameters¶

Name

Type

Description

solidDataset

The container from which to fetch all contained Resource URLs.

#### Returns¶

A list of URLs, each of which points to a contained Resource of the given SolidDataset.

#### Defined in¶

src/resource/solidDataset.ts:871

### getSolidDataset¶

getSolidDataset(url, options?): Promise<SolidDataset & WithServerResourceInfo>

Fetch a SolidDataset from the given URL. Currently requires the SolidDataset to be available as Turtle.

#### Parameters¶

Name

Type

Description

url

URL to fetch a SolidDataset from.

options

Partial<typeof internal_defaultFetchOptions & ParseOptions>

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<SolidDataset & WithServerResourceInfo>

Promise resolving to a SolidDataset containing the data at the given Resource, or rejecting if fetching it failed.

#### Defined in¶

src/resource/solidDataset.ts:288

### getWellKnownSolid¶

getWellKnownSolid(url, options?): Promise<SolidDataset & WithServerResourceInfo>

Fetch the contents of ‘.well-known/solid’ for a given resource URL.

The contents of the ‘.well-known/solid’ endpoint define the capabilities of the server, and provide their associated endpoints/locations. This behaves similarly to the use of ‘.well-known’ endpoints in e.g. (OIDC servers)[https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfig]

since 1.12.0

#### Parameters¶

Name

Type

Description

url

URL of a Resource.

options

Partial<typeof internal_defaultFetchOptions & ParseOptions>

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<SolidDataset & WithServerResourceInfo>

Promise resolving to a SolidDataset containing the data at ‘.well-known/solid’ for the given Resource, or rejecting if fetching it failed.

#### Defined in¶

src/resource/solidDataset.ts:1153

### saveSolidDatasetAt¶

saveSolidDatasetAt<Dataset>(url, solidDataset, options?): Promise<Dataset & WithServerResourceInfo & WithChangeLog>

Given a SolidDataset, store it in a Solid Pod (overwriting the existing data at the given URL).

A SolidDataset keeps track of the data changes compared to the data in the Pod; i.e., the changelog tracks both the old value and new values of the property being modified. This function applies the changes to the current SolidDataset. If the old value specified in the changelog does not correspond to the value currently in the Pod, this function will throw an error. The SolidDataset returned by this function will contain the data sent to the Pod, and a ChangeLog up-to-date with the saved data. Note that if the data on the server was modified in between the first fetch and saving it, the updated data will not be reflected in the returned SolidDataset. To make sure you have the latest data, call getSolidDataset again after saving the data.

The Solid server will create any intermediary Containers that do not exist yet, so they do not need to be created in advance. For example, if the target URL is https://example.pod/container/resource and https://example.pod/container/ does not exist yet, it will exist after this function resolves successfully.

#### Type parameters¶

Name

Type

Dataset

extends Readonly<Object>

#### Parameters¶

Name

Type

Description

url

URL to save solidDataset to.

solidDataset

Dataset

The SolidDataset to save.

options

Partial<typeof internal_defaultFetchOptions>

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<Dataset & WithServerResourceInfo & WithChangeLog>

A Promise resolving to a SolidDataset containing the stored data, or rejecting if saving it failed.

#### Defined in¶

src/resource/solidDataset.ts:409

### saveSolidDatasetInContainer¶

saveSolidDatasetInContainer(containerUrl, solidDataset, options?): Promise<SolidDataset & WithResourceInfo>

Given a SolidDataset, store it in a Solid Pod in a new Resource inside a Container.

The Container at the given URL should already exist; if it does not, you can initialise it first using createContainerAt, or directly save the SolidDataset at the desired location using saveSolidDatasetAt.

#### Parameters¶

Name

Type

Description

containerUrl

URL of the Container in which to create a new Resource.

solidDataset

SolidDataset

The SolidDataset to save to a new Resource in the given Container.

options

SaveInContainerOptions

Optional parameter options.fetch: An alternative fetch function to make the HTTP request, compatible with the browser-native fetch API.

#### Returns¶

Promise<SolidDataset & WithResourceInfo>

A Promise resolving to a SolidDataset containing the saved data. The Promise rejects if the save failed.

#### Defined in¶

src/resource/solidDataset.ts:688

### solidDatasetAsMarkdown¶

solidDatasetAsMarkdown(solidDataset): string

Gets a human-readable representation of the given SolidDataset to aid debugging.

Note that changes to the exact format of the return value are not considered a breaking change; it is intended to aid in debugging, not as a serialisation method that can be reliably parsed.

since 0.3.0

#### Parameters¶

Name

Type

Description

solidDataset

SolidDataset

The SolidDataset to get a human-readable representation of.

#### Returns¶

string

#### Defined in¶

src/resource/solidDataset.ts:890