Lisez-moi S.V.P. 

13 novembre 2000

Annexe E : La liaison avec le langage ECMAScript

Cette annexe contient la liaison complète du langage ECMAScript [ECMAScript] pour les définitions du modèle objet de document niveau 2 Core.

Remarque : Les exceptions ne sont gérées que par les mises en œuvre ECMAScript conformes au standard ECMA-262, 3e édition ([ECMAScript]).

L'objet prototype DOMException
La classe DOMException a les constantes suivantes :
DOMException.INDEX_SIZE_ERR
Cette constante est du type Number et sa valeur est 1.
DOMException.DOMSTRING_SIZE_ERR
Cette constante est du type Number et sa valeur est 2.
DOMException.HIERARCHY_REQUEST_ERR
Cette constante est du type Number et sa valeur est 3.
DOMException.WRONG_DOCUMENT_ERR
Cette constante est du type Number et sa valeur est 4.
DOMException.INVALID_CHARACTER_ERR
Cette constante est du type Number et sa valeur est 5.
DOMException.NO_DATA_ALLOWED_ERR
Cette constante est du type Number et sa valeur est 6.
DOMException.NO_MODIFICATION_ALLOWED_ERR
Cette constante est du type Number et sa valeur est 7.
DOMException.NOT_FOUND_ERR
Cette constante est du type Number et sa valeur est 8.
DOMException.NOT_SUPPORTED_ERR
Cette constante est du type Number et sa valeur est 9.
DOMException.INUSE_ATTRIBUTE_ERR
Cette constante est du type Number et sa valeur est 10.
DOMException.INVALID_STATE_ERR
Cette constante est du type Number et sa valeur est 11.
DOMException.SYNTAX_ERR
Cette constante est du type Number et sa valeur est 12.
DOMException.INVALID_MODIFICATION_ERR
Cette constante est du type Number et sa valeur est 13.
DOMException.NAMESPACE_ERR
Cette constante est du type Number et sa valeur est 14.
DOMException.INVALID_ACCESS_ERR
Cette constante est du type Number et sa valeur est 15.
Objet DOMException
L'objet DOMException a les propriétés suivantes :
code
Cette propriété est du type Number.
Objet DOMImplementation
L'objet DOMImplementation a les nœuds suivants :
hasFeature(feature, version)
Cette méthode retourne un type Boolean.
Le paramètre feature est du type String.
Le paramètre version est du type String.
createDocumentType(qualifiedName, publicId, systemId)
Cette méthode retourne un objet DocumentType.
Le paramètre qualifiedName est du type String.
Le paramètre publicId est du type String.
Le paramètre systemId est du type String.
Cette méthode peut soulever une exception DOMException.
createDocument(namespaceURI, qualifiedName, doctype)
Cette méthode retourne un objet Document.
Le paramètre namespaceURI est du type String.
Le paramètre qualifiedName est du type String.
Le paramètre doctype est un objet DocumentType.
Cette méthode peut soulever une exception DOMException.
Objet DocumentFragment
L'objet DocumentFragment a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
Objet Document
L'objet Document a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet Document a les propriétés suivantes :
doctype
Cette propriété en lecture seule est un objet DocumentType.
implementation
Cette propriété en lecture seule est un objet DOMImplementation.
documentElement
Cette propriété en lecture seule est un objet Element.
L'objet Document a les méthodes suivantes :
createElement(tagName)
Cette méthode retourne un objet Element.
Le paramètre tagName est du type String.
Cette méthode peut soulever une exception DOMException.
createDocumentFragment()
Cette méthode retourne un objet DocumentFragment.
createTextNode(data)
Cette méthode retourne un objet Text.
Le paramètre data est du type String.
createComment(data)
Cette méthode retourne un objet Comment.
Le paramètre data est du type String.
createCDATASection(data)
Cette méthode retourne un objet CDATASection.
Le paramètre data est du type String.
Cette méthode peut soulever une exception DOMException.
createProcessingInstruction(target, data)
Cette méthode retourne un objet ProcessingInstruction.
Le paramètre target est du type String.
Le paramètre data est du type String.
Cette méthode peut soulever une exception DOMException.
createAttribute(name)
Cette méthode retourne un objet Attr.
Le paramètre name est du type String.
Cette méthode peut soulever une exception DOMException.
createEntityReference(name)
Cette méthode retourne un objet EntityReference.
Le paramètre name est du type String.
Cette méthode peut soulever une exception DOMException.
getElementsByTagName(tagname)
Cette méthode retourne un objet NodeList.
Le paramètre tagname est du type String.
importNode(importedNode, deep)
Cette méthode retourne un objet Node.
Le paramètre importedNode est un objet Node.
Le paramètre deep est du type Boolean.
Cette méthode peut soulever une exception DOMException.
createElementNS(namespaceURI, qualifiedName)
Cette méthode retourne un objet Element.
Le paramètre namespaceURI est du type String.
Le paramètre qualifiedName est du type String.
Cette méthode peut soulever une exception DOMException.
createAttributeNS(namespaceURI, qualifiedName)
Cette méthode retourne un objet Attr.
Le paramètre namespaceURI est du type String.
Le paramètre qualifiedName est du type String.
Cette méthode peut soulever une exception DOMException.
getElementsByTagNameNS(namespaceURI, localName)
Cette méthode retourne un objet NodeList.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
getElementById(elementId)
Cette méthode retourne un objet Element.
Le paramètre elementId est du type String.
Objet prototype Node
La classe Node a les constantes suivantes :
Node.ELEMENT_NODE
Cette constante est du type Number et sa valeur est 1.
Node.ATTRIBUTE_NODE
Cette constante est du type Number et sa valeur est 2.
Node.TEXT_NODE
Cette constante est du type Number et sa valeur est 3.
Node.CDATA_SECTION_NODE
Cette constante est du type Number et sa valeur est 4.
Node.ENTITY_REFERENCE_NODE
Cette constante est du type Number et sa valeur est 5.
Node.ENTITY_NODE
Cette constante est du type Number et sa valeur est 6.
Node.PROCESSING_INSTRUCTION_NODE
Cette constante est du type Number et sa valeur est 7.
Node.COMMENT_NODE
Cette constante est du type Number et sa valeur est 8.
Node.DOCUMENT_NODE
Cette constante est du type Number et sa valeur est 9.
Node.DOCUMENT_TYPE_NODE
Cette constante est du type Number et sa valeur est 10.
Node.DOCUMENT_FRAGMENT_NODE
Cette constante est du type Number et sa valeur est 11.
Node.NOTATION_NODE
Cette constante est du type Number et sa valeur est 12.
Objet Node
L'objet Node a les propriétés suivantes :
nodeName
Cette propriété en lecture seule est du type String.
nodeValue
Cette propriété est du type String et peut soulever une exception DOMException à l'initialisation comme en retour.
nodeType
Cette propriété en lecture seule est du type Number.
parentNode
Cette propriété en lecture seule est un objet Node.
childNodes
Cette propriété en lecture seule est un objet NodeList.
firstChild
Cette propriété en lecture seule est un objet Node.
lastChild
Cette propriété en lecture seule est un objet Node.
previousSibling
Cette propriété en lecture seule est un objet Node.
nextSibling
Cette propriété en lecture seule est un objet Node.
attributes
Cette propriété en lecture seule est un objet NamedNodeMap.
ownerDocument
Cette propriété en lecture seule est un objet Document.
namespaceURI
Cette propriété en lecture seule est du type String.
prefix
Cette propriété est du type String et peut soulever une exception DOMException à l'initialisation.
localName
Cette propriété en lecture seule est du type String.
L'objet Node a les méthodes suivantes :
insertBefore(newChild, refChild)
Cette méthode retourne un objet Node.
Le paramètre newChild est un objet Node.
Le paramètre refChild est un objet Node.
Cette méthode peut soulever une exception DOMException.
replaceChild(newChild, oldChild)
Cette méthode retourne un objet Node.
Le paramètre newChild est un objet Node.
Le paramètre oldChild est un objet Node.
Cette méthode peut soulever une exception DOMException.
removeChild(oldChild)
Cette méthode retourne un objet Node.
Le paramètre oldChild est un objet Node.
Cette méthode peut soulever une exception DOMException.
appendChild(newChild)
Cette méthode retourne un objet Node.
Le paramètre newChild est un objet Node.
Cette méthode peut soulever une exception DOMException.
hasChildNodes()
Cette méthode retourne un type Boolean.
cloneNode(deep)
Cette méthode retourne un objet Node.
Le paramètre deep est du type Boolean.
normalize()
Cette méthode ne retourne aucune valeur.
isSupported(feature, version)
Cette méthode retourne un type Boolean.
Le paramètre feature est du type String.
Le paramètre version est du type String.
hasAttributes()
Cette méthode retourne un type Boolean.
Objet NodeList
L'objet NodeList a les propriétés suivantes :
length
Cette propriété en lecture seule est du type Number.
L'objet NodeList a les méthodes suivantes :
item(index)
Cette méthode retourne un objet Node.
Le paramètre index est du type Number.
Remarque : On peut aussi déréférencer cet objet en utilisant une notation entre crochets (par exemple, obj[1]). Le déréférencement avec un index entier équivaut à l'utilisation de la méthode item avec cet index.
Objet NamedNodeMap
L'objet NamedNodeMap a les propriétés suivantes :
length
Cette propriété en lecture seule est du type Number.
L'objet NamedNodeMap a les méthodes suivantes :
getNamedItem(name)
Cette méthode retourne un objet Node.
Le paramètre name est du type String.
setNamedItem(arg)
Cette méthode retourne un objet Node.
Le paramètre arg est un objet Node.
Cette méthode peut soulever une exception DOMException.
removeNamedItem(name)
Cette méthode retourne un objet Node.
Le paramètre name est du type String.
Cette méthode peut soulever une exception DOMException.
item(index)
Cette méthode retourne un objet Node.
Le paramètre index est du type Number.
Remarque : On peut aussi déréférencer cet objet en utilisant une notation entre crochets (par exemple, obj[1]). Le déréférencement avec un index entier équivaut à l'utilisation de la méthode item avec cet index.
getNamedItemNS(namespaceURI, localName)
Cette méthode retourne un objet Node.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
setNamedItemNS(arg)
Cette méthode retourne un objet Node.
Le paramètre arg est un objet Node.
Cette méthode peut soulever une exception DOMException.
removeNamedItemNS(namespaceURI, localName)
Cette méthode retourne un objet Node.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
Cette méthode peut soulever une exception DOMException.
Objet CharacterData
L'objet CharacterData a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet CharacterData a les propriét&eacut;es suivantes :
data
Cette propriété est du type String et peut soulever une exception DOMException à l'initialisation comme en retour.
length
Cette propriété en lecture seule est du type Number.
L'objet CharacterData a les méthodes suivantes :
substringData(offset, count)
Cette méthode retourne un type String.
Le paramètre offset est du type Number.
Le paramètre count est du type Number.
Cette méthode peut soulever une exception DOMException.
appendData(arg)
Cette méthode ne retourne aucune valeur.
Le paramètre arg est du type String.
Cette méthode peut soulever une exception DOMException.
insertData(offset, arg)
Cette méthode ne retourne aucune valeur.
Le paramètre offset est du type Number.
Le paramètre arg est du type String.
Cette méthode peut soulever une exception DOMException.
deleteData(offset, count)
Cette méthode ne retourne aucune valeur.
Le paramètre offset est du type Number.
Le paramètre count est du type Number.
Cette méthode peut soulever une exception DOMException.
replaceData(offset, count, arg)
Cette méthode ne retourne aucune valeur.
Le paramètre offset est du type Number.
Le paramètre count est du type Number.
Le paramètre arg est du type String.
Cette méthode peut soulever une exception DOMException.
Objet Attr
L'objet Attr a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet Attr a les propriétés suivantes :
name
Cette propriété en lecture seule est du type String.
specified
Cette propriété en lecture seule est du type Boolean.
value
Cette propriété est du type String and can raise a DOMException object on setting.
ownerElement
Cette propriété en lecture seule est un objet Element.
Objet Element
L'objet Element a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet Element a les propriétés suivantes :
tagName
Cette propriété en lecture seule est du type String.
L'objet Element a les méthodes suivantes :
getAttribute(name)
Cette méthode retourne un type String.
Le paramètre name est du type String.
setAttribute(name, value)
Cette méthode ne retourne aucune valeur.
Le paramètre name est du type String.
Le paramètre value est du type String.
Cette méthode peut soulever une exception DOMException.
removeAttribute(name)
Cette méthode ne retourne aucune valeur.
Le paramètre name est du type String.
Cette méthode peut soulever une exception DOMException.
getAttributeNode(name)
Cette méthode retourne un objet Attr.
Le paramètre name est du type String.
setAttributeNode(newAttr)
Cette méthode retourne un objet Attr.
Le paramètre newAttr est un objet Attr.
Cette méthode peut soulever une exception DOMException.
removeAttributeNode(oldAttr)
Cette méthode retourne un objet Attr.
Le paramètre oldAttr est un objet Attr.
Cette méthode peut soulever une exception DOMException.
getElementsByTagName(name)
Cette méthode retourne un objet NodeList.
Le paramètre name est du type String.
getAttributeNS(namespaceURI, localName)
Cette méthode retourne un type String.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
setAttributeNS(namespaceURI, qualifiedName, value)
Cette méthode ne retourne aucune valeur.
Le paramètre namespaceURI est du type String.
Le paramètre qualifiedName est du type String.
Le paramètre value est du type String.
Cette méthode peut soulever une exception DOMException.
removeAttributeNS(namespaceURI, localName)
Cette méthode ne retourne aucune valeur.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
Cette méthode peut soulever une exception DOMException.
getAttributeNodeNS(namespaceURI, localName)
Cette méthode retourne un objet Attr.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
setAttributeNodeNS(newAttr)
Cette méthode retourne un objet Attr.
Le paramètre newAttr est un objet Attr.
Cette méthode peut soulever une exception DOMException.
getElementsByTagNameNS(namespaceURI, localName)
Cette méthode retourne un objet NodeList.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
hasAttribute(name)
Cette méthode retourne un type Boolean.
Le paramètre name est du type String.
hasAttributeNS(namespaceURI, localName)
Cette méthode retourne un type Boolean.
Le paramètre namespaceURI est du type String.
Le paramètre localName est du type String.
Objet Text
L'objet Text a toutes les propriétés et méthodes de l'objet CharacterData ainsi que celles définies ci-dessous.
L'objet Text a les méthodes suivantes :
splitText(offset)
Cette méthode retourne un objet Text.
Le paramètre offset est du type Number.
Cette méthode peut soulever une exception DOMException.
Objet Comment
L'objet Comment a toutes les propriétés et méthodes de l'objet CharacterData ainsi que celles définies ci-dessous.
Objet CDATASection
L'objet CDATASection a toutes les propriétés et méthodes de l'objet Text ainsi que celles définies ci-dessous.
Objet DocumentType
L'objet DocumentType a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet DocumentType a les propriétés suivantes :
name
Cette propriété en lecture seule est du type String.
entities
Cette propriété en lecture seule est un objet NamedNodeMap.
notations
Cette propriété en lecture seule est un objet NamedNodeMap.
publicId
Cette propriété en lecture seule est du type String.
systemId
Cette propriété en lecture seule est du type String.
internalSubset
Cette propriété en lecture seule est du type String.
Objet Notation
L'objet Notation a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet Notation a les propriétés suivantes :
publicId
Cette propriété en lecture seule est du type String.
systemId
Cette propriété en lecture seule est du type String.
Objet Entity
L'objet Entity a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet Entity a les propriétés suivantes :
publicId
Cette propriété en lecture seule est du type String.
systemId
Cette propriété en lecture seule est du type String.
notationName
Cette propriété en lecture seule est du type String.
Objet EntityReference
L'objet EntityReference a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
Objet ProcessingInstruction
L'objet ProcessingInstruction a toutes les propriétés et méthodes de l'objet Node ainsi que celles définies ci-dessous.
L'objet ProcessingInstruction a les propriétés suivantes :
target
Cette propriété en lecture seule est du type String.
data
Cette propriété est du type String et peut soulever une exception DOMException à l'initialisation.