@drupal/linkset

1.0.3 • Public • Published

Linkset

Index

  • Introduction
  • Requirements
  • Recommended modules and packages
  • Installation
  • Usage
  • Development
  • Maintainers

Introduction

Serialization and utility library for application/linkset+json documents.

The RFC 9264 specification defines two formats and associated media types for representing sets of links as standalone documents. This library provides various utilities to work with the JSON based format of RFC 9264.

Read more about the linkset specification on RFC 9264 on datatracker.ietf.org website.

Requirements

This project has no other node package as dependency.

Installation

Install the package via npm:

$ npm i @drupal/linkset

Usage

import { denormalize, parse } from '@drupal/linkset';

Function denormalize

Denormalizes a set of links into an instance of a Linkset.

Params Type Description
normalized NormalizedLinksetInterface JavaScript object representing linkset

E.g. usage

import { denormalize } from '@drupal/linkset';
// Fetch the linkset data using your custom logic.
const linksetDataString = custom_function_to_fetch_linkset_data_as_string();
// Use denormalize to convert the data.
// Notice the usage of JSON.parse which converts JSON string into a
// JavaScript object.
const linkset = denormalize(JSON.parse(linksetDataString));

Function parse

Parses an application/linkset+json document into a Linkset instance.

The difference between denormalize and parse is the input parameter. parse expects a JSON string, while denormalize expects an object.

Params Type Description
json string The JSON Data string adhering to linkset specificaiton

E.g. usage

import { parse } from '@drupal/linkset';
// Fetch the linkset data using your custom logic.
const linksetDataString = custom_function_to_fetch_linkset_data_as_string();
// Use the `parse` utility to convert the data.
const linkset = parse(linksetDataString);

TypeScript Support

For those who are developing using TypeScript, you can import the available types as shown below.

E.g. usage

import {
    LinkInterface,
    LinksetInterface,
    NormalizedLinksetInterface,
    NormalizableLinksetInterface } from '@drupal/linkset';

Development

Development of this project is currently happening in Drupal.org

Maintainers

Current maintainers:

Readme

Keywords

none

Package Sidebar

Install

npm i @drupal/linkset

Weekly Downloads

59

Version

1.0.3

License

GPL-2.0-or-later

Unpacked Size

1.11 MB

Total Files

22

Last publish

Collaborators

  • mixologic
  • justafish
  • drupalengineering