minimal-xml-parser

0.1.0 • Public • Published

minimal-xml-parser

This is a simple XML parser. It does no validation beyond requiring the input to be well-formed.

It produces its output as a DOM Document Fragment. The user is required to supply the DOM implementation. Any implementation that conforms to DOM (Core) Level 1 may be used. minimal-dom is one such implementation.

Installation

Using npm:

npm install minimal-xml-parser

Example Usage

const Parser = require('minimal-xml-parser');
const Document = require('minimal-dom');

const xml = '<example><greeting>Hello, world!</greeting></example>'

let fragment = new Parser(xml, new Document()).parse();

console.log(String(fragment.firstChild.firstChild));

// outputs:
// <greeting>Hello, world!</greeting>

API

This module exports one class as its default:

Parser

The parser class provides the following methods:

It also provides the following property on the class:

new Parser(source, doc[, sourceName])

Parameters

  • source: String The XML document or fragment to parse
  • doc: Document An instance of a DOM Document that will be used to create the parser output.
  • sourceName: String (Optional) The name of the source (such as a file name) to use in any errors produced by the parser. Defaults to "<INPUT>".

Return Value

A new Parser instance.

Description

Creates a new instance of Parser. The document is not actually parsed until parse is called.

parser.parse()

Parameters

None.

Return Value

A DocumentFragment containing the parsed content.

Description

Parses the XML source supplied to the constructor. It creates a new DocumentFragment using the Document supplied to the constructor and adds all encountered elements and their content to that fragment. If any errors are encountered, this method throws an XMLSyntaxError.

Parser.XMLSyntaxError

The XMLSyntaxError property of the Parser class provides a reference to the XMLSyntaxError class:

const XMLSyntaxError = require('minimal-xml-parser').XMLSyntaxError;

try {
  callSomeRoutineThatParsesXML();
} catch (e) {
  if (e instanceof XMLSyntaxError)
    // error due to a parsing failure
  else
    // some other error
}

XMLSyntaxError

XMLSyntaxError is an Error class, instances of which are thrown when the parser encounters an error. Its message contains a full description of the error. It also provides the following properties:

  • sourceName: String The name of the source that produced the error.
  • line: Number The line number where the error occurred
  • column: Number The offset in characters on the line where the error occurred.
  • expected: String A token or description of what was expected next for valid XML.
  • actual: String The value that was encountered.

Dependencies (0)

    Dev Dependencies (2)

    Package Sidebar

    Install

    npm i minimal-xml-parser

    Weekly Downloads

    0

    Version

    0.1.0

    License

    MIT

    Unpacked Size

    32.5 kB

    Total Files

    10

    Last publish

    Collaborators

    • jeffreyahunter