1. module xml2js
   1. function xml2js.Builder (opts)
   2. function xml2js.Parser (opts)
   3. function xml2js.ValidationError (message)
   4. function xml2js.parseString (str, a, b)
   5. object xml2js
   6. object xml2js.Builder.prototype
   7. object xml2js.Parser.prototype
   8. object xml2js.ValidationError.prototype
   9. object xml2js.bom
   10. object xml2js.defaults
   11. object xml2js.processors
2. module xml2js.Builder
   1. function xml2js.Builder (opts)
3. module xml2js.Builder.prototype
   1. function xml2js.Builder.prototype.buildObject (rootObj)
4. module xml2js.Parser
   1. boolean xml2js.Parser.usingDomains
   2. function xml2js.Parser (opts)
   3. function xml2js.Parser.EventEmitter ()
   4. function xml2js.Parser.init ()
   5. function xml2js.Parser.listenerCount (emitter, type)
   6. number xml2js.Parser.defaultMaxListeners
   7. object xml2js.Parser.__super__
5. module xml2js.Parser.prototype
   1. function xml2js.Parser.prototype.assignOrPush (obj, key, newValue)
   2. function xml2js.Parser.prototype.constructor (opts)
   3. function xml2js.Parser.prototype.parseString (str, cb)
   4. function xml2js.Parser.prototype.processAsync ()
   5. function xml2js.Parser.prototype.reset ()
6. module xml2js.ValidationError
   1. function xml2js.ValidationError (message)
   2. function xml2js.ValidationError.captureStackTrace ()
   3. number xml2js.ValidationError.stackTraceLimit
   4. object xml2js.ValidationError.__super__
7. module xml2js.ValidationError.prototype
   1. function xml2js.ValidationError.prototype.constructor (message)
8. module xml2js.bom
   1. function xml2js.bom.stripBOM (str)
9. module xml2js.processors
   1. function xml2js.processors.firstCharLowerCase (str)
   2. function xml2js.processors.normalize (str)
   3. function xml2js.processors.parseBooleans (str)
   4. function xml2js.processors.parseNumbers (str)
   5. function xml2js.processors.stripPrefix (str)
10. module xml2js.xml2js
    1. function xml2js.xml2js.Builder (opts)
    2. function xml2js.xml2js.Parser (opts)
    3. function xml2js.xml2js.ValidationError (message)
    4. function xml2js.xml2js.parseString (str, a, b)
    5. object xml2js.xml2js.defaults
    6. object xml2js.xml2js.processors

module xml2js

function xml2js.Builder (opts)

