
Creates a DOM Document object of the specified type with its document
element.
Note that based on the
DocumentType given to create
the document, the implementation may instantiate specialized
Document objects that support additional features than
the "Core", such as "HTML" [
DOM Level 2 HTML]
. On the other hand, setting the
DocumentType after the
document was created makes this very unlikely to happen.
Alternatively, specialized
Document creation methods,
such as
createHTMLDocument [
DOM Level 2 HTML]
, can be used to obtain specific types of
Document objects.
Returns:
A new
Document object with its document element.
If the
NamespaceURI,
qualifiedName, and
doctype are
null, the returned
Document is empty with no document element.
Parameters:
-
namespaceURI - The namespace URI of the document element to
create or
null.
-
qualifiedName - The qualified name of the document element to be
created or
null.
-
doctype - The type of document to be created or
null.
When
doctype is not
null, its
Node.ownerDocument attribute is set to the document
being created.
Throws:
-
DOMException - INVALID_CHARACTER_ERR: Raised if the specified qualified name is not
an XML name according to [
XML 1.0].
NAMESPACE_ERR: Raised if the
qualifiedName is
malformed, if the
qualifiedName has a prefix and the
namespaceURI is
null, or if the
qualifiedName is
null and the
namespaceURI is different from
null, or
if the
qualifiedName has a prefix that is "xml" and
the
namespaceURI is different from "
http://www.w3.org/XML/1998/namespace" [
XML Namespaces]
, or if the DOM implementation does not support the
"XML" feature but a non-null namespace URI was
provided, since namespaces were defined by XML.
WRONG_DOCUMENT_ERR: Raised if
doctype has already
been used with a different document or was created from a different
implementation.
NOT_SUPPORTED_ERR: May be raised if the implementation does not
support the feature "XML" and the language exposed through the
Document does not support XML Namespaces (such as [
HTML 4.01]).
Since:
DOM Level 2