Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

HTMLButtonElement.type — tipo de ação do botão

HTMLButtonElement.type lê o tipo efetivo de um botão e escreve o seu atributo type. Distingue submit, reset e button; um valor em falta ou inválido nem sempre significa submit.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

button.type
button.type = "submit"; // or "reset", "button"

HTMLButtonElement.type é uma propriedade de cadeia de caracteres gravável do DOM do navegador, definida pelo HTML Living Standard e não pelo ECMAScript. submit significa enviar o formulário associado, reset significa repô-lo e button significa que não ocorre qualquer envio ou reposição por predefinição. A gestão de eventos e as ações declarativas continuam a ser possíveis.

A escrita define o atributo type. A leitura devolve o valor efetivo em minúsculas, que pode não corresponder ao texto bruto do atributo. Assim, depois de atribuir "RESET", a propriedade devolve "reset", mas getAttribute("type") devolve "RESET".

Um valor de atributo em falta ou inválido corresponde ao estado Auto. Nesse estado, a leitura devolve "submit" se nem command nem commandfor estiverem presentes e o elemento pai não for select; caso contrário, devolve "button". O valor explícito "submit" não depende destas condições.

Se um botão não deve enviar um formulário, define explicitamente type = "button". A propriedade não ativa o botão por si só. O exemplo requer um DOM de navegador; a presença de Node 24 não comprova o suporte desta API.

Exemplos

const button = document.createElement("button");
console.log(button.type);

button.type = "RESET";
console.log(button.type, button.getAttribute("type"));

button.type = "unknown";
console.log(button.type, button.getAttribute("type"));

button.type = "button";
console.log(button.type);

Resultado

submit
reset RESET
submit unknown
button

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes