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 (< 5Kb 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',
  'bar': 'http://bar'
});

parser.on('startNode', function(elementName, getAttrs, decodeEntity, isClosing, getContext) {

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

  var attrs = getAttrs();
  // { name: value }
});

parser.on('endNode', function(elementName, decodeEntity, isOpening, getContext) {
  ...
});

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

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

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

1.0.0

• FEAT: don't skip unknown namespace nodes
• FEAT: expose parse context in startNode, endNode and error
• FEAT: introduce parser object mode
• FEAT: pipe handler errors to error handler
• FEAT: allow non-args #ns call
• FIX: various namespace handling errors
• STYLE: unify code style
• CHORE: rename library to saxen
• CHORE: improve test coverage
• CHORE: add linting
• DOCS: move to english language for documentation and README

...

Check git log for earlier history.