Javascript [Electronic resources] : The Definitive Guide (4th Edition) نسخه متنی

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( )