@allegro/convert-description

A JavaScript library to convert HTML-rich offer & product descriptions into a format accepted by Allegro Rest API.

Live demo.

Motivation

Provide means to ease the conversion of HTML-rich offer & product descriptions into a format accepted by Allegro Rest API. As such, the library covers basic functionality. Any client-specific behavior must be provided externally. The library can facilitate that through extensibility.

Requirements

The library requires DOM API, which can be provided in two ways: either implicitly as globals by the browser environment or explicitly as the parseToDOM function in the Node.js environment (see Usage section).

The following requirements apply to Node.js as a runtime or build environment.

• node version >=20
• npm version >=10

Installation

1npm i @allegro/convert-description

For the Node.js runtime environment, include jsdom.

1npm i @allegro/convert-description jsdom

Usage

API

JavaScript code

1import { convertDescriptionToItems } from '@allegro/convert-description';
2
3const description = `
4    <div>
5          <div>test content</div>
6          <img src="/test_url" />
7    </div>
8    `;
9
10const items = convertDescriptionToItems(description);
11
12console.log(JSON.stringify(items));

Code output

1[{"type":"TEXT","content":"<p>test content</p>"},{"type":"IMAGE","url":"/test_url"}]

For the Node.js runtime environment, pass the parseToDOM function.

1import { convertDescriptionToItems } from '@allegro/convert-description';
2import { JSDOM } from 'jsdom';
3
4function parseToDOM(html) {
5  return new JSDOM(html);
6}
7
8const description = `
9    <div>
10          <div>test content</div>
11          <img src="/test_url" />
12    </div>
13    `;
14const items = convertDescriptionToItems(description, { parseToDOM });
15
16console.log(JSON.stringify(items));

[!CAUTION] Any option to convertDescriptionToItems that is not mentioned in the documentation is subject to change. If you need anything more than the listed options, ask a question by opening an issue or contribute by creating a pull request.

CLI

1$ echo "<p>Hello World</p>" | npx @allegro/convert-description
2[{"type":"TEXT","content":"<p>Hello World</p>"}]