Expand description
A Collection of Header implementations for common HTTP Headers.
Mime Types
Several header fields use MIME values for their contents. Keeping with the strongly-typed theme,
the mime crate is used in such headers as ContentType and Accept.
Modules
Structs
Accept header, defined in RFC 7231 §5.3.2.Accept-Charset header, defined in RFC 7231 §5.3.3.Accept-Encoding header, defined
in RFC 7231Accept-Language header, defined
in RFC 7231 §5.3.5Allow header, defined
in RFC 7231 §7.4.1Cache-Control header, defined
in RFC 7234 §5.2.A Content-Disposition header. It is compatible to be used either as
a response header for the main body
as (re)defined in RFC 6266, or as
a header for a multipart body
as (re)defined in RFC 7587.
Content-Language header, defined
in RFC 7231 §3.1.3.2Content-Range header, defined
in RFC 7233 §4.2Content-Type header, defined
in RFC 7231 §3.1.1.5Date header, defined
in RFC 7231 §7.1.1.2ETag header, defined in
RFC 7232 §2.3An entity tag, defined in [RFC 7232 §2.3].
Expires header, defined
in RFC 7234 §5.3The value part of an extended parameter consisting of three parts:
A multi-map of HTTP headers.
Represents an HTTP header field name
Represents an HTTP header field value.
A timestamp with HTTP-style formatting and parsing.
If-Modified-Since header, defined
in RFC 7232 §3.3If-Unmodified-Since header, defined
in RFC 7232 §3.4A possible error when converting a
HeaderName from another type.A possible error when converting a
HeaderValue from a string or byte
slice.A language tag as described in RFC 5646.
Last-Modified header, defined
in RFC 7232 §2.2Represents a quality used in q-factor values.
Represents an item with a quality value as defined
in RFC 7231 §5.3.1.
A possible error when converting a
HeaderValue to a string representation.Enums
A range of bytes to fetch.
CacheControl contains a list of these directives.A MIME character set.
Represents a supported content encoding.
Content-Range header, defined
in RFC 7233 §4.2
Parameter in
ContentDisposition.The implied disposition of the content of the HTTP body.
A value to represent an encoding used in the
Accept-Encoding and Content-Encoding header.If-Match header, defined
in RFC 7232 §3.1If-None-Match header, defined
in RFC 7232 §3.2If-Range header, defined
in RFC 7233 §3.2A wrapper for types used in header values where wildcard (
*) items are allowed but the
underlying type does not support them.Range header, defined
in RFC 7233 §3.1Constants
Advertises which content types the client is able to understand.
Advertises which character set the client is able to understand.
Advertises which content encoding the client is able to understand.
Advertises which languages the client is able to understand.
Marker used by the server to advertise partial request support.
Preflight response indicating if the response to the request can be
exposed to the page.
Preflight response indicating permitted HTTP headers.
Preflight header response indicating permitted access methods.
Indicates whether the response can be shared with resources with the
given origin.
Indicates which headers can be exposed as part of the response by
listing their names.
Indicates how long the results of a preflight request can be cached.
Informs the server which HTTP headers will be used when an actual
request is made.
Informs the server know which HTTP method will be used when the actual
request is made.
Indicates the time in seconds the object has been in a proxy cache.
Lists the set of methods support by a resource.
Advertises the availability of alternate services to clients.
Contains the credentials to authenticate a user agent with a server.
Specifies directives for caching mechanisms in both requests and
responses.
Response header field that indicates how caches have handled that response and its corresponding
request.
Response header field that allows origin servers to control the behavior of CDN caches
interposed between them and clients separately from other caches that might handle the response.
Controls whether or not the network connection stays open after the
current transaction finishes.
Indicates if the content is expected to be displayed inline.
Used to compress the media-type.
Used to describe the languages intended for the audience.
Indicates the size of the entity-body.
Indicates an alternate location for the returned data.
Indicates where in a full body message a partial message belongs.
Allows controlling resources the user agent is allowed to load for a
given page.
Allows experimenting with policies by monitoring their effects.
Used to indicate the media type of the resource.
Contains stored HTTP cookies previously sent by the server with the
Set-Cookie header.
Response header that allows you to ensure a top-level document does not share a browsing context
group with cross-origin documents.
Response header that conveys a desire that the browser blocks no-cors cross-origin/cross-site
requests to the given resource.
Contains the date and time at which the message was originated.
Indicates the client’s tracking preference.
Identifier for a specific version of a resource.
Indicates expectations that need to be fulfilled by the server in order
to properly handle the request.
Contains the date/time after which the response is considered stale.
Contains information from the client-facing side of proxy servers that
is altered or lost when a proxy is involved in the path of the request.
Contains an Internet email address for a human user who controls the
requesting user agent.
Specifies the domain name of the server and (optionally) the TCP port
number on which the server is listening.
Makes a request conditional based on the E-Tag.
Makes a request conditional based on the modification date.
Makes a request conditional based on the E-Tag.
Makes a request conditional based on range.
Makes the request conditional based on the last modification date.
Content-Types that are acceptable for the response.
Allows the server to point an interested client to another resource
containing metadata about the requested resource.
Indicates the URL to redirect a page to.
Indicates the max number of intermediaries the request should be sent
through.
Indicates where a fetch originates from.
Response header that provides a mechanism to allow and deny the use of browser features in a
document or within any
<iframe> elements in the document.HTTP/1.0 header usually used for backwards compatibility.
Defines the authentication method that should be used to gain access to
a proxy.
Contains the credentials to authenticate a user agent to a proxy server.
Associates a specific cryptographic public key with a certain server.
Sends reports of pinning violation to the report-uri specified in the
header.
Indicates the part of a document that the server should return.
Contains the address of the previous web page from which a link to the
currently requested page was followed.
Governs which referrer information should be included with requests
made.
Informs the web browser that the current page or frame should be
refreshed.
The Retry-After response HTTP header indicates how long the user agent
should wait before making a follow-up request. There are two main cases
this header is used:
The |Sec-WebSocket-Accept| header field is used in the WebSocket
opening handshake. It is sent from the server to the client to
confirm that the server is willing to initiate the WebSocket
connection.
The |Sec-WebSocket-Extensions| header field is used in the WebSocket
opening handshake. It is initially sent from the client to the
server, and then subsequently sent from the server to the client, to
agree on a set of protocol-level extensions to use for the duration
of the connection.
The |Sec-WebSocket-Key| header field is used in the WebSocket opening
handshake. It is sent from the client to the server to provide part
of the information used by the server to prove that it received a
valid WebSocket opening handshake. This helps ensure that the server
does not accept connections from non-WebSocket clients (e.g., HTTP
clients) that are being abused to send data to unsuspecting WebSocket
servers.
The |Sec-WebSocket-Protocol| header field is used in the WebSocket
opening handshake. It is sent from the client to the server and back
from the server to the client to confirm the subprotocol of the
connection. This enables scripts to both select a subprotocol and be
sure that the server agreed to serve that subprotocol.
The |Sec-WebSocket-Version| header field is used in the WebSocket
opening handshake. It is sent from the client to the server to
indicate the protocol version of the connection. This enables
servers to correctly interpret the opening handshake and subsequent
data being sent from the data, and close the connection if the server
cannot interpret that data in a safe manner.
Contains information about the software used by the origin server to
handle the request.
Used to send cookies from the server to the user agent.
Tells the client to communicate with HTTPS instead of using HTTP.
Informs the server of transfer encodings willing to be accepted as part
of the response.
Allows the sender to include additional fields at the end of chunked
messages.
Specifies the form of encoding used to safely transfer the entity to the
client.
Used as part of the exchange to upgrade the protocol.
Sends a signal to the server expressing the client’s preference for an
encrypted and authenticated response.
Contains a string that allows identifying the requesting client’s
software.
Determines how to match future requests with cached responses.
Added by proxies to track routing.
General HTTP header contains information about possible problems with
the status of the message.
Defines the authentication method that should be used to gain access to
a resource.
Marker used by the server to indicate that the MIME types advertised in
the
content-type headers should not be changed and be followed.Controls DNS prefetching.
Request header (de-facto standard) for identifying the originating IP address of a client
connecting to a web server through a proxy server.
Request header (de-facto standard) for identifying the original host requested by the client in
the
Host HTTP request header.Request header (de-facto standard) for identifying the protocol that a client used to connect to
your proxy or load balancer.
Indicates whether or not a browser should be allowed to render a page in
a frame.
Stop pages from loading when an XSS attack is detected.
Traits
Sealed trait implemented for types that can be effectively borrowed as a
HeaderValue.An interface for types that already represent a valid header.
An interface for types that can be converted into a
HeaderName + HeaderValue pair for
insertion into a HeaderMap.An interface for types that can be converted into a
HeaderValue.Functions
Format an array into a comma-delimited string.
Reads a comma-delimited raw header into a Vec.
Reads a single string when parsing a header.
Percent encode a sequence of bytes with a character set defined in RFC 5987 §3.2.
Parses extended header parameter values (
ext-value), as defined
in RFC 5987 §3.2.