Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    minidompublic

    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.

    Keywords

    install

    npm i minidom

    Downloadsweekly downloads

    87

    version

    1.0.0

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar