Propriedades Padrão Disponíveis para Objetos HTML de Testes Funcionais

As propriedades padrão fornecem uma maneira comum de acesso às propriedades e seus valores nos navegadores. Este tópico lista as propriedades padrão disponíveis para objetos HTML.

A maioria dessas propriedades são modeladas em atributos do elemento HTML definidos por W3C.

Propriedade Uso
.align Valor do atributo align do elemento. Os valores válidos são parte inferior, meio e parte superior.
.alt Valor do atributo alt de um elemento. Este é o texto "alternativo" para o elemento, exibido geralmente pelo navegador quando o mouse fica suspenso sobre o elemento.
.border Valor do atributo border do elemento. Retorna o número de pixels.
.bounds Retângulo que representa o limite do objeto em coordenadas da tela.
.caption Para elementos TABLE, o valor do atributo caption. Para uma caixa de diálogo HTML, esse é o nome da caixa de diálogo.
.cellIndex Índice da célula de um elemento em relação à sua linha (>=0).
.checked Valor booleano que indica se uma caixa de opções está marcada (verdadeiro) ou não (falso).
.class Nome da classe TestObject; por exemplo, "HtmlTable" para um elemento TABLE.
.className Valor do atributo de classe de um elemento (utilizado para folhas de estilo em HTML).
.clientRect Retângulo limite do elemento em coordenadas do cliente.
.code Valor do atributo code de um elemento APPLET.
.codeBase Valor do atributo codeBase de um elemento APPLET.
.colSpan Valor do atributo colSpan de um elemento.
.cookie Valor atual do cookie para o documento.
.coords Valor do atributo coords de um elemento. Essa é uma cadeia contendo as coordenadas utilizadas para definir o elemento AREA de um mapa de imagem do lado cliente. No formulário x1, y1, x2, y2, etc.
.defaultChecked Valor booleano para o atributo defaultChecked do elemento.
.defaultSelected Valor booleano; quando verdadeiro indica que o elemento OPTION em um elemento SELECT (caixa de listagem ou drop-down) é selecionado por padrão quando a página é exibida.
.defaultValue Valor do atributo defaultValue do elemento.
.disabled Valor do atributo disabled de um elemento, retornado como booleano. Se verdadeiro, a entrada do usuário será desativada atualmente para esse item.
.hasFocus Indica se o elemento atual está em foco.
.hasScript Valor booleano; verdadeiro quando um script está associado a ações nesse elemento.
.height Valor do atributo height de um elemento. Para um elemento Image, é a altura de exibição em pixels da imagem.
.href Valor do atributo href de um elemento. É um URL utilizado pelos elementos ANCHOR e AREA para indicar o resultado do clique no elemento correspondente.
.hspace Valor do atributo hspace de um elemento, a quantidade de espaço em branco inserida à esquerda ou à direita de um elemento IMG, OBJECT ou APPLET.
.id Valor do atributo id de um elemento.
.indeterminate Valor booleano; verdadeiro quando o status da caixa de opções é alterado.
.index Índice do elemento OPTION em uma caixa de listagem ou lista de combinação drop-down.
.isMap Valor booleano; para elementos Image (IMG), esse valor é verdadeiro quando o elemento é um mapa de imagem do lado do servidor.
.length Valor do atributo length de um elemento. Para um elemento SELECT, indica o número de itens na lista.
.maxLength Para um controle de edição (Tipo de entrada=Text ou TextArea), indica o número máximo de caracteres que pode ser digitado por um usuário.
.multiple Valor booleano; para um elemento SELECT (caixa de listagem ou lista de combinação drop-down), um valor verdadeiro indica que a lista suporta várias seleções.
.name Valor do atributo name (somente para elementos Form e para Quadros).
.noHref Valor do atributo noHref de um elemento. Quando definido em um elemento AREA, indica que a área correspondente não possui ação associada.
.offsetHeight Altura do elemento.
.offsetLeft Deslocamento, em pixels, do elemento da sua borda esquerda até a borda esquerda de seu elemento pai no DOM.
.offsetRight Deslocamento, em pixels, do elemento da sua borda direita até a borda direita de seu elemento pai no DOM.
.offsetTop Deslocamento do elemento a partir do deslocamento de seu elemento pai no DOM.
.offsetWidth Largura do elemento.
.readOnly Valor do atributo readOnly de um elemento. Valor booleano; verdadeiro quando o elemento form é de leitura.
.readyState

Status atual de um navegador que indica se está carregando um documento no momento ou se está pronto para entrada do usuário. Este é um valor inteiro:

0 - Não inicializado

1 - Carregando

2 - Carregado

3- Interativo

4 - Completo (pronto)

.rowIndex Índice da linha de um elemento em uma tabela (>=0 ).
.rows Valor do atributo rows de um elemento TEXTAREA que indica o tamanho do controle de edição no número de linhas de texto.
.rowSpan Valor do atributo rowSpan de um elemento.
.screenLeft Canto superior esquerdo do retângulo limite em coordenadas da tela, componente x.
.screenTop Canto superior esquerdo do retângulo limite em coordenadas da tela, componente y.
.select Valor booleano; verdadeiro quando o elemento FORM é realçado para receber entrada do usuário.
.selected Valor booleano; verdadeiro quando o elemento OPTION em um elemento SELECT (caixa de listagem ou drop-down) é selecionado.
.selectedIndex Valor do atributo selectedIndex de um elemento. Para um único elemento Select de seleção, indica qual elemento de opção está selecionado. Inteiro no intervalo de >=0.
.shape Valor do atributo shape de um elemento. Utilizado para elementos AREA em mapas de imagem do lado cliente. Os valores válidos são padrão, retângulo, círculo e polígono.
.size Valor do atributo size de um elemento. Para um elemento Select, o número de itens exibidos de uma vez na lista. Se o tamanho for > 1, a lista aparecerá como caixa de listagem; caso contrário, aparecerá como lista de combinação drop-down.
.src Valor do atributo src do elemento. Para imagens e botões de imagem, é um URL que especifica o arquivo de imagem.
.tag Tag HTML para o elemento.
.target Valor do atributo target de um elemento. Para âncoras, indica o nome do quadro de destino, isto é, o quadro no qual o documento deve ser aberto.
.text

Texto dentro das tags HTML para limitar o elemento. Por exemplo:

  <A>This is an Anchor<IMG src=map.gif></a>

A propriedade de texto retorna "This is an Anchor". Se forem localizados caracteres de espaço em branco consecutivos, todos os espaços em branco serão combinados e reduzidos a um único caractere em branco.

.title Valor do atributo title de um elemento. Freqüentemente, esse é o texto exibido quando o mouse fica suspenso sobre o elemento.
.type Valor do atributo type de um elemento. Por exemplo, para um elemento Input, é texto, senha, caixa de opções, rádio, submeter, imagem, reconfigurar, botão, oculto ou arquivo.
.url URL do documento.
.useMap Valor do atributo useMap de um elemento. O valor é uma cadeia que especifica um URL e é utilizado para elementos IMAGE (IMG) para indicar um mapa de imagem do lado cliente. O URL aponta para o elemento MAP associado ao mapa. Freqüentemente, essa é uma referência relativa ao documento.
.value Valor do atributo value de um elemento. Em elementos Form, representa o valor enviado quando o formulário é lançado.
.vspace Valor do atributo vspace de um elemento, a quantidade de espaço em branco inserida acima ou abaixo de um elemento IMG, OBJECT ou APPLET.
.width Valor do atributo width de um elemento. Para um elemento IMAGE, é a largura de exibição em pixels da imagem.
.window Janela mais importante para o elemento retornado como longo. Para o navegador, é a janela de nível superior.

Feedback