• description and source-code

  function Builder(opts) {
    var key, ref, value;
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var obj = {name: "Super", Surname: "Man", age: 23};
  
  var builder = new xml2js.Builder();
  var xml = builder.buildObject(obj);
  ```
  
  At the moment, a one to one bi-directional conversion is guaranteed only for
  default configuration, except for `attrkey`, `charkey` and `explicitArray` options
  you can redefine to your taste. Writing CDATA is supported via setting the `cdata`
  option to `true`.
  ...

function xml2js.Parser (opts)

• description and source-code

  function Parser(opts) {
    this.parseString = bind(this.parseString, this);
    this.reset = bind(this.reset, this);
    this.assignOrPush = bind(this.assignOrPush, this);
    this.processAsync = bind(this.processAsync, this);
    var key, ref, value;
    if (!(this instanceof exports.Parser)) {
      return new exports.Parser(opts);
    }
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
    if (this.options.xmlns) {
      this.options.xmlnskey = this.options.attrkey + "ns";
    }
    if (this.options.normalizeTags) {
      if (!this.options.tagNameProcessors) {
        this.options.tagNameProcessors = [];
      }
      this.options.tagNameProcessors.unshift(processors.normalize);
    }
    this.reset();
  }

• example usage

  ...
  That's right, if you have been using xml-simple or a home-grown
  wrapper, this was added in 0.1.11 just for you:
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  ...

function xml2js.ValidationError (message)

• description and source-code

  function ValidationError(message) {
    this.message = message;
  }

• example usage

  n/a

function xml2js.parseString (str, a, b)

• description and source-code

  parseString = function (str, a, b) {
    var cb, options, parser;
    if (b != null) {
      if (typeof b === 'function') {
        cb = b;
      }
      if (typeof a === 'object') {
        options = a;
      }
    } else {
      if (typeof a === 'function') {
        cb = a;
      }
      options = {};
    }
    parser = new exports.Parser(options);
    return parser.parseString(str, cb);
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  
  Look ma, no event listeners!
  ...

module xml2js.Builder

function xml2js.Builder (opts)

• description and source-code

  function Builder(opts) {
    var key, ref, value;
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var obj = {name: "Super", Surname: "Man", age: 23};
  
  var builder = new xml2js.Builder();
  var xml = builder.buildObject(obj);
  ```
  
  At the moment, a one to one bi-directional conversion is guaranteed only for
  default configuration, except for `attrkey`, `charkey` and `explicitArray` options
  you can redefine to your taste. Writing CDATA is supported via setting the `cdata`
  option to `true`.
  ...

module xml2js.Builder.prototype

function xml2js.Builder.prototype.buildObject (rootObj)

• description and source-code

  buildObject = function (rootObj) {
    var attrkey, charkey, render, rootElement, rootName;
    attrkey = this.options.attrkey;
    charkey = this.options.charkey;
    if ((Object.keys(rootObj).length === 1) && (this.options.rootName === exports.defaults['0.2'].rootName)) {
      rootName = Object.keys(rootObj)[0];
      rootObj = rootObj[rootName];
    } else {
      rootName = this.options.rootName;
    }
    render = (function(_this) {
      return function(element, obj) {
        var attr, child, entry, index, key, value;
        if (typeof obj !== 'object') {
          if (_this.options.cdata && requiresCDATA(obj)) {
            element.raw(wrapCDATA(obj));
          } else {
            element.txt(obj);
          }
        } else {
          for (key in obj) {
            if (!hasProp.call(obj, key)) continue;
            child = obj[key];
            if (key === attrkey) {
              if (typeof child === "object") {
                for (attr in child) {
                  value = child[attr];
                  element = element.att(attr, value);
                }
              }
            } else if (key === charkey) {
              if (_this.options.cdata && requiresCDATA(child)) {
                element = element.raw(wrapCDATA(child));
              } else {
                element = element.txt(child);
              }
            } else if (Array.isArray(child)) {
              for (index in child) {
                if (!hasProp.call(child, index)) continue;
                entry = child[index];
                if (typeof entry === 'string') {
                  if (_this.options.cdata && requiresCDATA(entry)) {
                    element = element.ele(key).raw(wrapCDATA(entry)).up();
                  } else {
                    element = element.ele(key, entry).up();
                  }
                } else {
                  element = render(element.ele(key), entry).up();
                }
              }
            } else if (typeof child === "object") {
              element = render(element.ele(key), child).up();
            } else {
              if (typeof child === 'string' && _this.options.cdata && requiresCDATA(child)) {
                element = element.ele(key).raw(wrapCDATA(child)).up();
              } else {
                if (child == null) {
                  child = '';
                }
                element = element.ele(key, child.toString()).up();
              }
            }
          }
        }
        return element;
      };
    })(this);
    rootElement = builder.create(rootName, this.options.xmldec, this.options.doctype, {
      headless: this.options.headless,
      allowSurrogateChars: this.options.allowSurrogateChars
    });
    return render(rootElement, rootObj).end(this.options.renderOpts);
  }

• example usage

  ...
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var obj = {name: "Super", Surname: "Man", age: 23};
  
  var builder = new xml2js.Builder();
  var xml = builder.buildObject(obj);
  ```
  
  At the moment, a one to one bi-directional conversion is guaranteed only for
  default configuration, except for `attrkey`, `charkey` and `explicitArray` options
  you can redefine to your taste. Writing CDATA is supported via setting the `cdata`
  option to `true`.
  ...

module xml2js.Parser

function xml2js.Parser (opts)

• description and source-code

  function Parser(opts) {
    this.parseString = bind(this.parseString, this);
    this.reset = bind(this.reset, this);
    this.assignOrPush = bind(this.assignOrPush, this);
    this.processAsync = bind(this.processAsync, this);
    var key, ref, value;
    if (!(this instanceof exports.Parser)) {
      return new exports.Parser(opts);
    }
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
    if (this.options.xmlns) {
      this.options.xmlnskey = this.options.attrkey + "ns";
    }
    if (this.options.normalizeTags) {
      if (!this.options.tagNameProcessors) {
        this.options.tagNameProcessors = [];
      }
      this.options.tagNameProcessors.unshift(processors.normalize);
    }
    this.reset();
  }

• example usage

  ...
  That's right, if you have been using xml-simple or a home-grown
  wrapper, this was added in 0.1.11 just for you:
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  ...

function xml2js.Parser.EventEmitter ()

• description and source-code

  function EventEmitter() {
    EventEmitter.init.call(this);
  }

• example usage

  n/a

function xml2js.Parser.init ()

• description and source-code

  init = function () {
    this.domain = null;
    if (EventEmitter.usingDomains) {
      // if there is an active domain, then attach to it.
      domain = domain || require('domain');
      if (domain.active && !(this instanceof domain.Domain)) {
        this.domain = domain.active;
      }
    }
  
    if (!this._events || this._events === Object.getPrototypeOf(this)._events) {
      this._events = new EventHandlers();
      this._eventsCount = 0;
    }
  
    this._maxListeners = this._maxListeners || undefined;
  }

• example usage

  n/a

function xml2js.Parser.listenerCount (emitter, type)

• description and source-code

  listenerCount = function (emitter, type) {
    if (typeof emitter.listenerCount === 'function') {
      return emitter.listenerCount(type);
    } else {
      return listenerCount.call(emitter, type);
    }
  }

• example usage

  n/a

module xml2js.Parser.prototype

function xml2js.Parser.prototype.assignOrPush (obj, key, newValue)

• description and source-code

  assignOrPush = function (obj, key, newValue) {
    if (!(key in obj)) {
      if (!this.options.explicitArray) {
        return obj[key] = newValue;
      } else {
        return obj[key] = [newValue];
      }
    } else {
      if (!(obj[key] instanceof Array)) {
        obj[key] = [obj[key]];
      }
      return obj[key].push(newValue);
    }
  }

• example usage

  ...
      if (!hasProp.call(ref, key)) continue;
      if (!(attrkey in obj) && !_this.options.mergeAttrs) {
        obj[attrkey] = {};
      }
      newValue = _this.options.attrValueProcessors ? processName(_this.options.attrValueProcessors, node.attributes[key]) : node.attributes
  [key];
      processedKey = _this.options.attrNameProcessors ? processName(_this.options.attrNameProcessors, key) : key;
      if (_this.options.mergeAttrs) {
        _this.assignOrPush(obj, processedKey, newValue);
      } else {
        obj[attrkey][processedKey] = newValue;
      }
    }
  }
  obj["#name"] = _this.options.tagNameProcessors ? processName(_this.options.tagNameProcessors, node.name) : node.name;
  if (_this.options.xmlns) {
  ...

function xml2js.Parser.prototype.constructor (opts)

• description and source-code

  function Parser(opts) {
    this.parseString = bind(this.parseString, this);
    this.reset = bind(this.reset, this);
    this.assignOrPush = bind(this.assignOrPush, this);
    this.processAsync = bind(this.processAsync, this);
    var key, ref, value;
    if (!(this instanceof exports.Parser)) {
      return new exports.Parser(opts);
    }
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
    if (this.options.xmlns) {
      this.options.xmlnskey = this.options.attrkey + "ns";
    }
    if (this.options.normalizeTags) {
      if (!this.options.tagNameProcessors) {
        this.options.tagNameProcessors = [];
      }
      this.options.tagNameProcessors.unshift(processors.normalize);
    }
    this.reset();
  }

• example usage

  n/a

function xml2js.Parser.prototype.parseString (str, cb)

• description and source-code

  parseString = function (str, cb) {
    var err, error1;
    if ((cb != null) && typeof cb === "function") {
      this.on("end", function(result) {
        this.reset();
        return cb(null, result);
      });
      this.on("error", function(err) {
        this.reset();
        return cb(err);
      });
    }
    try {
      str = str.toString();
      if (str.trim() === '') {
        this.emit("end", null);
        return true;
      }
      str = bom.stripBOM(str);
      if (this.options.async) {
        this.remaining = str;
        setImmediate(this.processAsync);
        return this.saxParser;
      }
      return this.saxParser.write(str).close();
    } catch (error1) {
      err = error1;
      if (!(this.saxParser.errThrown || this.saxParser.ended)) {
        this.emit('error', err);
        return this.saxParser.errThrown = true;
      } else if (this.saxParser.ended) {
        throw err;
      }
    }
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  
  Look ma, no event listeners!
  ...

function xml2js.Parser.prototype.processAsync ()

• description and source-code

  processAsync = function () {
    var chunk, err, error1;
    try {
      if (this.remaining.length <= this.options.chunkSize) {
        chunk = this.remaining;
        this.remaining = '';
        this.saxParser = this.saxParser.write(chunk);
        return this.saxParser.close();
      } else {
        chunk = this.remaining.substr(0, this.options.chunkSize);
        this.remaining = this.remaining.substr(this.options.chunkSize, this.remaining.length);
        this.saxParser = this.saxParser.write(chunk);
        return setImmediate(this.processAsync);
      }
    } catch (error1) {
      err = error1;
      if (!this.saxParser.errThrown) {
        this.saxParser.errThrown = true;
        return this.emit(err);
      }
    }
  }

• example usage

  n/a

function xml2js.Parser.prototype.reset ()

• description and source-code

  reset = function () {
    var attrkey, charkey, ontext, stack;
    this.removeAllListeners();
    this.saxParser = sax.parser(this.options.strict, {
      trim: false,
      normalize: false,
      xmlns: this.options.xmlns
    });
    this.saxParser.errThrown = false;
    this.saxParser.onerror = (function(_this) {
      return function(error) {
        _this.saxParser.resume();
        if (!_this.saxParser.errThrown) {
          _this.saxParser.errThrown = true;
          return _this.emit("error", error);
        }
      };
    })(this);
    this.saxParser.onend = (function(_this) {
      return function() {
        if (!_this.saxParser.ended) {
          _this.saxParser.ended = true;
          return _this.emit("end", _this.resultObject);
        }
      };
    })(this);
    this.saxParser.ended = false;
    this.EXPLICIT_CHARKEY = this.options.explicitCharkey;
    this.resultObject = null;
    stack = [];
    attrkey = this.options.attrkey;
    charkey = this.options.charkey;
    this.saxParser.onopentag = (function(_this) {
      return function(node) {
        var key, newValue, obj, processedKey, ref;
        obj = {};
        obj[charkey] = "";
        if (!_this.options.ignoreAttrs) {
          ref = node.attributes;
          for (key in ref) {
            if (!hasProp.call(ref, key)) continue;
            if (!(attrkey in obj) && !_this.options.mergeAttrs) {
              obj[attrkey] = {};
            }
            newValue = _this.options.attrValueProcessors ? processName(_this.options.attrValueProcessors, node.attributes[key]) :
  node.attributes[key];
            processedKey = _this.options.attrNameProcessors ? processName(_this.options.attrNameProcessors, key) : key;
            if (_this.options.mergeAttrs) {
              _this.assignOrPush(obj, processedKey, newValue);
            } else {
              obj[attrkey][processedKey] = newValue;
            }
          }
        }
        obj["#name"] = _this.options.tagNameProcessors ? processName(_this.options.tagNameProcessors, node.name) : node.name;
        if (_this.options.xmlns) {
          obj[_this.options.xmlnskey] = {
            uri: node.uri,
            local: node.local
          };
        }
        return stack.push(obj);
      };
    })(this);
    this.saxParser.onclosetag = (function(_this) {
      return function() {
        var cdata, emptyStr, err, error1, key, node, nodeName, obj, objClone, old, s, xpath;
        obj = stack.pop();
        nodeName = obj["#name"];
        if (!_this.options.explicitChildren || !_this.options.preserveChildrenOrder) {
          delete obj["#name"];
        }
        if (obj.cdata === true) {
          cdata = obj.cdata;
          delete obj.cdata;
        }
        s = stack[stack.length - 1];
        if (obj[charkey].match(/^\s*$/) && !cdata) {
          emptyStr = obj[charkey];
          delete obj[charkey];
        } else {
          if (_this.options.trim) {
            obj[charkey] = obj[charkey].trim();
          }
          if (_this.options.normalize) {
            obj[charkey] = obj[charkey].replace(/\s{2,}/g, " ").trim();
          }
          obj[charkey] = _this.options.valueProcessors ? processName(_this.options.valueProcessors, obj[charkey]) : obj[charkey];
          if (Object.keys(obj).length === 1 && charkey in obj && !_this.EXPLICIT_CHARKEY) {
            obj = obj[charkey];
          }
        }
        if (isEmpty(obj)) {
          obj = _this.options.emptyTag !== '' ? _this.options.emptyTag : emptyStr;
        }
        if (_this.options.validator != null) {
          xpath = "/" + ((function() {
            var i, len, results;
            results = [];
            for (i = 0, len = stack.length; i < len; i++) {
              node = stack[i];
              results.push(node["#name"]);
            }
            return results;
          })()).concat(nodeName).join("/");
          try {
            obj = _this.options.validator(xpath, s && s[nodeName], obj);
          } catch (error1) {
            err = error1;
            _this.emit("error", err);
          }
        }
        if (_this.options.explicitChildren && !_this.options.mergeAttrs && typeof obj === 'object') {
          if (!_this.options.preserveChildrenOrder) {
            node = {};
            if (_this.options.attrkey in obj) {
              node[_ ...

• example usage

  ...
    }
    if (this.options.normalizeTags) {
      if (!this.options.tagNameProcessors) {
        this.options.tagNameProcessors = [];
      }
      this.options.tagNameProcessors.unshift(processors.normalize);
    }
    this.reset();
  }
  
  Parser.prototype.processAsync = function() {
    var chunk, err, error1;
    try {
      if (this.remaining.length <= this.options.chunkSize) {
        chunk = this.remaining;
  ...

module xml2js.ValidationError

function xml2js.ValidationError (message)

• description and source-code

  function ValidationError(message) {
    this.message = message;
  }

• example usage

  n/a

function xml2js.ValidationError.captureStackTrace ()

• description and source-code

  function captureStackTrace() { [native code] }

• example usage

  n/a

module xml2js.ValidationError.prototype

function xml2js.ValidationError.prototype.constructor (message)

• description and source-code

  function ValidationError(message) {
    this.message = message;
  }

• example usage

  n/a

module xml2js.bom

function xml2js.bom.stripBOM (str)

• description and source-code

  stripBOM = function (str) {
    if (str[0] === '\uFEFF') {
      return str.substring(1);
    } else {
      return str;
    }
  }

• example usage

  ...
  }
  try {
    str = str.toString();
    if (str.trim() === '') {
      this.emit("end", null);
      return true;
    }
    str = bom.stripBOM(str);
    if (this.options.async) {
      this.remaining = str;
      setImmediate(this.processAsync);
      return this.saxParser;
    }
    return this.saxParser.write(str).close();
  } catch (error1) {
  ...

module xml2js.processors

function xml2js.processors.firstCharLowerCase (str)

• description and source-code

  firstCharLowerCase = function (str) {
    return str.charAt(0).toLowerCase() + str.slice(1);
  }

• example usage

  n/a

function xml2js.processors.normalize (str)

• description and source-code

  normalize = function (str) {
    return str.toLowerCase();
  }

• example usage

  n/a

function xml2js.processors.parseBooleans (str)

• description and source-code

  parseBooleans = function (str) {
    if (/^(?:true|false)$/i.test(str)) {
      str = str.toLowerCase() === 'true';
    }
    return str;
  }

• example usage

  n/a

function xml2js.processors.parseNumbers (str)

• description and source-code

  parseNumbers = function (str) {
    if (!isNaN(str)) {
      str = str % 1 === 0 ? parseInt(str, 10) : parseFloat(str);
    }
    return str;
  }

• example usage

  n/a

function xml2js.processors.stripPrefix (str)

• description and source-code

  stripPrefix = function (str) {
    return str.replace(prefixMatch, '');
  }

• example usage

  n/a

module xml2js.xml2js

function xml2js.xml2js.Builder (opts)

• description and source-code

  function Builder(opts) {
    var key, ref, value;
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var obj = {name: "Super", Surname: "Man", age: 23};
  
  var builder = new xml2js.Builder();
  var xml = builder.buildObject(obj);
  ```
  
  At the moment, a one to one bi-directional conversion is guaranteed only for
  default configuration, except for `attrkey`, `charkey` and `explicitArray` options
  you can redefine to your taste. Writing CDATA is supported via setting the `cdata`
  option to `true`.
  ...

function xml2js.xml2js.Parser (opts)

• description and source-code

  function Parser(opts) {
    this.parseString = bind(this.parseString, this);
    this.reset = bind(this.reset, this);
    this.assignOrPush = bind(this.assignOrPush, this);
    this.processAsync = bind(this.processAsync, this);
    var key, ref, value;
    if (!(this instanceof exports.Parser)) {
      return new exports.Parser(opts);
    }
    this.options = {};
    ref = exports.defaults["0.2"];
    for (key in ref) {
      if (!hasProp.call(ref, key)) continue;
      value = ref[key];
      this.options[key] = value;
    }
    for (key in opts) {
      if (!hasProp.call(opts, key)) continue;
      value = opts[key];
      this.options[key] = value;
    }
    if (this.options.xmlns) {
      this.options.xmlnskey = this.options.attrkey + "ns";
    }
    if (this.options.normalizeTags) {
      if (!this.options.tagNameProcessors) {
        this.options.tagNameProcessors = [];
      }
      this.options.tagNameProcessors.unshift(processors.normalize);
    }
    this.reset();
  }

• example usage

  ...
  That's right, if you have been using xml-simple or a home-grown
  wrapper, this was added in 0.1.11 just for you:
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  ...

function xml2js.xml2js.ValidationError (message)

• description and source-code

  function ValidationError(message) {
    this.message = message;
  }

• example usage

  n/a

function xml2js.xml2js.parseString (str, a, b)

• description and source-code

  parseString = function (str, a, b) {
    var cb, options, parser;
    if (b != null) {
      if (typeof b === 'function') {
        cb = b;
      }
      if (typeof a === 'object') {
        options = a;
      }
    } else {
      if (typeof a === 'function') {
        cb = a;
      }
      options = {};
    }
    parser = new exports.Parser(options);
    return parser.parseString(str, cb);
  }

• example usage

  ...
  
  ```javascript
  var fs = require('fs'),
      xml2js = require('xml2js');
  
  var parser = new xml2js.Parser();
  fs.readFile(__dirname + '/foo.xml', function(err, data) {
      parser.parseString(data, function (err, result) {
          console.dir(result);
          console.log('Done');
      });
  });
  ```
  
  Look ma, no event listeners!
  ...