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

CKTIS / HTML

enctype: codificação do envio de formulários

Use multipart para ficheiros e deixe o navegador gerar a separação entre partes.

Versão: HTML Living Standard

Sintaxe

<form method="post" enctype="multipart/form-data">...</form>

O atributo de formulário enctype seleciona a codificação do envio. Os valores são application/x-www-form-urlencoded, multipart/form-data e text/plain; ausência ou erro usam o primeiro. O botão de envio pode substituir a definição. Afeta o algoritmo de envio, sobretudo o corpo HTTP POST, sem prometer um corpo multipart com GET.

Use multipart para conteúdos de ficheiros. O navegador cria o delimitador entre partes; não invente um Content-Type incompatível ao enviar FormData com JavaScript. Texto simples é ambíguo e inadequado para processamento estruturado robusto. Valide nomes, tamanhos e conteúdos no servidor.

O teste gera um ficheiro pequeno e envia um POST multipart real. O endpoint local verifica tipo de conteúdo, campo, nome e bytes. Comprova-se a representação transmitida, não apenas o atributo do formulário.

Exemplos

<!doctype html><meta charset="utf-8">
<form id="form" action="/upload" method="post" enctype="multipart/form-data"><label>Title <input name="title" value="Example"></label><label>File <input id="file" name="document" type="file"></label><button>Send local fixture</button></form>
<script>
// A generated test file, never a file read from the user's device.
const files = new DataTransfer(); files.items.add(new File(['Local file.'], 'note.txt', { type: 'text/plain' }));
document.querySelector('#file').files = files.files;
// The isolated local endpoint validates the actual multipart request and returns its result.
</script>

Resultado

multipart=true; filename=note.txt; text=Local file.

O ficheiro é gerado em memória e enviado apenas ao endpoint isolado e intercetado.

Fontes