In a multipart/form-data
body, the Cache-Disposition
general header is a header that can be used on the subpart of a multipart body to give information about the field it applies to.
The Cache-Disposition
header is defined in the larger context of MIME messages for e-mail, but only a subset of the possible parameters applies to HTTP Forms and {{HTTPMethod("POST")}} requests. Only this subset is described in
Header type | {{Glossary("General header")}} (for subpart of a multipart body) |
---|---|
{{Glossary("Forbidden header name")}} | no |
Syntax
The first parameter in the HTTP context is always form-data
; additional parameters are case-insensitive and have arguments, that use quoted-string syntax after the '='
sign. Multiple parameters are separated a semi-colon (';'
).
Content-Disposition: form-data Content-Disposition: form-data; name="fieldName" Content-Disposition: form-data; name="fieldName"; filename="filename.jpg"
Parameters
name
- Is followed by a string containing the name of the HTML field in the form that the content of this subpart refer to. When dealing with multiple files in the same field (the {{htmlattrxref("multiple", "input")}} attribute of an {{HTMLElement("input","input type=file")}} element, there can be several subpart with the same name
filename
- Is followed by a string containing the original name of file transmitted in the subpart. The filename is always optional and must not be used blindly by the application: path information should be striped, and conversion to the server file system rules should be done. It is mostly an indicative information.
Examples
Specifications
Specification | Title |
---|---|
{{RFC("7578")}} | Returning Values from Forms: multipart/form-data |
{{RFC("2183")}} | Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field |
Browser compatibility
To contribute to this compatibility data, please write a pull request against this file: https://github.com/mdn/browser-compat-data/blob/master/http/headers.json.
{{Compat}}