❤
npm
Sign UpSign In

minidom

1.0.0 • Public • Published

minidom

A small JavaScript DOM. Implements DOM level 1, with textContent from level 3 and innerHTML and outerHTML getters. Only supports HTML documents.

Usage

var minidom = require("minidom");
 
var document = minidom('<!doctype><html><head><title>Hello</title><body><h1>Hi!</h1></body></html>');
 
expect(document.getElementsByTagName("h1")[0].textContent).toEqual("Hi!");

You can also access the DOM implementation used internally:

var dom = require("minidom/dom");
 
var document = minidom();
expect(document instanceof dom.Node).toBeTruthy();

Differences with JSDom

JSDom minidom
Runs Javascript in the page context Yes No
CSSOM Yes No
Loads remote resources Yes No
HTML5 parsing algorithm No Yes*
Runs in the browser No Yes**
Awesome Yes Yes

Basically minidom does a lot less, but often it's all you need.

* This means that the DOM representation is the same as you would get in the browser, but may not be suitable if you wish to preserve as much of the original formatting as possible. For example parsing <body>hi</body><head><title>hello</title> with minidom results in a document that looks like <html><head></head><body>hi<title>hello</title></body></html>, where as JSDom outputs <html><body>hi</body><head><title>hello</title></head></html>.

** This is probably very cool, although I have no idea why.

Supported API

Properties marked ⃠  are read-only

Node

  • ELEMENT_NODE
  • ATTRIBUTE_NODE
  • TEXT_NODE
  • CDATA_SECTION_NODE
  • ENTITY_REFERENCE_NODE
  • ENTITY_NODE
  • PROCESSING_INSTRUCTION_NODE
  • COMMENT_NODE
  • DOCUMENT_NODE
  • DOCUMENT_TYPE_NODE
  • DOCUMENT_FRAGMENT_NODE
  • NOTATION_NODE
  • children ⃠
  • nodeValue
  • parentNode ⃠
  • nodeName ⃠
  • attributes ⃠
  • firstChild ⃠
  • ownerDocument ⃠
  • readonly ⃠
  • lastChild ⃠
  • childNodes ⃠
  • nextSibling ⃠
  • previousSibling ⃠
  • insertBefore(/* Node */ newChild, /* Node*/ refChild)
  • replaceChild(/* Node */ newChild, /* Node */ oldChild)
  • removeChild(/* Node */ oldChild)
  • appendChild(/* Node */ newChild)
  • hasChildNodes()
  • cloneNode(/* bool */ deep, fn)
  • normalize()
  • toString()
  • raise(type, message, data)
  • textContent

Document (inherits from Node)

  • nodeType
  • contentType ⃠
  • doctype
  • documentElement ⃠
  • implementation
  • nodeName ⃠
  • tagName ⃠
  • nodeValue
  • attributes ⃠
  • ownerDocument ⃠
  • readonly ⃠
  • createElement(/* string */ tagName)
  • createDocumentFragment()
  • createTextNode(/* string */ data)
  • createComment(/* string */ data)
  • createCDATASection(/* string */ data)
  • createProcessingInstruction(/* string */ target, /* string */ data)
  • createAttribute(/* string */ name)
  • createEntityReference(/* string */ name)
  • createEntityNode(/* string */ name)
  • createNotationNode(/* string */ name, /* string */ publicId, /* string */ systemId)
  • appendChild(/* Node */ arg)
  • removeChild(/* Node */ arg)
  • getElementsByTagName(/* string */ name)
  • outerHTML ⃠

Element (inherits from Node)

  • nodeValue
  • tagName ⃠
  • nodeType
  • attributes ⃠
  • getAttribute(/* string */ name)
  • setAttribute(/* string */ name, /* string */ value)
  • removeAttribute(/* string */ name)
  • getAttributeNode(/* string */ name)
  • setAttributeNode(/* Attr */ newAttr)
  • removeAttributeNode(/* Attr */ oldAttr)
  • getElementsByTagName(/* string */ name)
  • outerHTML ⃠
  • innerHTML ⃠

Thanks

Made possible with large excerpts from JSDom, and the excellent parse5 implementation of the HTML5 parsing algorithm.

License

MIT license. See LICENSE.md for details.

Readme

Keywords

Package Sidebar

Install

npm i minidom

Repository

github.com/montagejs/minidom

Homepage

github.com/montagejs/minidom

Weekly Downloads

10

Version

1.0.0

License

MIT

Last publish

Collaborators

  • stuk
Try on RunKit
Report malware