saxen

/saxen/ parser

A tiny, super fast, namespace aware sax-style XML parser written in plain JavaScript.

Features

• (optional) entity decoding and attribute parsing
• (optional) namespace aware
• element / attribute normalization in namespaced mode
• tiny (4Kb minified + gzipped)

Usage

var Parser = require('saxen');

var parser = new Parser();

// enable namespace parsing
// element prefixes will automatically adjusted
// to the ones configured here
parser.ns({
  'http://foo': 'foo',
  'http://bar': 'bar'
});

parser.on('openTag', function(elementName, getAttrs, decodeEntity, selfClosing, getContext) {

  elementName;
  // with prefix, i.e. foo:blub

  var attrs = getAttrs();
  // { 'bar:aa': 'A', ... }
});

parser.on('closeTag', function(elementName, decodeEntity, selfClosing, getContext) {
  ...
});

parser.on('error', function(err, getContext) {
  // rethrow or compensate for err
});

parser.parse('<blub xmlns="http://foo" xmlns:bar="http://bar" bar:aa="A" />');

Credits

This library builds on the awesome work done by easysax and adds anonymous namespace handling and an object mode.

It is named after Sachsen, a federal state of Germany. So geht sächsisch!

LICENSE

MIT

Changelog

3.1.0

• FEAT: keep non-decodeable entities as is
• FEAT: decode only required sub-set of named entities