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, 3^e é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.