Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

enctype: kodowanie wysyłanego formularza

Dla plików używaj multipart, pozostawiając przeglądarce utworzenie granicy części.

Wersja: HTML Living Standard

Składnia

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

Atrybut formularza enctype wybiera kodowanie przesyłania. Wartości to application/x-www-form-urlencoded, multipart/form-data i text/plain; brak lub błąd oznacza pierwszą. Przycisk wysyłający może nadpisać ustawienie formularza. Kodowanie dotyczy algorytmu przesyłania, szczególnie treści HTTP POST, a nie gwarancji wysyłania ciała multipart przez GET.

Do wysyłania zawartości plików używaj multipart. Przeglądarka tworzy granicę rozdzielającą części; przy FormData wysyłanym JavaScriptem nie wymyślaj niepasującego nagłówka Content-Type. Zapis zwykłym tekstem jest niejednoznaczny i nie nadaje się do niezawodnego przetwarzania struktury. Serwer powinien sprawdzać nazwy, rozmiary i zawartość plików.

Scenariusz tworzy mały plik testowy i wysyła prawdziwy multipart POST. Lokalny endpoint sprawdza typ treści, pole, nazwę i bajty pliku. Weryfikuje to reprezentację żądania, nie tylko wartość atrybutu formularza.

Przykłady

<!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>

Wynik

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

Plik powstaje w pamięci i trafia wyłącznie do odizolowanego przechwytywanego endpointu.

Źródła