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.