xmldom-sre

XMLDOM

This is a fork of jindw's xmldom library together with Rui Azevedo code for compareDocumentPosition. It allows the use of wicked-good-xpath together with xmldom, using a little hack. For an example see speech-rule-engine.

Just to be clear: This is not my code! You are welcome to use the package, but I can not fix any bugs!

A JavaScript implementation of W3C DOM for Node.js, Rhino and the browser. Fully compatible with W3C DOM level2; and some compatible with level3. Supports DOMParser and XMLSerializer interface such as in browser.

Install:

npm install xmldom-sre

Example:

var DOMParser = require('xmldom').DOMParser;
var doc = new DOMParser().parseFromString(
    '<xml xmlns="a" xmlns:c="./lite">\n'+
        '\t<child>test</child>\n'+
        '\t<child></child>\n'+
        '\t<child/>\n'+
    '</xml>'
    ,'text/xml');
doc.documentElement.setAttribute('x','y');
doc.documentElement.setAttributeNS('./lite','c:x','y2');
var nsAttr = doc.documentElement.getAttributeNS('./lite','x')
console.info(nsAttr)
console.info(doc)

API Reference

• DOMParser:

  parseFromString(xmlsource,mimeType)
  

  • options extension by xmldom(not BOM standard!!)

  //added the options argument
  new DOMParser(options)
  
  //errorHandler is supported
  new DOMParser({
  	/**
  	 * locator is always need for error position info
  	 */
  	locator:{},
  	/**
  	 * you can override the errorHandler for xml parser
  	 * @link http://www.saxproject.org/apidoc/org/xml/sax/ErrorHandler.html
  	 */
  	errorHandler:{warning:function(w){console.warn(w)},error:callback,fatalError:callback}
  	//only callback model
  	//errorHandler:function(level,msg){console.log(level,msg)}
  })
  	
  

• XMLSerializer

  serializeToString(node)
  

DOM level2 method and attribute:

• Node

   attribute:
   	nodeValue|prefix
   readonly attribute:
   	nodeName|nodeType|parentNode|childNodes|firstChild|lastChild|previousSibling|nextSibling|attributes|ownerDocument|namespaceURI|localName
   method:	
   	insertBefore(newChild, refChild)
   	replaceChild(newChild, oldChild)
   	removeChild(oldChild)
   	appendChild(newChild)
   	hasChildNodes()
   	cloneNode(deep)
   	normalize()
   	isSupported(feature, version)
   	hasAttributes()
  

• DOMImplementation

   method:
   	hasFeature(feature, version)
   	createDocumentType(qualifiedName, publicId, systemId)
   	createDocument(namespaceURI, qualifiedName, doctype)
  

• Document : Node

   readonly attribute:
   	doctype|implementation|documentElement
   method:
   	createElement(tagName)
   	createDocumentFragment()
   	createTextNode(data)
   	createComment(data)
   	createCDATASection(data)
   	createProcessingInstruction(target, data)
   	createAttribute(name)
   	createEntityReference(name)
   	getElementsByTagName(tagname)
   	importNode(importedNode, deep)
   	createElementNS(namespaceURI, qualifiedName)
   	createAttributeNS(namespaceURI, qualifiedName)
   	getElementsByTagNameNS(namespaceURI, localName)
   	getElementById(elementId)
  

• DocumentFragment : Node

• Element : Node

   readonly attribute:
   	tagName
   method:
   	getAttribute(name)
   	setAttribute(name, value)
   	removeAttribute(name)
   	getAttributeNode(name)
   	setAttributeNode(newAttr)
   	removeAttributeNode(oldAttr)
   	getElementsByTagName(name)
   	getAttributeNS(namespaceURI, localName)
   	setAttributeNS(namespaceURI, qualifiedName, value)
   	removeAttributeNS(namespaceURI, localName)
   	getAttributeNodeNS(namespaceURI, localName)
   	setAttributeNodeNS(newAttr)
   	getElementsByTagNameNS(namespaceURI, localName)
   	hasAttribute(name)
   	hasAttributeNS(namespaceURI, localName)
  

• Attr : Node

   attribute:
   	value
   readonly attribute:
   	name|specified|ownerElement
  

• NodeList

   readonly attribute:
   	length
   method:
   	item(index)
  

• NamedNodeMap

   readonly attribute:
   	length
   method:
   	getNamedItem(name)
   	setNamedItem(arg)
   	removeNamedItem(name)
   	item(index)
   	getNamedItemNS(namespaceURI, localName)
   	setNamedItemNS(arg)
   	removeNamedItemNS(namespaceURI, localName)
   
  

• CharacterData : Node

   method:
   	substringData(offset, count)
   	appendData(arg)
   	insertData(offset, arg)
   	deleteData(offset, count)
   	replaceData(offset, count, arg)
   
  

• Text : CharacterData

   method:
   	splitText(offset)
   	
  

• CDATASection

• Comment : CharacterData

• DocumentType

   readonly attribute:
   	name|entities|notations|publicId|systemId|internalSubset
   	
  

• Notation : Node

   readonly attribute:
   	publicId|systemId
   	
  

• Entity : Node

   readonly attribute:
   	publicId|systemId|notationName
   	
  

• EntityReference : Node

• ProcessingInstruction : Node

   attribute:
   	data
   readonly attribute:
   	target
   
  

DOM level 3 support:

• Node

   attribute:
   	textContent
   method:
   	isDefaultNamespace(namespaceURI){
   	lookupNamespaceURI(prefix)
  

DOM extension by xmldom

• [Node] Source position extension;

   attribute:
   	//Numbered starting from '1'
   	lineNumber
   	//Numbered starting from '1'
   	columnNumber
  

Changelog

0.1.31

Commits

The patch versions (v0.1.29 - v0.1.31) that have been released on the v0.1.x branch, to reflect the changed maintainers, are branched off from v0.1.27 so they don't include the breaking changes introduced in xmldom-alpha@v0.1.28:

Maintainer changes

After the last commit to the original repository https://github.com/jindw/xmldom on the 9th of May 2017, the first commit to https://github.com/xmldom/xmldom is from the 19th of December 2019. The fork has been announced in the original repository on the 2nd of March 2020.

The versions listed below have been published to one or both of the following packages:

• https://www.npmjs.com/package/xmldom-alpha
• https://www.npmjs.com/package/xmldom

It is currently not planned to continue publishing the xmldom-alpha package.

The new maintainers did not invest time to understand changes that led to the last xmldom version 0.1.27 published by the original maintainer, but consider it the basis for their work. A timeline of all the changes that happened from that version until 0.3.0 is available in https://github.com/xmldom/xmldom/issues/62. Any related questions should be asked there.