diff --git a/files/en-us/glossary/source_map/index.md b/files/en-us/glossary/source_map/index.md new file mode 100644 index 000000000000000..b7baf1643909194 --- /dev/null +++ b/files/en-us/glossary/source_map/index.md @@ -0,0 +1,20 @@ +--- +title: Source map +slug: Glossary/Source_map +page-type: glossary-definition +--- + +{{GlossarySidebar}} + +A **source map** is a file that maps between minified or transformed code received by the browser and its original unmodified form, allowing the original code to be reconstructed and used when debugging. + +The JavaScript code executed by the browser has often been transformed in some way from the original source created by a developer. +For example, sources are often combined and minified to make delivering them from the server more efficient. +Additionally, JavaScript running on a page is often machine-generated, such as compiled from a language like TypeScript. + +In these situations, debugging the original source is much easier than the source in the transformed state that the browser has downloaded. + +## See also + +- HTTP {{HTTPHeader("SourceMap")}} response header +- [Firefox Developer Tools: using a source map](https://firefox-source-docs.mozilla.org/devtools-user/debugger/how_to/use_a_source_map/index.html) diff --git a/files/en-us/web/api/ndefrecord/lang/index.md b/files/en-us/web/api/ndefrecord/lang/index.md index cc3d251e4df4f92..5c8bad51daa18d0 100644 --- a/files/en-us/web/api/ndefrecord/lang/index.md +++ b/files/en-us/web/api/ndefrecord/lang/index.md @@ -38,4 +38,4 @@ A string. ## See also - [HTML `lang` attribute](/en-US/docs/Web/HTML/Global_attributes/lang), that declares content language of the document or its elements -- HTTP headers that declare content language: {{HTTPHeader("Content-Language")}} and {{HTTPHEader("Accept-Language")}} +- HTTP headers that declare content language: {{HTTPHeader("Content-Language")}} and {{HTTPHeader("Accept-Language")}} diff --git a/files/en-us/web/http/headers/connection/index.md b/files/en-us/web/http/headers/connection/index.md index b62442b25de24a6..f803c8c88cf919d 100644 --- a/files/en-us/web/http/headers/connection/index.md +++ b/files/en-us/web/http/headers/connection/index.md @@ -70,3 +70,8 @@ Connection: close ## Browser compatibility {{Compat}} + +## See also + +- [Connection management in HTTP/1.x](/en-US/docs/Web/HTTP/Connection_management_in_HTTP_1.x) +- [Protocol upgrade mechanism](/en-US/docs/Web/HTTP/Protocol_upgrade_mechanism) diff --git a/files/en-us/web/http/headers/forwarded/index.md b/files/en-us/web/http/headers/forwarded/index.md index c3b77f6a946f8d9..54cfbe9fc55a142 100644 --- a/files/en-us/web/http/headers/forwarded/index.md +++ b/files/en-us/web/http/headers/forwarded/index.md @@ -14,7 +14,7 @@ The header is optional and may be added to, modified, or removed, by any of the This header is used for debugging, statistics, and generating location-dependent content. By design, it exposes privacy sensitive information, such as the IP address of the client. -Therefore, the user's privacy must be kept in mind when deploying this header. +Therefore, the user's privacy must be kept in mind when using this header. The alternative and de-facto standard versions of this header are the {{HTTPHeader("X-Forwarded-For")}}, {{HTTPHeader("X-Forwarded-Host")}} and {{HTTPHeader("X-Forwarded-Proto")}} headers. diff --git a/files/en-us/web/http/headers/index.md b/files/en-us/web/http/headers/index.md index 80930c93da6f119..648da5763cf0ce0 100644 --- a/files/en-us/web/http/headers/index.md +++ b/files/en-us/web/http/headers/index.md @@ -316,7 +316,7 @@ Headers used by the [WebSockets API](/en-US/docs/Web/API/WebSockets_API) in the - `Service-Worker-Allowed` - : Used to remove the [path restriction](/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers#why_is_my_service_worker_failing_to_register) by including this header [in the response of the Service Worker script](https://w3c.github.io/ServiceWorker/#service-worker-script-response). - {{HTTPHeader("SourceMap")}} - - : Links generated code to a [source map](https://firefox-source-docs.mozilla.org/devtools-user/debugger/how_to/use_a_source_map/index.html). + - : Links to a {{Glossary("source map")}} so that debuggers can step through original source code instead of generated or transformed code. - {{HTTPHeader("Upgrade")}} - : This HTTP/1.1 (only) header can be used to upgrade an already established client/server connection to a different protocol (over the same transport protocol). For example, it can be used by a client to upgrade a connection from HTTP 1.1 to HTTP 2.0, or an HTTP or HTTPS connection into a WebSocket. - {{HTTPHeader("Priority")}} diff --git a/files/en-us/web/http/headers/no-vary-search/index.md b/files/en-us/web/http/headers/no-vary-search/index.md index d27f5187efdc27f..a2ab1fe58514c7b 100644 --- a/files/en-us/web/http/headers/no-vary-search/index.md +++ b/files/en-us/web/http/headers/no-vary-search/index.md @@ -132,3 +132,7 @@ No-Vary-Search: params, except=("id") ## Browser compatibility {{Compat}} + +## See also + +- [HTTP Caching: Vary](/en-US/docs/Web/HTTP/Caching#vary) and {{HTTPHeader("Vary")}} header diff --git a/files/en-us/web/http/headers/origin-agent-cluster/index.md b/files/en-us/web/http/headers/origin-agent-cluster/index.md index 2ba3eee931ee8b0..39a4819381e58c0 100644 --- a/files/en-us/web/http/headers/origin-agent-cluster/index.md +++ b/files/en-us/web/http/headers/origin-agent-cluster/index.md @@ -9,10 +9,37 @@ browser-compat: http.headers.Origin-Agent-Cluster {{HTTPSidebar}}{{SeeCompatTable}} -The HTTP **`Origin-Agent-Cluster`** {{Glossary("response header")}} is used to request that the associated {{domxref("Document")}} should be placed in an _origin-keyed [agent cluster](https://tc39.es/ecma262/#sec-agent-clusters)_. This means that operating system resources (for example, the operating system process) used to evaluate the document should be shared only with other documents from the same {{glossary("origin")}}. +The HTTP **`Origin-Agent-Cluster`** {{Glossary("response header")}} is used to request that the associated {{domxref("Document")}} should be placed in an **origin-keyed [agent cluster](https://tc39.es/ecma262/#sec-agent-clusters)**. This means that operating system resources (for example, the operating system process) used to evaluate the document should be shared only with other documents from the same {{glossary("origin")}}. The effect of this is that a resource-intensive document will be less likely to degrade the performance of documents from other origins. + + + + + + + + + + + +
Header type{{Glossary("Response header")}}
{{Glossary("Forbidden header name")}}No
+ +## Syntax + +```http +Origin-Agent-Cluster: +``` + +### Directives + +- `` + - : `?1` indicates that the associated {{domxref("Document")}} should be placed in an origin-keyed agent cluster. + Values other than `?1` are ignored (e.g., the `?0` structured field for false). + +## Description + Modern web browsers have a multiprocess architecture in which pages from different origins can run in different operating system processes. This is important for performance, because it means that a resource-intensive page will not have as much of an impact on other pages that the user has open. However, browsers can't as a general rule run {{glossary("site", "same-site")}}, {{glossary("origin", "cross-origin")}} pages in different processes, because of certain DOM APIs that depend on same-site, cross-origin communication. For example, by default, pages from the following two origins will share the same operating system resources: @@ -41,31 +68,6 @@ The browser will ensure that all pages from a given origin are either origin-key To avoid this kind of unpredictable situation, you should set this header for all pages from a given origin, or none of them. - - - - - - - - - - - -
Header type{{Glossary("Response header")}}
{{Glossary("Forbidden header name")}}No
- -## Syntax - -```http -Origin-Agent-Cluster: -``` - -### Directives - -- `` - - : `?1` indicates that the associated {{domxref("Document")}} should be placed in an origin-keyed agent cluster. - Values other than `?1` are ignored (e.g., the `?0` structured field for false). - ## Examples ```http diff --git a/files/en-us/web/http/headers/permissions-policy/index.md b/files/en-us/web/http/headers/permissions-policy/index.md index 28e50ce5bc5b3c6..09a8e6b7b234846 100644 --- a/files/en-us/web/http/headers/permissions-policy/index.md +++ b/files/en-us/web/http/headers/permissions-policy/index.md @@ -38,16 +38,22 @@ Permissions-Policy: = - : An allowlist is a list of origins that takes one or more of the following values contained in parentheses, separated by spaces: - - `*`: The feature will be allowed in this document, and all nested browsing contexts (`