Propriétés standard disponibles pour les objets HTML de tests fonctionnels

Ces propriétés sont qualifiées de standard parce qu'elles offrent un moyen commun d'accès aux propriétés des objets HTML et à leurs valeurs avec différents navigateurs. Cette rubrique dresse la liste des propriétés standard disponibles pour les objets HTML.

La plupart d'entre elles reprennent comme modèle les attributs des éléments HTML définis par le W3C.

Propriété Utilisation
.align Valeur de l'attribut align de l'élément. Valeurs admises : bottom, middle et top.
.alt Valeur de l'attribut alt d'un élément. Abréviation du terme anglais, cet attribut contient le texte de "remplacement" de l'élément. Le navigateur l'affiche lorsque la souris survole l'élément.
.border Valeur de l'attribut border de l'élément. Renvoie le nombre de pixels.
.bounds Rectangle représentant les limites de l'objet, en coordonnées écran.
.caption Pour les éléments TABLE, valeur de l'attribut caption. Pour une boîte de dialogue HTML, il s'agit de son nom.
.cellIndex Index de cellule d'un élément par rapport à sa ligne (>=0).
.checked Valeur booléenne indiquant si une case est cochée (true) ou non (false).
.class Nom de classe de l'objet de test (TestObject) ; par exemple, "HtmlTable" pour un élément TABLE.
.className Valeur de l'attribut class d'un élément (utilisé pour les feuilles de styles en HTML).
.clientRect Rectangle de délimitation de l'élément en coordonnées client.
.code Valeur de l'attribut code d'un élément APPLET.
.codeBase Valeur de l'attribut codeBase d'un élément APPLET.
.colSpan Valeur de l'attribut colSpan d'un élément.
.cookie Valeur courante du cookie du document.
.coords Valeur de l'attribut coords d'un élément. Il s'agit d'une chaîne contenant les coordonnées utilisées pour définir l'élément AREA d'une image cliquable côté client. Elle est de la forme x1, y1, x2, y2, et ainsi de suite.
.defaultChecked Valeur booléenne de l'attribut defaultChecked de l'élément.
.defaultSelected Valeur booléenne ; la valeur 'true' indique que l'élément OPTION contenu dans un élément SELECT (boîte à liste ou menu déroulant) est sélectionné par défaut au moment où la page est affichée.
.defaultValue Valeur de l'attribut defaultValue de l'élément.
.disabled Valeur de l'attribut disabled d'un élément, renvoyée sous forme de booléen. Si la valeur est 'true', cela signifie que l'entrée de données par l'utilisateur est actuellement désactivée pour l'élément concerné.
.hasFocus Indique si l'élément courant est la cible des entrées (focus).
.hasScript Valeur booléenne ; la valeur 'true' signifie qu'un script a été associé à des actions sur cet élément.
.height Valeur de l'attribut height d'un élément. Pour un élément image (IMG), il s'agit de la hauteur d'affichage de l'image, en pixels.
.href Valeur de l'attribut href d'un élément. Il s'agit d'une URL utilisée par les éléments ANCHOR et AREA pour indiquer le résultat d'un clic sur l'élément correspondant.
.hspace Valeur de l'attribut hspace d'un élément. Il s'agit de l'espace (en pixels) inséré à gauche ou à droite d'un élément IMG, OBJECT ou APPLET.
.id Valeur de l'attribut id d'un élément.
.indeterminate Valeur booléenne ; 'true' lorsque l'état de la case à cocher a été changé.
.index Index de l'élément OPTION dans une boîte à liste (listbox) ou une zone de liste modifiable (combo dropdown).
.isMap Valeur booléenne ; pour un élément image (IMG), cette valeur est 'true' lorsque l'élément est une image cliquable côté serveur.
.length Valeur de l'attribut length d'un élément. Pour un élément SELECT, elle indique le nombre d'articles dans la liste.
.maxLength Pour un contrôle d'édition (Input type=Text ou TextArea), indique le nombre maximum de caractères que peut entrer l'utilisateur.
.multiple Valeur booléenne ; pour un élément SELECT tel qu'une boîte à liste (listbox) ou une zone de liste modifiable (combo dropdown), la valeur 'true' indique que la liste admet la sélection de plusieurs articles à la fois.
.name Valeur de l'attribut name (éléments Form et Frames uniquement).
.noHref Valeur de l'attribut noHref d'un élément. Lorsqu'elle est définie dans un élément AREA, cela indique qu'il n'y a pas d'action associée à la région correspondante.
.offsetHeight Hauteur de l'élément.
.offsetLeft Ecart, en pixels, entre le bord gauche de l'élément et le bord gauche de son élément parent dans le DOM.
.offsetRight Ecart, en pixels, entre le bord droit de l'élément et le bord droit de son élément parent dans le DOM.
.offsetTop Position relative de l'élément par rapport au bord supérieur de son élément parent dans le DOM.
.offsetWidth Largeur de l'élément.
.readOnly Valeur de l'attribut readOnly d'un élément. Valeur booléenne ; 'true' lorsque l'élément FORM est en lecture seule.
.readyState

