Name
DOMImplementation.createDocument( ) — create a new Document and the specified root element
Availability
DOM Level 2 Core
Synopsis
Document createDocument(StringnamespaceURI, StringqualifiedName, DocumentTypedoctype) throws DOMException;
Arguments
-
namespaceURI The unique identifier of the namespace of the root element to be created for the document, or
nullfor no namespace.-
qualifiedName The name of the root element to be created for this document. If
namespaceURIis notnull, this name should include a namespace prefix and a colon.-
doctype The DocumentType object for the newly created Document, or
nullif none is desired.
Returns
A Document object with its documentElement
property set to a root Element node of the specified type.
Throws
This method may throw a DOMException with the following
code values in the following circumstances:
-
INVALID_CHARACTER_ERR qualifiedNamecontains an illegal character.-
NAMESPACE_ERR qualifiedNameis malformed, or there is a mismatch betweenqualifiedNameandnamespaceURI.-
NOT_SUPPORTED_ERR The current implementation does not support XML documents and has not implemented this method.
-
WRONG_DOCUMENT_ERR doctypeis already in use for another document or was created by a different DOMImplementation object.
Description
This method creates a new Document object and the specified root
documentElement object for that document. If the
doctype argument is
non-null, the ownerDocument property of this DocumentType object is set to the newly created ...