Name
DOMImplementation.createDocumentType( ) — create a DocumentType node
Availability
DOM Level 2 Core
Synopsis
DocumentType createDocumentType(StringqualifiedName, StringpublicId, StringsystemId) throws DOMException;
Arguments
-
qualifiedName The name of the document type. If you are using XML namespaces, this may be a qualified name that specifies a namespace prefix and a local name separated by a colon.
-
publicId The public identifier of the document type, or
null.-
systemId The system identifier of the document type, or
null. This argument typically specifies the local filename of a DTD file.
Returns
A new DocumentType object with an
ownerDocument property of null.
Throws
This method may throw a DOMException with one of the following
code values:
-
INVALID_CHARACTER_ERR qualifiedNamecontains an illegal character.-
NAMESPACE_ERR qualifiedNameis malformed.-
NOT_SUPPORTED_ERR The current implementation does not support XML documents and has not implemented this method.
Description
This method creates a new DocumentType node. This method specifies only an external subset of the document type. As of Level 2, the DOM standard does not provide any way for specifying an internal subset, and the returned DocumentType does not define any Entity or Notation nodes. This method is useful only with XML documents and may not be supported by HTML-only implementations.