Etat courant d'un navigateur, indiquant s'il est en train de charger un document ou s'il est prêt à recevoir les entrées de l'utilisateur. Il s'agit d'un entier :

0 - Non initialisé

1 - Chargement en cours

2 - Document chargé

3 - Interactif

4 - Terminé (prêt)

.rowIndex Index de ligne d'un élément dans une table (>=0 ).
.rows Valeur de l'attribut rows d'un élément TEXTAREA, indiquant la taille du contrôle d'édition en nombre de lignes de texte.
.rowSpan Valeur de l'attribut rowSpan d'un élément.
.screenLeft Angle supérieur gauche du rectangle de délimitation, en coordonnées écran, composant x.
.screenTop Angle supérieur gauche du rectangle de délimitation, en coordonnées écran, composant y.
.select Valeur booléenne ; 'true' lorsque l'élément FORM est mis en évidence pour recevoir les entrées de l'utilisateur.
.selected Valeur booléenne ; 'true' lorsque l'élément OPTION contenu dans un élément SELECT (boîte à liste ou menu déroulant) est sélectionné.
.selectedIndex Valeur de l'attribut selectedIndex d'un élément. Pour un élément SELECT à sélection unique, indique quel élément OPTION est sélectionné. Entier supérieur ou égal à 0.
.shape Valeur de l'attribut shape d'un élément. Utilisé pour les éléments AREA dans les images cliquables côté client. Valeurs possibles : default, rect, circle et poly.
.size Valeur de l'attribut size d'un élément. Pour un élément SELECT, nombre d'articles visibles en même temps dans la liste. Si size > 1, l'élément est une boîte à liste (listbox) ; sinon, il s'agit d'une zone de liste modifiable (combo dropdown).
.src Valeur de l'attribut src de l'élément. Pour une image ou un bouton image, il s'agit d'une URL spécifiant l'emplacement du fichier image.
.tag Balise HTML de l'élément.
.target Valeur de l'attribut target d'un élément. Pour une ancre, cet attribut indique le nom du cadre cible, c'est-à-dire le cadre (frame) dans lequel le document doit être ouvert.
.text

Texte à l'intérieur des balises HTML pour délimiter l'élément. Par exemple :

  <A>Ceci est une ancre<IMG src=map.gif></a>

La propriété text renvoie "Ceci est une ancre". Si des espaces consécutifs sont trouvés, ils sont combinés et réduits à un seul espace.

.title Valeur de l'attribut title d'un élément. Il s'agit souvent du texte affiché lorsque le pointeur de la souris survole l'élément.
.type Valeur de l'attribut type d'un élément. Par exemple, pour un élément INPUT, il peut s'agir de text, password, check box, radio, submit, image, reset, button, hidden ou file.
.url URL du document.
.useMap Valeur de l'attribut useMap d'un élément. Cette valeur est une chaîne spécifiant une URL. Elle est utilisée dans un élément image (IMG) pour indiquer une image cliquable côté client. L'URL pointe sur l'élément MAP associé à l'image cliquable. Souvent, il s'agit d'une référence relative (par rapport au document).
.value Valeur de l'attribut value d'un élément. Dans le cas d'un élément de formulaire, il s'agit de la valeur envoyée lorsque le formulaire est soumis.
.vspace Valeur de l'attribut vspace d'un élément. Il s'agit de l'espace (en pixels) inséré au-dessus ou en dessous d'un élément IMG, OBJECT ou APPLET.
.width Valeur de l'attribut width d'un élément. Pour un élément image (IMG), il s'agit de la largeur d'affichage de l'image, en pixels.
.window Fenêtre de "poids lourd" (heavy-weight window) de l'élément, renvoyée sous forme de 'long'. Pour un navigateur, il s'agit de la fenêtre de niveau supérieur.

Retour d'informations