|rev.:|0.1.11| |:---|---:| |date:|2026-03-31|

Introduction

This module provide a base functionality for handling an XML-documents.

Description

This module contains the following components:

1. xObj-manipulator

xObj-manipulator is a set of functions (see docs for @ygracs/xobj-lib-js module).

2. a set of XML-document constants and components

• constants:

  • XML_DEF_ROOT_ETAG_NAME;
  • XML_DEF_PARSE_OPTIONS;

• functions:

  • readAsTagName (experimental);
  • readAsAttrName (experimental);
  • readAsAttrValue (experimental);
  • valueToElementID (experimental);

• classes:

  • TXmlAttributesMapper;
  • TXmlElementController;
  • TXmlElementsListController;
  • TXmlContentParseOptions;
  • TXmlContentDeclaration;
  • TXmlContentRootElement;
  • TXmlContentContainer.

For more read the xmldoc-lib.md in the project doc directory.

3. an xmlHelper module extension

• functions:

  • getChildByPath;
  • addChildByPath;
  • extractTextValues;
  • extractTextValuesLn.

For more read the xmldoc-lib.md in the project doc directory.

Use cases

Installation

npm install @cntwg/xml-lib-js

Note: It's recommended to "pin" a package versions range to its minor releases after installation. To do so use ~ range specifier (e.g. ~0.0.40) in package.json.