Appendix F: ECMAScript
Language Binding
This appendix contains the complete ECMAScript [ECMAScript] binding for the
Level 3 Document Object Model Core definitions.
F.1:
ECMAScript Binding Extension
This section defines the DOMImplementationRegistry
object, discussed in Bootstrapping, for ECMAScript.
- Objects that implements the DOMImplementationRegistry
interface
-
- DOMImplementationRegistry is a global variable which has the
following functions:
-
- getDOMImplementation(features)
- This method returns the first registered object that implements
the DOMImplementation interface and has the desired
features, or null if none is found.
The features parameter is a String.
- sources
- This property is an Array. It contains all registered
objects that implement the DOMImplementationSource
interface.
F.2: Other Core
interfaces
- Properties of the DOMException Constructor
function:
-
- DOMException.INDEX_SIZE_ERR
- The value of the constant DOMException.INDEX_SIZE_ERR is
1.
- DOMException.DOMSTRING_SIZE_ERR
- The value of the constant
DOMException.DOMSTRING_SIZE_ERR is 2.
- DOMException.HIERARCHY_REQUEST_ERR
- The value of the constant
DOMException.HIERARCHY_REQUEST_ERR is 3.
- DOMException.WRONG_DOCUMENT_ERR
- The value of the constant
DOMException.WRONG_DOCUMENT_ERR is 4.
- DOMException.INVALID_CHARACTER_ERR
- The value of the constant
DOMException.INVALID_CHARACTER_ERR is 5.
- DOMException.NO_DATA_ALLOWED_ERR
- The value of the constant
DOMException.NO_DATA_ALLOWED_ERR is 6.
- DOMException.NO_MODIFICATION_ALLOWED_ERR
- The value of the constant
DOMException.NO_MODIFICATION_ALLOWED_ERR is 7.
- DOMException.NOT_FOUND_ERR
- The value of the constant DOMException.NOT_FOUND_ERR is
8.
- DOMException.NOT_SUPPORTED_ERR
- The value of the constant DOMException.NOT_SUPPORTED_ERR
is 9.
- DOMException.INUSE_ATTRIBUTE_ERR
- The value of the constant
DOMException.INUSE_ATTRIBUTE_ERR is 10.
- DOMException.INVALID_STATE_ERR
- The value of the constant DOMException.INVALID_STATE_ERR
is 11.
- DOMException.SYNTAX_ERR
- The value of the constant DOMException.SYNTAX_ERR is
12.
- DOMException.INVALID_MODIFICATION_ERR
- The value of the constant
DOMException.INVALID_MODIFICATION_ERR is 13.
- DOMException.NAMESPACE_ERR
- The value of the constant DOMException.NAMESPACE_ERR is
14.
- DOMException.INVALID_ACCESS_ERR
- The value of the constant
DOMException.INVALID_ACCESS_ERR is 15.
- DOMException.VALIDATION_ERR
- The value of the constant DOMException.VALIDATION_ERR is
16.
- Objects that implement the DOMException interface:
-
- Properties of objects that implement the DOMException
interface:
-
- code
- This property is a Number.
- Objects that implement the DOMImplementationSource
interface:
-
- Functions of objects that implement the
DOMImplementationSource interface:
-
- getDOMImplementation(features)
- This function returns an object that implements the
DOMImplementation interface.
The features parameter is a String.
- Objects that implement the DOMImplementation
interface:
-
- Functions of objects that implement the
DOMImplementation interface:
-
- hasFeature(feature, version)
- This function returns a Boolean.
The feature parameter is a String.
The version parameter is a String.
- createDocumentType(qualifiedName, publicId,
systemId)
- This function returns an object that implements the
DocumentType interface.
The qualifiedName parameter is a String.
The publicId parameter is a String.
The systemId parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createDocument(namespaceURI, qualifiedName,
doctype)
- This function returns an object that implements the
Document interface.
The namespaceURI parameter is a String.
The qualifiedName parameter is a String.
The doctype parameter is an object that implements the
DocumentType interface.
This function can raise an object that implements the
DOMException interface.
- getInterface(feature)
- This function returns an object that implements the
DOMImplementation interface.
The feature parameter is a String.
- Objects that implement the DocumentFragment
interface:
-
- Objects that implement the DocumentFragment interface
have all properties and functions of the Node
interface.
- Objects that implement the Document interface:
-
- Objects that implement the Document interface have all
properties and functions of the Node interface as well as
the properties and functions defined below.
- Properties of objects that implement the Document
interface:
-
- doctype
- This read-only property is an object that implements the
DocumentType interface.
- implementation
- This read-only property is an object that implements the
DOMImplementation interface.
- documentElement
- This read-only property is an object that implements the
Element interface.
- actualEncoding
- This property is a String.
- encoding
- This property is a String.
- standalone
- This property is a Boolean.
- version
- This property is a String and can raise an objewct that
implements DOMException interface on setting.
- strictErrorChecking
- This property is a Boolean.
- errorHandler
- This property is an object that implements the
DOMErrorHandler interface.
- documentURI
- This property is a String.
- Functions of objects that implement the Document
interface:
-
- createElement(tagName)
- This function returns an object that implements the
Element interface.
The tagName parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createDocumentFragment()
- This function returns an object that implements the
DocumentFragment interface.
- createTextNode(data)
- This function returns an object that implements the Text
interface.
The data parameter is a String.
- createComment(data)
- This function returns an object that implements the
Comment interface.
The data parameter is a String.
- createCDATASection(data)
- This function returns an object that implements the
CDATASection interface.
The data parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createProcessingInstruction(target, data)
- This function returns an object that implements the
ProcessingInstruction interface.
The target parameter is a String.
The data parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createAttribute(name)
- This function returns an object that implements the Attr
interface.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createEntityReference(name)
- This function returns an object that implements the
EntityReference interface.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- getElementsByTagName(tagname)
- This function returns an object that implements the
NodeList interface.
The tagname parameter is a String.
- importNode(importedNode, deep)
- This function returns an object that implements the Node
interface.
The importedNode parameter is an object that implements the
Node interface.
The deep parameter is a Boolean.
This function can raise an object that implements the
DOMException interface.
- createElementNS(namespaceURI, qualifiedName)
- This function returns an object that implements the
Element interface.
The namespaceURI parameter is a String.
The qualifiedName parameter is a String.
This function can raise an object that implements the
DOMException interface.
- createAttributeNS(namespaceURI, qualifiedName)
- This function returns an object that implements the Attr
interface.
The namespaceURI parameter is a String.
The qualifiedName parameter is a String.
This function can raise an object that implements the
DOMException interface.
- getElementsByTagNameNS(namespaceURI, localName)
- This function returns an object that implements the
NodeList interface.
The namespaceURI parameter is a String.
The localName parameter is a String.
- getElementById(elementId)
- This function returns an object that implements the
Element interface.
The elementId parameter is a String.
- adoptNode(source)
- This function returns an object that implements the Node
interface.
The source parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- normalizeDocument()
- This function has no return value.
- canSetNormalizationFeature(name, state)
- This function returns a Boolean.
The name parameter is a String.
The state parameter is a Boolean.
- setNormalizationFeature(name, state)
- This function has no return value.
The name parameter is a String.
The state parameter is a Boolean.
This function can raise an object that implements the
DOMException interface.
- getNormalizationFeature(name)
- This function returns a Boolean.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- renameNode(n, namespaceURI, name)
- This function returns an object that implements the Node
interface.
The n parameter is an object that implements the Node
interface.
The namespaceURI parameter is a String.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- Properties of the Node Constructor function:
-
- Node.ELEMENT_NODE
- The value of the constant Node.ELEMENT_NODE is
1.
- Node.ATTRIBUTE_NODE
- The value of the constant Node.ATTRIBUTE_NODE is
2.
- Node.TEXT_NODE
- The value of the constant Node.TEXT_NODE is
3.
- Node.CDATA_SECTION_NODE
- The value of the constant Node.CDATA_SECTION_NODE is
4.
- Node.ENTITY_REFERENCE_NODE
- The value of the constant Node.ENTITY_REFERENCE_NODE is
5.
- Node.ENTITY_NODE
- The value of the constant Node.ENTITY_NODE is
6.
- Node.PROCESSING_INSTRUCTION_NODE
- The value of the constant
Node.PROCESSING_INSTRUCTION_NODE is 7.
- Node.COMMENT_NODE
- The value of the constant Node.COMMENT_NODE is
8.
- Node.DOCUMENT_NODE
- The value of the constant Node.DOCUMENT_NODE is
9.
- Node.DOCUMENT_TYPE_NODE
- The value of the constant Node.DOCUMENT_TYPE_NODE is
10.
- Node.DOCUMENT_FRAGMENT_NODE
- The value of the constant Node.DOCUMENT_FRAGMENT_NODE is
11.
- Node.NOTATION_NODE
- The value of the constant Node.NOTATION_NODE is
12.
- Node.TREE_POSITION_PRECEDING
- The value of the constant Node.TREE_POSITION_PRECEDING
is 0x01.
- Node.TREE_POSITION_FOLLOWING
- The value of the constant Node.TREE_POSITION_FOLLOWING
is 0x02.
- Node.TREE_POSITION_ANCESTOR
- The value of the constant Node.TREE_POSITION_ANCESTOR is
0x04.
- Node.TREE_POSITION_DESCENDANT
- The value of the constant Node.TREE_POSITION_DESCENDANT
is 0x08.
- Node.TREE_POSITION_EQUIVALENT
- The value of the constant Node.TREE_POSITION_EQUIVALENT
is 0x10.
- Node.TREE_POSITION_SAME_NODE
- The value of the constant Node.TREE_POSITION_SAME_NODE
is 0x20.
- Node.TREE_POSITION_DISCONNECTED
- The value of the constant
Node.TREE_POSITION_DISCONNECTED is 0x00.
- Objects that implement the Node interface:
-
- Properties of objects that implement the Node
interface:
-
- nodeName
- This read-only property is a String.
- nodeValue
- This property is a String, can raise an object that
implements DOMException interface on setting and can raise
an object that implements the DOMException interface on
retrieval.
- nodeType
- This read-only property is a Number.
- parentNode
- This read-only property is an object that implements the
Node interface.
- childNodes
- This read-only property is an object that implements the
NodeList interface.
- firstChild
- This read-only property is an object that implements the
Node interface.
- lastChild
- This read-only property is an object that implements the
Node interface.
- previousSibling
- This read-only property is an object that implements the
Node interface.
- nextSibling
- This read-only property is an object that implements the
Node interface.
- attributes
- This read-only property is an object that implements the
NamedNodeMap interface.
- ownerDocument
- This read-only property is an object that implements the
Document interface.
- namespaceURI
- This read-only property is a String.
- prefix
- This property is a String and can raise an objewct that
implements DOMException interface on setting.
- localName
- This read-only property is a String.
- baseURI
- This read-only property is a String.
- textContent
- This property is a String, can raise an object that
implements DOMException interface on setting and can raise
an object that implements the DOMException interface on
retrieval.
- Functions of objects that implement the Node
interface:
-
- insertBefore(newChild, refChild)
- This function returns an object that implements the Node
interface.
The newChild parameter is an object that implements the
Node interface.
The refChild parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- replaceChild(newChild, oldChild)
- This function returns an object that implements the Node
interface.
The newChild parameter is an object that implements the
Node interface.
The oldChild parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- removeChild(oldChild)
- This function returns an object that implements the Node
interface.
The oldChild parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- appendChild(newChild)
- This function returns an object that implements the Node
interface.
The newChild parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- hasChildNodes()
- This function returns a Boolean.
- cloneNode(deep)
- This function returns an object that implements the Node
interface.
The deep parameter is a Boolean.
- normalize()
- This function has no return value.
- isSupported(feature, version)
- This function returns a Boolean.
The feature parameter is a String.
The version parameter is a String.
- hasAttributes()
- This function returns a Boolean.
- compareTreePosition(other)
- This function returns a Number.
The other parameter is an object that implements the
Node interface.
- isSameNode(other)
- This function returns a Boolean.
The other parameter is an object that implements the
Node interface.
- lookupNamespacePrefix(namespaceURI)
- This function returns a String.
The namespaceURI parameter is a String.
- lookupNamespaceURI(prefix)
- This function returns a String.
The prefix parameter is a String.
- isEqualNode(arg, deep)
- This function returns a Boolean.
The arg parameter is an object that implements the
Node interface.
The deep parameter is a Boolean.
- getInterface(feature)
- This function returns an object that implements the Node
interface.
The feature parameter is a String.
- setUserData(key, data, handler)
- This function returns an object that implements the any
type interface.
The key parameter is a String.
The data parameter is an object that implements the any
type interface.
The handler parameter is an object that implements the
UserDataHandler interface.
- getUserData(key)
- This function returns an object that implements the any
type interface.
The key parameter is a String.
- Objects that implement the NodeList interface:
-
- Properties of objects that implement the NodeList
interface:
-
- length
- This read-only property is a Number.
- Functions of objects that implement the NodeList
interface:
-
- item(index)
- This function returns an object that implements the Node
interface.
The index parameter is a Number.
Note: This object can also be dereferenced using square
bracket notation (e.g. obj[1]). Dereferencing with an integer
index is equivalent to invoking the item function
with that index.
- Objects that implement the NamedNodeMap interface:
-
- Properties of objects that implement the NamedNodeMap
interface:
-
- length
- This read-only property is a Number.
- Functions of objects that implement the NamedNodeMap
interface:
-
- getNamedItem(name)
- This function returns an object that implements the Node
interface.
The name parameter is a String.
- setNamedItem(arg)
- This function returns an object that implements the Node
interface.
The arg parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- removeNamedItem(name)
- This function returns an object that implements the Node
interface.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- item(index)
- This function returns an object that implements the Node
interface.
The index parameter is a Number.
Note: This object can also be dereferenced using square
bracket notation (e.g. obj[1]). Dereferencing with an integer
index is equivalent to invoking the item function
with that index.
- getNamedItemNS(namespaceURI, localName)
- This function returns an object that implements the Node
interface.
The namespaceURI parameter is a String.
The localName parameter is a String.
- setNamedItemNS(arg)
- This function returns an object that implements the Node
interface.
The arg parameter is an object that implements the
Node interface.
This function can raise an object that implements the
DOMException interface.
- removeNamedItemNS(namespaceURI, localName)
- This function returns an object that implements the Node
interface.
The namespaceURI parameter is a String.
The localName parameter is a String.
This function can raise an object that implements the
DOMException interface.
- Objects that implement the CharacterData interface:
-
- Objects that implement the CharacterData interface have
all properties and functions of the Node interface as well
as the properties and functions defined below.
- Properties of objects that implement the CharacterData
interface:
-
- data
- This property is a String, can raise an object that
implements DOMException interface on setting and can raise
an object that implements the DOMException interface on
retrieval.
- length
- This read-only property is a Number.
- Functions of objects that implement the CharacterData
interface:
-
- substringData(offset, count)
- This function returns a String.
The offset parameter is a Number.
The count parameter is a Number.
This function can raise an object that implements the
DOMException interface.
- appendData(arg)
- This function has no return value.
The arg parameter is a String.
This function can raise an object that implements the
DOMException interface.
- insertData(offset, arg)
- This function has no return value.
The offset parameter is a Number.
The arg parameter is a String.
This function can raise an object that implements the
DOMException interface.
- deleteData(offset, count)
- This function has no return value.
The offset parameter is a Number.
The count parameter is a Number.
This function can raise an object that implements the
DOMException interface.
- replaceData(offset, count, arg)
- This function has no return value.
The offset parameter is a Number.
The count parameter is a Number.
The arg parameter is a String.
This function can raise an object that implements the
DOMException interface.
- Objects that implement the Attr interface:
-
- Objects that implement the Attr interface have all
properties and functions of the Node interface as well as
the properties and functions defined below.
- Properties of objects that implement the Attr
interface:
-
- name
- This read-only property is a String.
- specified
- This read-only property is a Boolean.
- value
- This property is a String and can raise an objewct that
implements DOMException interface on setting.
- ownerElement
- This read-only property is an object that implements the
Element interface.
- Objects that implement the Element interface:
-
- Objects that implement the Element interface have all
properties and functions of the Node interface as well as
the properties and functions defined below.
- Properties of objects that implement the Element
interface:
-
- tagName
- This read-only property is a String.
- Functions of objects that implement the Element
interface:
-
- getAttribute(name)
- This function returns a String.
The name parameter is a String.
- setAttribute(name, value)
- This function has no return value.
The name parameter is a String.
The value parameter is a String.
This function can raise an object that implements the
DOMException interface.
- removeAttribute(name)
- This function has no return value.
The name parameter is a String.
This function can raise an object that implements the
DOMException interface.
- getAttributeNode(name)
- This function returns an object that implements the Attr
interface.
The name parameter is a String.
- setAttributeNode(newAttr)
- This function returns an object that implements the Attr
interface.
The newAttr parameter is an object that implements the
Attr interface.
This function can raise an object that implements the
DOMException interface.
- removeAttributeNode(oldAttr)
- This function returns an object that implements the Attr
interface.
The oldAttr parameter is an object that implements the
Attr interface.
This function can raise an object that implements the
DOMException interface.
- getElementsByTagName(name)
- This function returns an object that implements the
NodeList interface.
The name parameter is a String.
- getAttributeNS(namespaceURI, localName)
- This function returns a String.
The namespaceURI parameter is a String.
The localName parameter is a String.
- setAttributeNS(namespaceURI, qualifiedName, value)
- This function has no return value.
The namespaceURI parameter is a String.
The qualifiedName parameter is a String.
The value parameter is a String.
This function can raise an object that implements the
DOMException interface.
- removeAttributeNS(namespaceURI, localName)
- This function has no return value.
The namespaceURI parameter is a String.
The localName parameter is a String.
This function can raise an object that implements the
DOMException interface.
- getAttributeNodeNS(namespaceURI, localName)
- This function returns an object that implements the Attr
interface.
The namespaceURI parameter is a String.
The localName parameter is a String.
- setAttributeNodeNS(newAttr)
- This function returns an object that implements the Attr
interface.
The newAttr parameter is an object that implements the
Attr interface.
This function can raise an object that implements the
DOMException interface.
- getElementsByTagNameNS(namespaceURI, localName)
- This function returns an object that implements the
NodeList interface.
The namespaceURI parameter is a String.
The localName parameter is a String.
- hasAttribute(name)
- This function returns a Boolean.
The name parameter is a String.
- hasAttributeNS(namespaceURI, localName)
- This function returns a Boolean.
The namespaceURI parameter is a String.
The localName parameter is a String.
- Objects that implement the Text interface:
-
- Objects that implement the Text interface have all
properties and functions of the CharacterData interface as
well as the properties and functions defined below.
- Properties of objects that implement the Text
interface:
-
- isWhitespaceInElementContent
- This read-only property is a Boolean.
- wholeText
- This read-only property is a String.
- Functions of objects that implement the Text
interface:
-
- splitText(offset)
- This function returns an object that implements the Text
interface.
The offset parameter is a Number.
This function can raise an object that implements the
DOMException interface.
- replaceWholeText(content)
- This function returns an object that implements the Text
interface.
The content parameter is a String.
This function can raise an object that implements the
DOMException interface.
- Objects that implement the Comment interface:
-
- Objects that implement the Comment interface have all
properties and functions of the CharacterData
interface.
- Properties of the UserDataHandler Constructor
function:
-
- UserDataHandler.NODE_CLONED
- The value of the constant UserDataHandler.NODE_CLONED is
1.
- UserDataHandler.NODE_IMPORTED
- The value of the constant UserDataHandler.NODE_IMPORTED
is 2.
- UserDataHandler.NODE_DELETED
- The value of the constant UserDataHandler.NODE_DELETED
is 3.
- UserDataHandler.NODE_RENAMED
- The value of the constant UserDataHandler.NODE_RENAMED
is 4.
- Objects that implement the UserDataHandler
interface:
-
- Functions of objects that implement the UserDataHandler
interface:
-
- handle(operation, key, data, src, dst)
- This function has no return value.
The operation parameter is a Number.
The key parameter is a String.
The data parameter is an object that implements the
Object interface.
The src parameter is an object that implements the
Node interface.
The dst parameter is an object that implements the
Node interface.
- Properties of the DOMError Constructor function:
-
- DOMError.SEVERITY_WARNING
- The value of the constant DOMError.SEVERITY_WARNING is
0.
- DOMError.SEVERITY_ERROR
- The value of the constant DOMError.SEVERITY_ERROR is
1.
- DOMError.SEVERITY_FATAL_ERROR
- The value of the constant DOMError.SEVERITY_FATAL_ERROR
is 2.
- Objects that implement the DOMError interface:
-
- Properties of objects that implement the DOMError
interface:
-
- severity
- This read-only property is a Number.
- message
- This read-only property is a String.
- relatedException
- This read-only property is an object that implements the
Object interface.
- location
- This read-only property is an object that implements the
DOMLocator interface.
- Objects that implement the DOMErrorHandler
interface:
-
- Functions of objects that implement the DOMErrorHandler
interface:
-
- handleError(error)
- This function returns a Boolean.
The error parameter is an object that implements the
DOMError interface.
- Objects that implement the DOMLocator interface:
-
- Properties of objects that implement the DOMLocator
interface:
-
- lineNumber
- This read-only property is a Number.
- columnNumber
- This read-only property is a Number.
- offset
- This read-only property is a Number.
- errorNode
- This read-only property is an object that implements the
Node interface.
- uri
- This read-only property is a String.
- Objects that implement the CDATASection interface:
-
- Objects that implement the CDATASection interface have
all properties and functions of the Text interface.
- Objects that implement the DocumentType interface:
-
- Objects that implement the DocumentType interface have
all properties and functions of the Node interface as well
as the properties and functions defined below.
- Properties of objects that implement the DocumentType
interface:
-
- name
- This read-only property is a String.
- entities
- This read-only property is an object that implements the
NamedNodeMap interface.
- notations
- This read-only property is an object that implements the
NamedNodeMap interface.
- publicId
- This read-only property is a String.
- systemId
- This read-only property is a String.
- internalSubset
- This read-only property is a String.
- Objects that implement the Notation interface:
-
- Objects that implement the Notation interface have all
properties and functions of the Node interface as well as
the properties and functions defined below.
- Properties of objects that implement the Notation
interface:
-
- publicId
- This read-only property is a String.
- systemId
- This read-only property is a String.
- Objects that implement the Entity interface:
-
- Objects that implement the Entity interface have all
properties and functions of the Node interface as well as
the properties and functions defined below.
- Properties of objects that implement the Entity
interface:
-
- publicId
- This read-only property is a String.
- systemId
- This read-only property is a String.
- notationName
- This read-only property is a String.
- actualEncoding
- This property is a String.
- encoding
- This property is a String.
- version
- This property is a String.
- Objects that implement the EntityReference
interface:
-
- Objects that implement the EntityReference interface
have all properties and functions of the Node
interface.
- Objects that implement the ProcessingInstruction
interface:
-
- Objects that implement the ProcessingInstruction
interface have all properties and functions of the Node
interface as well as the properties and functions defined
below.
- Properties of objects that implement the
ProcessingInstruction interface:
-
- target
- This read-only property is a String.
- data
- This property is a String and can raise an objewct that
implements DOMException interface on setting.