Class HTMLDocumentImpl

java.lang.Object

org.htmlunit.cyberneko.xerces.dom.NodeImpl

org.htmlunit.cyberneko.xerces.dom.ChildNode

org.htmlunit.cyberneko.xerces.dom.ParentNode

org.htmlunit.cyberneko.xerces.dom.CoreDocumentImpl

org.htmlunit.cyberneko.xerces.dom.DocumentImpl

org.htmlunit.cyberneko.html.dom.HTMLDocumentImpl

All Implemented Interfaces:

Cloneable, Document, DocumentEvent, EventTarget, org.w3c.dom.html.HTMLDocument, Node, NodeList

public class HTMLDocumentImpl
extends DocumentImpl
implements org.w3c.dom.html.HTMLDocument

Implements an HTML document. Provides access to the top level element in the document, its body and title.

Several methods create new nodes of all basic types (comment, text, element, etc.). These methods create new nodes but do not place them in the document tree. The nodes may be placed in the document tree using Node.appendChild(Node) or Node.insertBefore(Node, Node), or they may be placed in some other document tree.

Note: <FRAMESET> documents are not supported at the moment, neither are direct document writing (open(), write(String)) and HTTP attribute methods (getURL(), getCookie()).

See Also:

• HTMLDocument

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	HTMLDocumentImpl.ElementTypesHTMLHolder

Field Summary

Fields

