Availability

DOM Level 2 Core

Synopsis

Document createDocument(String namespaceURI, 
                        String qualifiedName, 
                        DocumentType doctype) 
    throws DOMException;

Arguments

namespaceURI

The unique identifier of the namespace of the root element to be created for the document, or null for no namespace.

qualifiedName

The name of the root element to be created for this document. If namespaceURI is not null, this name should include a namespace prefix and a colon.

doctype

The DocumentType object for the newly created Document, or null if 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

qualifiedName contains an illegal character.

NAMESPACE_ERR

qualifiedName is malformed, or there is a mismatch between qualifiedName and namespaceURI.

NOT_SUPPORTED_ERR

The current implementation does not support XML documents and has not implemented this method.

WRONG_DOCUMENT_ERR

doctype is 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 document.

This method is used to create XML documents and may not be supported by HTML-only implementations. Use createHTMLDocument( ) to create a new HTML document.

See Also

DOMImplementation.createDocumentType( ), DOMImplementation.createHTMLDocument( )