from dataclasses import dataclass @dataclass class Header: name: str example: str description: str headers = [ { "section": "Authentication", "name": "WWW-Authenticate", "description": "Defines the authentication method that should be used to access a resource.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/WWW-Authenticate", }, { "section": "Authentication", "name": "Authorization", "description": "Contains the credentials to authenticate a user-agent with a server.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Authorization", }, { "section": "Authentication", "name": "Proxy-Authenticate", "description": "Defines the authentication method that should be used to access a resource behind a proxy server.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Proxy-Authenticate", }, { "section": "Authentication", "name": "Proxy-Authorization", "description": "Contains the credentials to authenticate a user agent with a proxy server.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Proxy-Authorization", }, { "section": "Caching", "name": "Age", "description": "The time, in seconds, that the object has been in a proxy cache.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Age", }, { "section": "Caching", "name": "Cache-Control", "description": "Directives for caching mechanisms in both requests and responses.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Cache-Control", }, { "section": "Caching", "name": "Clear-Site-Data", "description": "Clears browsing data (e.g. cookies, storage, cache) associated with the requesting website.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Clear-Site-Data", }, { "section": "Caching", "name": "Expires", "description": "The date/time after which the response is considered stale.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Expires", }, { "section": "Caching", "name": "No-Vary-Search", "description": "Specifies a set of rules that define how a URL's query parameters will affect cache matching. These rules dictate whether the same URL with different URL parameters should be saved as separate browser cache entries.", "experimental": True, "url": "/en-US/docs/Web/HTTP/Headers/No-Vary-Search", }, { "section": "Conditionals", "name": "Last-Modified", "description": "The last modification date of the resource, used to compare several versions of the same resource. It is less accurate than ETag, but easier to calculate in some environments. Conditional requests using If-Modified-Since and If-Unmodified-Since use this value to change the behavior of the request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Last-Modified", }, { "section": "Conditionals", "name": "ETag", "description": "A unique string identifying the version of the resource. Conditional requests using If-Match and If-None-Match use this value to change the behavior of the request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/ETag", }, { "section": "Conditionals", "name": "If-Match", "description": "Makes the request conditional, and applies the method only if the stored resource matches one of the given ETags.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/If-Match", }, { "section": "Conditionals", "name": "If-None-Match", "description": "Makes the request conditional, and applies the method only if the stored resource doesn't match any of the given ETags. This is used to update caches (for safe requests), or to prevent uploading a new resource when one already exists.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/If-None-Match", }, { "section": "Conditionals", "name": "If-Modified-Since", "description": "Makes the request conditional, and expects the resource to be transmitted only if it has been modified after the given date. This is used to transmit data only when the cache is out of date.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/If-Modified-Since", }, { "section": "Conditionals", "name": "If-Unmodified-Since", "description": "Makes the request conditional, and expects the resource to be transmitted only if it has not been modified after the given date. This ensures the coherence of a new fragment of a specific range with previous ones, or to implement an optimistic concurrency control system when modifying existing documents.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/If-Unmodified-Since", }, { "section": "Conditionals", "name": "Vary", "description": "Determines how to match request headers to decide whether a cached response can be used rather than requesting a fresh one from the origin server.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Vary", }, { "section": "Connection management", "name": "Connection", "description": "Controls whether the network connection stays open after the current transaction finishes.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Connection", }, { "section": "Connection management", "name": "Keep-Alive", "description": "Controls how long a persistent connection should stay open.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Keep-Alive", }, { "section": "Content negotiation", "name": "Accept", "description": "Informs the server about the types of data that can be sent back.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Accept", }, { "section": "Content negotiation", "name": "Accept-Encoding", "description": "The encoding algorithm, usually a compression algorithm, that can be used on the resource sent back.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Accept-Encoding", }, { "section": "Content negotiation", "name": "Accept-Language", "description": "Informs the server about the human language the server is expected to send back. This is a hint and is not necessarily under the full control of the user: the server should always pay attention not to override an explicit user choice (like selecting a language from a dropdown).", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Accept-Language", }, { "section": "Controls", "name": "Expect", "description": "Indicates expectations that need to be fulfilled by the server to properly handle the request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Expect", }, { "section": "Controls", "name": "Max-Forwards", "description": "When using TRACE, indicates the maximum number of hops the request can do before being reflected to the sender.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Max-Forwards", }, { "section": "Cookies", "name": "Cookie", "description": "Contains stored HTTP cookies previously sent by the server with the Set-Cookie header.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Cookie", }, { "section": "Cookies", "name": "Set-Cookie", "description": "Send cookies from the server to the user-agent.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Set-Cookie", }, { "section": "CORS", "name": "Access-Control-Allow-Credentials", "description": "Indicates whether the response to the request can be exposed when the credentials flag is true.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Credentials", }, { "section": "CORS", "name": "Access-Control-Allow-Headers", "description": "Used in response to a preflight request to indicate which HTTP headers can be used when making the actual request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Headers", }, { "section": "CORS", "name": "Access-Control-Allow-Methods", "description": "Specifies the methods allowed when accessing the resource in response to a preflight request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Methods", }, { "section": "CORS", "name": "Access-Control-Allow-Origin", "description": "Indicates whether the response can be shared.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin", }, { "section": "CORS", "name": "Access-Control-Expose-Headers", "description": "Indicates which headers can be exposed as part of the response by listing their names.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Expose-Headers", }, { "section": "CORS", "name": "Access-Control-Max-Age", "description": "Indicates how long the results of a preflight request can be cached.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Max-Age", }, { "section": "CORS", "name": "Access-Control-Request-Headers", "description": "Used when issuing a preflight request to let the server know which HTTP headers will be used when the actual request is made.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Request-Headers", }, { "section": "CORS", "name": "Access-Control-Request-Method", "description": "Used when issuing a preflight request to let the server know which HTTP method will be used when the actual request is made.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Access-Control-Request-Method", }, { "section": "CORS", "name": "Origin", "description": "Indicates where a fetch originates from.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Origin", }, { "section": "CORS", "name": "Timing-Allow-Origin", "description": "Specifies origins that are allowed to see values of attributes retrieved via features of the Resource Timing API, which would otherwise be reported as zero due to cross-origin restrictions.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Timing-Allow-Origin", }, { "section": "Downloads", "name": "Content-Disposition", "description": 'Indicates if the resource transmitted should be displayed inline (default behavior without the header), or if it should be handled like a download and the browser should present a "Save As" dialog.', "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Disposition", }, { "section": "Message body information", "name": "Content-Length", "description": "The size of the resource, in decimal number of bytes.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Length", }, { "section": "Message body information", "name": "Content-Type", "description": "Indicates the media type of the resource.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Type", }, { "section": "Message body information", "name": "Content-Encoding", "description": "Used to specify the compression algorithm.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Encoding", }, { "section": "Message body information", "name": "Content-Language", "description": "Describes the human language(s) intended for the audience, so that it allows a user to differentiate according to the users' own preferred language.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Language", }, { "section": "Message body information", "name": "Content-Location", "description": "Indicates an alternate location for the returned data.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Location", }, { "section": "Proxies", "name": "Forwarded", "description": "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.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Forwarded", }, { "section": "Proxies", "name": "Via", "description": "Added by proxies, both forward and reverse proxies, and can appear in the request headers and the response headers.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Via", }, { "section": "Redirects", "name": "Location", "description": "Indicates the URL to redirect a page to.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Location", }, { "section": "Request context", "name": "From", "description": "Contains an Internet email address for a human user who controls the requesting user agent.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/From", }, { "section": "Request context", "name": "Host", "description": "Specifies the domain name of the server (for virtual hosting), and (optionally) the TCP port number on which the server is listening.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Host", }, { "section": "Request context", "name": "Referer", "description": "The address of the previous web page from which a link to the currently requested page was followed.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Referer", }, { "section": "Request context", "name": "Referrer-Policy", "description": "Governs which referrer information sent in the Referer header should be included with requests made.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Referrer-Policy", }, { "section": "Request context", "name": "User-Agent", "description": "Contains a characteristic string that allows the network protocol peers to identify the application type, operating system, software vendor or software version of the requesting software user agent.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/User-Agent", }, { "section": "Response context", "name": "Allow", "description": "Lists the set of HTTP request methods supported by a resource.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Allow", }, { "section": "Response context", "name": "Server", "description": "Contains information about the software used by the origin server to handle the request.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Server", }, { "section": "Range requests", "name": "Accept-Ranges", "description": "Indicates if the server supports range requests, and if so in which unit the range can be expressed.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Accept-Ranges", }, { "section": "Range requests", "name": "Range", "description": "Indicates the part of a document that the server should return.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Range", }, { "section": "Range requests", "name": "If-Range", "description": "Creates a conditional range request that is only fulfilled if the given etag or date matches the remote resource. Used to prevent downloading two ranges from incompatible version of the resource.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/If-Range", }, { "section": "Range requests", "name": "Content-Range", "description": "Indicates where in a full body message a partial message belongs.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Range", }, { "section": "Security", "name": "Cross-Origin-Embedder-Policy", "description": "Allows a server to declare an embedder policy for a given document.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Cross-Origin-Embedder-Policy", }, { "section": "Security", "name": "Cross-Origin-Opener-Policy", "description": "Prevents other domains from opening/controlling a window.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Cross-Origin-Opener-Policy", }, { "section": "Security", "name": "Cross-Origin-Resource-Policy", "description": "Prevents other domains from reading the response of the resources to which this header is applied. See also CORP explainer article.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Cross-Origin-Resource-Policy", }, { "section": "Security", "name": "Content-Security-Policy", "description": "Controls resources the user agent is allowed to load for a given page.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Security-Policy", }, { "section": "Security", "name": "Content-Security-Policy-Report-Only", "description": "Allows web developers to experiment with policies by monitoring, but not enforcing, their effects. These violation reports consist of JSON documents sent via an HTTP POST request to the specified URI.", "experimental": False, "url": "/en-US/docs/Web/HTTP/Headers/Content-Security-Policy-Report-Only", }, { "section": "Security", "name": "Permissions-Policy", "description": "Provides a mechanism to allow and deny the use of browser features in a website's own frame, and in