Modifier and Type	Field	Description
private HTMLCollectionImpl	anchors_	Holds HTMLCollectionImpl object with live collection of all anchors in document.
private HTMLCollectionImpl	applets_	Holds HTMLCollectionImpl object with live collection of all applets in document.
private static final Class<?>[]	elemClassSigHTML_	Signature used to locate constructor of HTML element classes.
private static final FastHashMap<String, HTMLDocumentImpl.ElementTypesHTMLHolder>	elementTypesHTMLLower_	Holds names and classes of HTML element types.
private static final FastHashMap<String, HTMLDocumentImpl.ElementTypesHTMLHolder>	elementTypesHTMLUpper_
private HTMLCollectionImpl	forms_	Holds HTMLCollectionImpl object with live collection of all forms in document.
private static final String[]	HTML5ELEMENTS	All valid HTML5 tags without deprecated elements https://www.tutorialrepublic.com/html-reference/html5-tags.php
private HTMLCollectionImpl	images_	Holds HTMLCollectionImpl object with live collection of all images in document.
private HTMLCollectionImpl	links_	Holds HTMLCollectionImpl object with live collection of all links in document.
private StringWriter	writer_	Holds string writer used by direct manipulation operation (open().

Fields inherited from class CoreDocumentImpl

allowGrammarAccess, changes, errorChecking

Fields inherited from class ParentNode

firstChild, fNodeListCache, ownerDocument

Fields inherited from class ChildNode

nextSibling_, previousSibling_

Fields inherited from class NodeImpl

DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_IS_CONTAINED, DOCUMENT_POSITION_PRECEDING, FIRSTCHILD, HASSTRING, ID, NORMALIZED, OWNED, ownerNode_, READONLY, SPECIFIED, SYNCCHILDREN

Fields inherited from interface Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Constructor Summary

Constructors

Constructor	Description
HTMLDocumentImpl()

Method Summary

Modifier and Type	Method	Description
protected boolean	canRenameElements(String newNamespaceURI, String newNodeName, ElementImpl el)
Node	cloneNode(boolean deep)	Deep-clone a document, including fixing ownerDoc for the cloned children.
void	close()
Attr	createAttribute(String name)	Creates an Attribute having this Document as its OwnerDoc.
Element	createElement(String tagName)	Factory method; creates an Element having this Document as its OwnerDoc.
Element	createElementNS(String namespaceURI, String qualifiedname)	Introduced in DOM Level 2.
Element	createElementNS(String namespaceURI, String qualifiedName, String localpart)	Xerces-specific constructor.
org.w3c.dom.html.HTMLCollection	getAnchors()
org.w3c.dom.html.HTMLCollection	getApplets()
org.w3c.dom.html.HTMLElement	getBody()
String	getCookie()
Element	getDocumentElement()	Convenience method, allowing direct access to the child node which is considered the root of the actual document content.
String	getDomain()
Element	getElementById(String elementId)	Introduced in DOM Level 2 Returns the Element whose ID is given by elementId.
private Element	getElementById(String elementId, Node node)	Recursive method retreives an element by its id attribute.
NodeList	getElementsByName(String elementname)
final NodeList	getElementsByTagName(String tagName)	Return a live collection of all descendant Elements (not just immediate children) having the specified tag name.
final NodeList	getElementsByTagNameNS(String namespaceURI, String localName)	Introduced in DOM Level 2.
org.w3c.dom.html.HTMLCollection	getForms()
org.w3c.dom.html.HTMLElement	getHead()	Obtains the <HEAD> element in the document, creating one if does not exist before.
org.w3c.dom.html.HTMLCollection	getImages()
org.w3c.dom.html.HTMLCollection	getLinks()
String	getReferrer()
String	getTitle()
String	getURL()
void	open()
void	setBody(org.w3c.dom.html.HTMLElement newBody)
void	setCookie(String cookie)
void	setTitle(String newTitle)
void	write(String text)
void	writeln(String text)

Methods inherited from class DocumentImpl

createEvent, getImplementation

Methods inherited from class CoreDocumentImpl

addEventListener, adoptNode, changed, changes, checkDOMNSErr, checkNamespaceWF, checkQName, clearIdentifiers, clone, cloneNode, copyEventListeners, createAttributeNS, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createDocumentType, createEntity, createEntityReference, createProcessingInstruction, createTextNode, getBaseURI, getDoctype, getDocumentURI, getDomConfig, getErrorChecking, getIdentifier, getInputEncoding, getNodeName, getNodeNumber, getNodeNumber, getNodeType, getOwnerDocument, getStrictErrorChecking, getTextContent, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, insertBefore, isKidOK, isValidQName, isXMLName, normalizeDocument, putIdentifier, removeChild, removeEventListener, removeIdentifier, renameNode, replaceChild, setDocumentURI, setErrorChecking, setInputEncoding, setStrictErrorChecking, setTextContent, setXmlEncoding, setXmlStandalone, setXmlVersion, undeferChildren

Methods inherited from class ParentNode

getChildNodes, getChildNodesUnoptimized, getFirstChild, getLastChild, getLength, hasChildNodes, isEqualNode, item, setOwnerDocument, synchronizeChildren

Methods inherited from class ChildNode

getNextSibling, getParentNode, getPreviousSibling

Methods inherited from class NodeImpl

addEventListener, appendChild, compareDocumentPosition, dispatchEvent, getAttributes, getFeature, getLocalName, getNamespaceURI, getNodeValue, getPrefix, getUserData, hasAttributes, isDefaultNamespace, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, needsSyncChildren, normalize, removeEventListener, setNodeValue, setPrefix, setUserData, toString

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface Document

adoptNode, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createEntityReference, createProcessingInstruction, createTextNode, getDoctype, getDocumentURI, getDomConfig, getImplementation, getInputEncoding, getStrictErrorChecking, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, normalizeDocument, renameNode, setDocumentURI, setStrictErrorChecking, setXmlStandalone, setXmlVersion

Methods inherited from interface Node

appendChild, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Field Details

HTML5ELEMENTS

private static final String[] HTML5ELEMENTS

All valid HTML5 tags without deprecated elements https://www.tutorialrepublic.com/html-reference/html5-tags.php

anchors_

private HTMLCollectionImpl anchors_

Holds HTMLCollectionImpl object with live collection of all anchors in document. This reference is on demand only once.

forms_

private HTMLCollectionImpl forms_

Holds HTMLCollectionImpl object with live collection of all forms in document. This reference is on demand only once.

images_

private HTMLCollectionImpl images_

Holds HTMLCollectionImpl object with live collection of all images in document. This reference is on demand only once.

links_

private HTMLCollectionImpl links_

Holds HTMLCollectionImpl object with live collection of all links in document. This reference is on demand only once.

applets_

private HTMLCollectionImpl applets_

Holds HTMLCollectionImpl object with live collection of all applets in document. This reference is on demand only once.

writer_

private StringWriter writer_

Holds string writer used by direct manipulation operation (open(). write(String), etc) to write new contents into the document and parse that text into a document tree.

elementTypesHTMLLower_

private static final FastHashMap<String, HTMLDocumentImpl.ElementTypesHTMLHolder> elementTypesHTMLLower_

Holds names and classes of HTML element types. When an element with a particular tag name is created, the matching Class is used to create the element object. For example, <A> matches HTMLAnchorElementImpl. This static table is shared across all HTML documents.

See Also:

• createElement(String)

elementTypesHTMLUpper_

private static final FastHashMap<String, HTMLDocumentImpl.ElementTypesHTMLHolder> elementTypesHTMLUpper_

elemClassSigHTML_

private static final Class<?>[] elemClassSigHTML_

Signature used to locate constructor of HTML element classes. This static array is shared across all HTML documents.

See Also:

• createElement(String)

Constructor Details

HTMLDocumentImpl

public HTMLDocumentImpl()

Method Details

getDocumentElement

public Element getDocumentElement()

Description copied from class: CoreDocumentImpl

Convenience method, allowing direct access to the child node which is considered the root of the actual document content. For HTML, where it is legal to have more than one Element at the top level of the document, we pick the one with the tagName "HTML". For XML there should be only one top-level

(HTML not yet supported.)

Specified by:

getDocumentElement in interface Document

Overrides:

getDocumentElement in class CoreDocumentImpl

getHead

public org.w3c.dom.html.HTMLElement getHead()

Obtains the <HEAD> element in the document, creating one if does not exist before. The <HEAD> element is the first element in the <HTML> in the document. The <HTML> element is obtained by calling getDocumentElement(). If the element does not exist, one is created.

Called by getTitle(), setTitle(String), getBody() and setBody(HTMLElement) to assure the document has the <HEAD> element correctly placed.

Returns:

The <HEAD> element

getTitle

public String getTitle()

Specified by:

getTitle in interface org.w3c.dom.html.HTMLDocument

setTitle

public void setTitle(String newTitle)

Specified by:

setTitle in interface org.w3c.dom.html.HTMLDocument

getBody

public org.w3c.dom.html.HTMLElement getBody()

Specified by:

getBody in interface org.w3c.dom.html.HTMLDocument

setBody

public void setBody(org.w3c.dom.html.HTMLElement newBody)

Specified by:

setBody in interface org.w3c.dom.html.HTMLDocument

getElementById

public Element getElementById(String elementId)

Description copied from class: CoreDocumentImpl

Introduced in DOM Level 2 Returns the Element whose ID is given by elementId. If no such element exists, returns null. Behavior is not defined if more than one element has this ID.

Note: The DOM implementation must have information that says which attributes are of type ID. Attributes with the name "ID" are not of type ID unless so defined. Implementations that do not know whether attributes are of type ID or not are expected to return null.

Specified by:

getElementById in interface Document

Overrides:

getElementById in class CoreDocumentImpl

See Also:

• CoreDocumentImpl.getIdentifier(String)

getElementsByName

public NodeList getElementsByName(String elementname)

Specified by:

getElementsByName in interface org.w3c.dom.html.HTMLDocument

getElementsByTagName

public final NodeList getElementsByTagName(String tagName)

Description copied from class: CoreDocumentImpl

Return a live collection of all descendant Elements (not just immediate children) having the specified tag name.

Specified by:

getElementsByTagName in interface Document

Overrides:

getElementsByTagName in class CoreDocumentImpl

Parameters:

tagName - The type of Element we want to gather. "*" will be taken as a wildcard, meaning "all elements in the document."

See Also:

• DeepNodeListImpl

getElementsByTagNameNS

public final NodeList getElementsByTagNameNS(String namespaceURI,
 String localName)

Description copied from class: CoreDocumentImpl

Introduced in DOM Level 2.

Returns a NodeList of all the Elements with a given local name and namespace URI in the order in which they would be encountered in a preorder traversal of the Document tree.

Specified by:

getElementsByTagNameNS in interface Document

Overrides:

getElementsByTagNameNS in class CoreDocumentImpl

Parameters:

namespaceURI - The namespace URI of the elements to match on. The special value "*" matches all namespaces. When it is null or an empty string, this method behaves like getElementsByTagName.

localName - The local name of the elements to match on. The special value "*" matches all local names.

Returns:

NodeList A new NodeList object containing all the matched Elements.

createElementNS

public Element createElementNS(String namespaceURI,
 String qualifiedName,
 String localpart)
                        throws DOMException

Xerces-specific constructor. "localName" is passed in, so we don't need to create a new String for it.

Overrides:

createElementNS in class CoreDocumentImpl

Parameters:

namespaceURI - The namespace URI of the element to create.

qualifiedName - The qualified name of the element type to instantiate.

localpart - The local name of the element to instantiate.

Returns:

Element A new Element object with the following attributes:

Throws:

DOMException - INVALID_CHARACTER_ERR: Raised if the specified name contains an invalid character.

createElementNS

public Element createElementNS(String namespaceURI,
 String qualifiedname)

Description copied from class: CoreDocumentImpl

Introduced in DOM Level 2.

Creates an element of the given qualified name and namespace URI. If the given namespaceURI is null or an empty string and the qualifiedName has a prefix that is "xml", the created element is bound to the predefined namespace "http://www.w3.org/XML/1998/namespace" [Namespaces].

Specified by:

createElementNS in interface Document

Overrides:

createElementNS in class CoreDocumentImpl

Parameters:

namespaceURI - The namespace URI of the element to create.

qualifiedname - The qualified name of the element type to instantiate.

Returns:

Element A new Element object with the following attributes:

createElement

public Element createElement(String tagName)
                      throws DOMException

Description copied from class: CoreDocumentImpl

Factory method; creates an Element having this Document as its OwnerDoc.

Specified by:

createElement in interface Document

Overrides:

createElement in class CoreDocumentImpl

Parameters:

tagName - The name of the element type to instantiate. For XML, this is case-sensitive. For HTML, the tagName parameter may be provided in any case, but it must be mapped to the canonical uppercase form by the DOM implementation.

Throws:

DOMException - INVALID_NAME_ERR if the tag name is not acceptable.

createAttribute

public Attr createAttribute(String name)
                     throws DOMException

Creates an Attribute having this Document as its OwnerDoc. Overrides CoreDocumentImpl.createAttribute(String) and returns and attribute whose name is lower case.

Specified by:

createAttribute in interface Document

Overrides:

createAttribute in class CoreDocumentImpl

Parameters:

name - The name of the attribute

Returns:

An attribute whose name is all lower case

Throws:

DOMException - INVALID_NAME_ERR if the attribute name is not acceptable

getReferrer

public String getReferrer()

Specified by:

getReferrer in interface org.w3c.dom.html.HTMLDocument

getDomain

public String getDomain()

Specified by:

getDomain in interface org.w3c.dom.html.HTMLDocument

getURL

public String getURL()

Specified by:

getURL in interface org.w3c.dom.html.HTMLDocument

getCookie

public String getCookie()

Specified by:

getCookie in interface org.w3c.dom.html.HTMLDocument

setCookie

public void setCookie(String cookie)

Specified by:

setCookie in interface org.w3c.dom.html.HTMLDocument

getImages

public org.w3c.dom.html.HTMLCollection getImages()

Specified by:

getImages in interface org.w3c.dom.html.HTMLDocument

getApplets

public org.w3c.dom.html.HTMLCollection getApplets()

Specified by:

getApplets in interface org.w3c.dom.html.HTMLDocument

getLinks

public org.w3c.dom.html.HTMLCollection getLinks()

Specified by:

getLinks in interface org.w3c.dom.html.HTMLDocument

getForms

public org.w3c.dom.html.HTMLCollection getForms()

Specified by:

getForms in interface org.w3c.dom.html.HTMLDocument

getAnchors

public org.w3c.dom.html.HTMLCollection getAnchors()

Specified by:

getAnchors in interface org.w3c.dom.html.HTMLDocument

open

public void open()

Specified by:

open in interface org.w3c.dom.html.HTMLDocument

close

public void close()

Specified by:

close in interface org.w3c.dom.html.HTMLDocument

write

public void write(String text)

Specified by:

write in interface org.w3c.dom.html.HTMLDocument

writeln

public void writeln(String text)

Specified by:

writeln in interface org.w3c.dom.html.HTMLDocument

cloneNode

public Node cloneNode(boolean deep)

Description copied from class: DocumentImpl

Deep-clone a document, including fixing ownerDoc for the cloned children. Note that this requires bypassing the WRONG_DOCUMENT_ERR protection. I've chosen to implement it by calling importNode which is DOM Level 2. Deep-clone a document, including fixing ownerDoc for the cloned children. Note that this requires bypassing the WRONG_DOCUMENT_ERR protection. I've chosen to implement it by calling importNode which is DOM Level 2.

Specified by:

cloneNode in interface Node

Overrides:

cloneNode in class DocumentImpl

Parameters:

deep - boolean, iff true replicate children

Returns:

org.w3c.dom.Node

See Also:

• Example: Cloning a Text node will copy both the node and the text it contains.

  Example: Cloning something that has children -- Element or Attr, for example -- will _not_ clone those children unless a "deep clone" has been requested. A shallow clone of an Attr node will yield an empty Attr of the same name.

  NOTE: Clones will always be read/write, even if the node being cloned is read-only, to permit applications using only the DOM API to obtain editable copies of locked portions of the tree.

canRenameElements

protected boolean canRenameElements(String newNamespaceURI,
 String newNodeName,
 ElementImpl el)

Overrides:

canRenameElements in class CoreDocumentImpl

getElementById

private Element getElementById(String elementId,
 Node node)

Recursive method retreives an element by its id attribute. Called by getElementById(String).

Parameters:

elementId - The id value to look for

Returns:

The node in which to look for