diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml index 3f9704d355475fb..fee9351f939bf2f 100644 --- a/.github/workflows/markdown-lint.yml +++ b/.github/workflows/markdown-lint.yml @@ -7,6 +7,7 @@ on: paths: - .markdownlint-cli2.jsonc - .nvmrc + - .prettier* - package.json - yarn.lock - .github/workflows/markdown-lint.yml diff --git a/.github/workflows/pr-check_markdownlint.yml b/.github/workflows/pr-check_markdownlint.yml index ec21082e0b97b32..b1beaae2c76c048 100644 --- a/.github/workflows/pr-check_markdownlint.yml +++ b/.github/workflows/pr-check_markdownlint.yml @@ -45,3 +45,8 @@ jobs: yarn markdownlint-cli2 ${files_to_lint} echo "Linting front-matter" node scripts/front-matter_linter.js ${files_to_lint} + + - name: Prettier markdown files + run: | + files_to_lint="${{ env.DIFF_DOCUMENTS }}" + yarn prettier -c ${files_to_lint} diff --git a/.prettierignore b/.prettierignore index 6393e7dad90969e..922b3c1044f3abb 100644 --- a/.prettierignore +++ b/.prettierignore @@ -10,4 +10,3 @@ build/ /files/en-us/mozilla/add-ons/**/*.md /files/en-us/web/html/**/*.md /files/en-us/web/javascript/**/*.md -/files/en-us/web/web_components/**/*.md diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index a2080e7a65f85c7..711190614423dcb 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -3667,7 +3667,6 @@ /en-US/docs/HTML/Element/acronym-redirect-1 /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML/Element/acronym2 /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML/Element/address /en-US/docs/Web/HTML/Element/address -/en-US/docs/HTML/Element/applet /en-US/docs/Web/HTML/Element/applet /en-US/docs/HTML/Element/area /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML/Element/area-redirect-1 /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML/Element/article /en-US/docs/Web/HTML/Element/article @@ -3939,7 +3938,6 @@ /en-US/docs/HTML:Element:abbr /en-US/docs/Web/HTML/Element/abbr /en-US/docs/HTML:Element:acronym /en-US/docs/Web/HTML/Element/acronym /en-US/docs/HTML:Element:address /en-US/docs/Web/HTML/Element/address -/en-US/docs/HTML:Element:applet /en-US/docs/Web/HTML/Element/applet /en-US/docs/HTML:Element:area /en-US/docs/Web/HTML/Element/area /en-US/docs/HTML:Element:b /en-US/docs/Web/HTML/Element/b /en-US/docs/HTML:Element:base /en-US/docs/Web/HTML/Element/base @@ -11854,6 +11852,7 @@ /en-US/docs/Web/Guide/API/DOM/Events/Creating_and_triggering_events /en-US/docs/Web/Events/Creating_and_triggering_events /en-US/docs/Web/Guide/API/DOM/Events/Event_dispatching_example /en-US/docs/Web/Events/Creating_and_triggering_events /en-US/docs/Web/Guide/API/DOM/Events/Event_handlers /en-US/docs/Web/Events/Event_handlers +/en-US/docs/Web/Guide/API/DOM/Events/Mutation_events /en-US/docs/Web/API/MutationEvent /en-US/docs/Web/Guide/API/DOM/Events/Orientation_and_motion_data_explained /en-US/docs/Web/API/Device_orientation_events/Orientation_and_motion_data_explained /en-US/docs/Web/Guide/API/DOM/Events/Touch_events /en-US/docs/Web/API/Touch_events /en-US/docs/Web/Guide/API/DOM/Events/Touch_events_(Mozilla_experimental) /en-US/docs/Web/API/Touch_events @@ -12073,6 +12072,7 @@ /en-US/docs/Web/HTML/Forms_in_HTML /en-US/docs/Learn/Forms /en-US/docs/Web/HTML/Index /en-US/docs/Web/HTML /en-US/docs/Web/HTML/Inline_elemente /en-US/docs/Glossary/Inline-level_content +/en-US/docs/Web/HTML/Inline_elements /en-US/docs/Glossary/Inline-level_content /en-US/docs/Web/HTML/Inline_elmements /en-US/docs/Glossary/Inline-level_content /en-US/docs/Web/HTML/Introduction /en-US/docs/Learn/HTML/Introduction_to_HTML /en-US/docs/Web/HTML/Kinds_of_HTML_content /en-US/docs/Web/HTML/Content_categories diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json index f23186d95301bfc..b48c52b12ee358e 100644 --- a/files/en-us/_wikihistory.json +++ b/files/en-us/_wikihistory.json @@ -94100,34 +94100,6 @@ "alecananian" ] }, - "Web/HTML/Element/applet": { - "modified": "2020-10-15T21:12:10.376Z", - "contributors": [ - "alattalatta", - "sideshowbarker", - "ddbeck", - "mfuji09", - "ExE-Boss", - "Sheppy", - "teoli", - "mfluehr", - "chrisdavidmills", - "erikadoyle", - "brunoais", - "kscarfone", - "ethertank", - "tregagnon", - "avsaro", - "cers", - "fscholz", - "osdm", - "Taken", - "Ptak82", - "Um4Sm1", - "Witia", - "PablO" - ] - }, "Web/HTML/Element/area": { "modified": "2020-11-09T11:29:48.831Z", "contributors": [ @@ -126782,10 +126754,6 @@ "Manuel_Strehl" ] }, - "Web/SVG/Element/discard": { - "modified": "2020-10-15T21:49:16.314Z", - "contributors": ["Tigt", "fscholz", "Sebastianz"] - }, "Web/SVG/Element/ellipse": { "modified": "2020-10-15T21:11:04.607Z", "contributors": [ diff --git a/files/en-us/glossary/block-level_content/index.md b/files/en-us/glossary/block-level_content/index.md index 77643b1d182e300..8cda2cfc4d54f9f 100644 --- a/files/en-us/glossary/block-level_content/index.md +++ b/files/en-us/glossary/block-level_content/index.md @@ -9,7 +9,7 @@ In CSS, content that participates in block layout is called **block-level conten In a block layout, boxes are laid out one after the other, vertically, beginning at the top of a containing block. Each box's left outer edge touches the left edge of the containing block.\ A block-level element always starts on a new line. In horizontal writing modes, like English or Arabic, it occupies the entire horizontal space of its parent element (container) and vertical space equal to the height of its contents, thereby creating a "block". -> **Note:** The above behaviour of block layout changes if the containing block's [`writing-mode`](/en-US/docs/Web/CSS/writing-mode) is set to value other than [the default value](/en-US/docs/Web/CSS/writing-mode#formal_definition). +> **Note:** The above behavior of block layout changes if the containing block's [`writing-mode`](/en-US/docs/Web/CSS/writing-mode) is set to value other than [the default value](/en-US/docs/Web/CSS/writing-mode#formal_definition). > **Note:** HTML (_HyperText Markup Language_) elements historically were categorized as either "block-level" elements or "inline" elements. As a presentational characteristic, this is now specified by CSS. diff --git a/files/en-us/glossary/endianness/index.md b/files/en-us/glossary/endianness/index.md index c8a715744c777f4..01139698d34ddb7 100644 --- a/files/en-us/glossary/endianness/index.md +++ b/files/en-us/glossary/endianness/index.md @@ -14,7 +14,7 @@ Examples with the number `0x12345678` (i.e. 305 419 896 in decimal): - _little-endian_: `0x78 0x56 0x34 0x12` - _big-endian_: `0x12 0x34 0x56 0x78` -- _mixed-endian_ (historic and very rare): `0x34 0x12 0x78 0x56`<- +- _mixed-endian_ (historic and very rare): `0x34 0x12 0x78 0x56` ## See also diff --git a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md index 49dec5043a94518..4cfac3f6075bbc9 100644 --- a/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md +++ b/files/en-us/learn/getting_started_with_the_web/what_will_your_website_look_like/index.md @@ -60,10 +60,15 @@ Note that most images on the web, including in Google Images, are copyrighted. T ### Font -To choose a font: +As with images, many fonts are protected by licenses, meaning you cannot freely use them in your site. [Google Fonts](https://developers.google.com/fonts) is a web service owned by Google that provides access to many fonts. -1. Go to [Google Fonts](https://fonts.google.com/) and find one you like. -2. Copy the lines of code Google gives you into your text editor to save for later. -3. For more details about using Google Fonts, see [this page](https://developers.google.com/fonts/docs/getting_started) +Once you have found a font, there are two main ways of using it: + +1. Add a reference in your code to load the font from Google's servers. +2. Download the font file to your own system, host the font yourself, and use your hosted copy in your website's code. + +> **Note:** Serving fonts hosted on Google Fonts may be incompatible with the European Union's data privacy regulation [GDPR](https://gdpr.eu/what-is-gdpr/) as the font service exposes the user's IP address. If this is a potential problem for you, choose the second option. + +Alternatively you can use [safe web fonts](https://web.mit.edu/jmorzins/www/fonts.html) such as Arial, Times New Roman, or Courier New. {{PreviousMenuNext("Learn/Getting_started_with_the_web/Installing_basic_software", "Learn/Getting_started_with_the_web/Dealing_with_files", "Learn/Getting_started_with_the_web")}} diff --git a/files/en-us/learn/html/tables/basics/index.md b/files/en-us/learn/html/tables/basics/index.md index 9ca887bcb710e14..0be332fd1f24233 100644 --- a/files/en-us/learn/html/tables/basics/index.md +++ b/files/en-us/learn/html/tables/basics/index.md @@ -203,7 +203,7 @@ td { } ``` -{{EmbedLiveSample("How_does_a_table_work", 100, 460)}} +{{EmbedLiveSample("How_does_a_table_work", 100, 560)}} When implemented correctly, HTML tables are handled well by accessibility tools such as screen readers, so a successful HTML table should enhance the experience of sighted and visually impaired users alike. @@ -526,7 +526,7 @@ Now it's time to have a go yourself. Below you can see the timetable of a languages teacher. On Friday she has a new class teaching Dutch all day, but she also teaches German for a few periods on Tuesday and Thursdays. She wants to highlight the columns containing the days she is teaching. -{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 320)}} +{{EmbedGHLiveSample("learning-area/html/tables/basic/timetable-fixed.html", '100%', 350)}} Recreate the table by following the steps below. diff --git a/files/en-us/learn/javascript/building_blocks/functions/index.md b/files/en-us/learn/javascript/building_blocks/functions/index.md index 6a9466ead75b034..d75460fab98efb1 100644 --- a/files/en-us/learn/javascript/building_blocks/functions/index.md +++ b/files/en-us/learn/javascript/building_blocks/functions/index.md @@ -234,23 +234,15 @@ textBox.addEventListener("keydown", (event) => { }); ``` -If the function only has one line in the curly brackets, you omit the curly brackets: +If the function only takes one parameter, you can omit the brackets around the parameter: -```js -textBox.addEventListener("keydown", (event) => - console.log(`You pressed "${event.key}".`) -); -``` - -If the function only takes one parameter, you can also omit the brackets around the parameter: - -```js -textBox.addEventListener("keydown", (event) => - console.log(`You pressed "${event.key}".`) -); +```js-nolint +textBox.addEventListener("keydown", event => { + console.log(`You pressed "${event.key}".`); +}); ``` -Finally, if your function needs to return a value, and contains only one line, you can also omit the `return` statement. In the following example we're using the {{jsxref("Array.prototype.map()","map()")}} method of `Array` to double every value in the original array: +Finally, if your function contains only one line that's a `return` statement, you can also omit the braces and the `return` keyword, and implicitly return the expression. In the following example we're using the {{jsxref("Array.prototype.map()","map()")}} method of `Array` to double every value in the original array: ```js const originals = [1, 2, 3]; @@ -270,6 +262,16 @@ function doubleItem(item) { } ``` +You can use the same concise syntax to rewrite the `addEventListener` example. + +```js +textBox.addEventListener("keydown", (event) => + console.log(`You pressed "${event.key}".`) +); +``` + +In this case, the value of `console.log()`, which is `undefined`, is implicitly returned from the callback function. + We recommend that you use arrow functions, as they can make your code shorter and more readable. To learn more, see the [section on arrow functions in the JavaScript guide](/en-US/docs/Web/JavaScript/Guide/Functions#arrow_functions), and our [reference page on arrow functions](/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions). > **Note:** There are some subtle differences between arrow functions and normal functions. They're outside the scope of this introductory guide, and are unlikely to make a difference in the cases we've discussed here. To learn more, see the [arrow function reference documentation](/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions). diff --git a/files/en-us/learn/javascript/first_steps/strings/index.md b/files/en-us/learn/javascript/first_steps/strings/index.md index 5d9b577a6a49e2b..8fd94a249943470 100644 --- a/files/en-us/learn/javascript/first_steps/strings/index.md +++ b/files/en-us/learn/javascript/first_steps/strings/index.md @@ -106,7 +106,7 @@ const bigmouth = 'I\'ve got no right to take my place…'; console.log(bigmouth); ``` -This works fine. You can escape other characters in the same way, e.g. `\"`, and there are some special codes besides. See [Escape sequences](/en-US/docs/Web/JavaScript/Reference/Global_Objects/String#escape_sequences) for more details. +This works fine. You can escape other characters in the same way, e.g. `\"`, and there are some special codes besides. See [Escape sequences](/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#escape_sequences) for more details. ## Concatenating strings diff --git a/files/en-us/learn/server-side/apache_configuration_htaccess/index.md b/files/en-us/learn/server-side/apache_configuration_htaccess/index.md index cd39f9705664472..0a28c07b56da01a 100644 --- a/files/en-us/learn/server-side/apache_configuration_htaccess/index.md +++ b/files/en-us/learn/server-side/apache_configuration_htaccess/index.md @@ -19,7 +19,7 @@ Most of the following blocks use the [IfModule](https://httpd.apache.org/docs/2. There are times when we need to tell users that a resource has moved, either temporarily or permanently. This is what we use `Redirect` and `RedirectMatch` for. -```apache +```apacheconf # Redirect to a URL on a different host Redirect "/service" "http://foo2.example.com/service" @@ -60,7 +60,7 @@ For security reasons, browsers restrict cross-origin HTTP requests initiated fro This directive will add the CORS header for all resources in the directory from any website. -```apache +```apacheconf Header set Access-Control-Allow-Origin "*" @@ -70,7 +70,7 @@ Unless you override the directive later in the configuration or in the configura One alternative is to explicitly state what domains have access to the content of your site. In the example below, we restrict access to a subdomain of our main site (example.com). This is more secure and, likely, what you intended to do. -```apache +```apacheconf Header set Access-Control-Allow-Origin "subdomain.example.com" @@ -82,7 +82,7 @@ As reported in the [Chromium Blog](https://blog.chromium.org/2011/07/using-cross To mitigate the possibility of these attacks, you should use the `crossorigin` attribute in the images you request and the code snippet below in your `.htaccess` to set the CORS header from the server. -```apache +```apacheconf @@ -95,7 +95,7 @@ To mitigate the possibility of these attacks, you should use the `crossorigin` a Google Chrome's [Google Fonts troubleshooting guide](https://developers.google.com/fonts/docs/troubleshooting) tells us that, while Google Fonts may send the CORS header with every response, some proxy servers may strip it before the browser can use it to render the font. -```apache +```apacheconf Header set Access-Control-Allow-Origin "*" @@ -111,7 +111,7 @@ The [Timing-Allow-Origin](/en-US/docs/Web/HTTP/Headers/Timing-Allow-Origin) resp If a resource isn't served with a `Timing-Allow-Origin` or if the header does not include the origin, after making the request some attributes of the `PerformanceResourceTiming` object will be set to zero. -```apache +```apacheconf Header set Timing-Allow-Origin: "*" @@ -125,7 +125,7 @@ The error pages are presented as URLs. These URLs can begin with a slash (/) for See the [ErrorDocument Directive](https://httpd.apache.org/docs/current/mod/core.html#errordocument) documentation on the HTTPD documentation site for more information. -```apache +```apacheconf ErrorDocument 500 /errors/500.html ErrorDocument 404 /errors/400.html ErrorDocument 401 https://example.com/subscription_info.html @@ -140,7 +140,7 @@ The effect of `MultiViews` is as follows: if the server receives a request for / The setting disables `MultiViews` for the directory this configuration applies to and prevents Apache from returning a 404 error as the result of a rewrite when the directory with the same name does not exist -```apache +```apacheconf Options -MultiViews ``` @@ -158,7 +158,7 @@ Associates media types with one or more extensions to make sure the resources wi Servers should use text/javascript for JavaScript resources as indicated in the [HTML specification](https://html.spec.whatwg.org/multipage/scripting.html#scriptingLanguages) -```apache +```apacheconf # Data interchange AddType application/atom+xml atom @@ -224,7 +224,7 @@ Every piece of content on the web has a character set. Most, if not all, the con Use [AddDefaultCharset](https://httpd.apache.org/docs/current/mod/core.html#adddefaultcharset) to serve all resources labeled as `text/html` or `text/plain` with the `UTF-8` charset. -```apache +```apacheconf AddDefaultCharset utf-8 @@ -234,7 +234,7 @@ Use [AddDefaultCharset](https://httpd.apache.org/docs/current/mod/core.html#addd Serve the following file types with the `charset` parameter set to `UTF-8` using the [AddCharset](https://httpd.apache.org/docs/current/mod/mod_mime.html#addcharset) directive available in `mod_mime`. -```apache +```apacheconf AddCharset utf-8 .appcache \ .bbaw \ @@ -277,7 +277,7 @@ The required steps are: - See [Rackspace FAQ](https://web.archive.org/web/20151223141222/http://www.rackspace.com/knowledge_center/frequently-asked-question/why-is-modrewrite-not-working-on-my-site) and the [HTTPD documentation](https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritebase) - Depending on how your server is set up, you may also need to use the [`RewriteOptions`](https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewriteoptions) directive to enable some options for the rewrite engine -```apache +```apacheconf RewriteEngine On Options +FollowSymlinks @@ -291,7 +291,7 @@ The required steps are: These Rewrite rules will redirect from the `http://` insecure version to the `https://` secure version of the URL as described in the [Apache HTTPD wiki](https://cwiki.apache.org/confluence/display/httpd/RewriteHTTPToHTTPS). -```apache +```apacheconf RewriteEngine On RewriteCond %{HTTPS} !=on @@ -301,7 +301,7 @@ These Rewrite rules will redirect from the `http://` insecure version to the `ht If you're using cPanel AutoSSL or the Let's Encrypt webroot method to create your SSL certificates, it will fail to validate the certificate if validation requests are redirected to HTTPS. Turn on the condition(s) you need. -```apache +```apacheconf RewriteEngine On RewriteCond %{HTTPS} !=on @@ -322,7 +322,7 @@ Set `%{ENV:PROTO}` variable, to allow rewrites to redirect with the appropriate The rule assumes by default that both HTTP and HTTPS environments are available for redirection. -```apache +```apacheconf RewriteEngine On RewriteCond %{HTTPS} =on @@ -347,7 +347,7 @@ The rule assumes by default that both HTTP and HTTPS environments are available The following might not be a good idea if you use "real" subdomains for certain parts of your website. -```apache +```apacheconf RewriteEngine On RewriteCond %{HTTPS} =on @@ -374,7 +374,7 @@ While you could send the `X-Frame-Options` header for all of your website's page Nonetheless, you should ensure that you send the `X-Frame-Options` header for all pages that allow a user to make a state-changing operation (e.g., pages that contain one-click purchase links, checkout, or bank-transfer confirmation pages, pages that make permanent configuration changes, etc.). -```apache +```apacheconf Header always set X-Frame-Options "DENY" "expr=%{CONTENT_TYPE} =~ m#text/html#i" @@ -390,7 +390,7 @@ The example policy below: To make your CSP implementation easier, you can use an online [CSP header generator](https://report-uri.com/home/generate/). You should also use a [validator](https://csp-evaluator.withgoogle.com) to make sure your header does what you want it to do. -```apache +```apacheconf Content-Security-Policy "default-src 'self'; base-uri 'none'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests" "expr=%{CONTENT_TYPE} =~ m#text\/(html|javascript)|application\/pdf|xml#i" @@ -400,7 +400,7 @@ To make your CSP implementation easier, you can use an online [CSP header genera This directive will prevent access to directories that don't have an index file present in whatever format the server is configured to use, like `index.html`, or `index.php`. -```apache +```apacheconf Options -Indexes @@ -412,7 +412,7 @@ In Macintosh and Linux systems, files that begin with a period are hidden from v The `.well-known/` directory represents [the standard (RFC 5785)](https://datatracker.ietf.org/doc/html/rfc5785) path prefix for "well-known locations" (e.g.: `/.well-known/manifest.json`, `/.well-known/keybase.txt`), and therefore, access to its visible content should not be blocked. -```apache +```apacheconf RewriteEngine On RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC] @@ -428,7 +428,7 @@ Block access to backup and source files that may be left by some text editors an Update the `` regular expression in the following example to include any files that might end up on your production server and can expose sensitive information about your website. These files may include: configuration files or files that contain metadata about the project among others. -```apache +```apacheconf Require all denied @@ -444,7 +444,7 @@ The following header ensures that a browser only connects to your server via HTT Be aware that Strict Transport Security is not revokable, and you must ensure being able to serve the site over HTTPS for as long as you've specified in the `max-age` directive. If you don't have a valid TLS connection anymore (e.g. due to an expired TLS certificate) your visitors will see an error message even when attempting to connect over HTTP. -```apache +```apacheconf # Header always set Strict-Transport-Security "max-age=16070400; includeSubDomains" "expr=%{HTTPS} == 'on'" @@ -479,7 +479,7 @@ Be aware that Strict Transport Security is not revokable, and you must ensure be Some older browsers would try and guess the content type of a resource, even when it isn't properly set up on the server configuration. This reduces exposure to drive-by download attacks and cross-origin data leaks. -```apache +```apacheconf Header always set X-Content-Type-Options "nosniff" @@ -498,7 +498,7 @@ Use services like the ones below to check your Referrer Policy: - [securityheaders.com](https://securityheaders.com/) - [Mozilla Observatory](https://observatory.mozilla.org/) -```apache +```apacheconf Header always set Referrer-Policy "strict-origin-when-cross-origin" "expr=%{CONTENT_TYPE} =~ m#text\/(css|html|javascript)|application\/pdf|xml#i" @@ -512,7 +512,7 @@ Modern browsers now prevent TRACE requests made via JavaScript, however, other w If you have access to the main server configuration file, use the [`TraceEnable`](https://httpd.apache.org/docs/current/mod/core.html#traceenable) directive instead. -```apache +```apacheconf RewriteEngine On RewriteCond %{REQUEST_METHOD} ^TRACE [NC] @@ -526,7 +526,7 @@ Some frameworks like PHP and ASP.NET set an `X-Powered-By` header that contains This header doesn't provide any value, and in some cases, the information it provides can expose vulnerabilities -```apache +```apacheconf Header unset X-Powered-By Header always unset X-Powered-By @@ -543,7 +543,7 @@ expose_php = off; Prevent Apache from adding a trailing footer line containing information about the server to the server-generated documents (e.g.: error messages, directory listings, etc.). See [ServerSignature Directive](https://httpd.apache.org/docs/current/mod/core.html#serversignature) for more information on what the server signature provides and the [ServerTokens Directive](https://httpd.apache.org/docs/current/mod/core.html#servertokens) for information about configuring the information provided in the signature. -```apache +```apacheconf ServerSignature Off ``` @@ -551,7 +551,7 @@ ServerSignature Off Some proxies and security software mangle or strip the `Accept-Encoding` HTTP header. See [Pushing Beyond Gzipping](https://calendar.perfplanet.com/2010/pushing-beyond-gzipping/) for a more detailed explanation. -```apache +```apacheconf @@ -566,7 +566,7 @@ Some proxies and security software mangle or strip the `Accept-Encoding` HTTP he Compress all output labeled with one of the following media types using the [AddOutputFilterByType Directive](https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype). -```apache +```apacheconf AddOutputFilterByType DEFLATE "application/atom+xml" \ @@ -613,7 +613,7 @@ Compress all output labeled with one of the following media types using the [Add Map the following filename extensions to the specified encoding type using [AddEncoding](https://httpd.apache.org/docs/current/mod/mod_mime.html#addencoding) so Apache can serve the file types with the appropriate `Content-Encoding` response header (this will NOT make Apache compress them!). If these files types were served without an appropriate `Content-Encoding` response header, client applications (e.g.: browsers) wouldn't know that they first need to uncompress the response, and thus, wouldn't be able to understand the content. -```apache +```apacheconf AddEncoding gzip svgz @@ -625,7 +625,7 @@ Map the following filename extensions to the specified encoding type using [AddE Serve resources with a far-future expiration date using the [mod_expires](https://httpd.apache.org/docs/current/mod/mod_expires.html) module, and [Cache-Control](/en-US/docs/Web/HTTP/Headers/Cache-Control) and [Expires](/en-US/docs/Web/HTTP/Headers/Expires) headers. -```apache +```apacheconf ExpiresActive on ExpiresDefault "access plus 1 month" diff --git a/files/en-us/learn/server-side/django/authentication/index.md b/files/en-us/learn/server-side/django/authentication/index.md index d9afe17f4a2837f..7a2a59a698d2c11 100644 --- a/files/en-us/learn/server-side/django/authentication/index.md +++ b/files/en-us/learn/server-side/django/authentication/index.md @@ -608,7 +608,7 @@ The very last step is to add a link for this new page into the sidebar. We'll pu Open the base template (**/locallibrary/catalog/templates/base_generic.html**) and add the "My Borrowed" line to the sidebar in the position shown below. -```python +```django
    {% if user.is_authenticated %}
  • User: \{{ user.get_username }}
    • @@ -656,7 +656,7 @@ Open the **catalog/models.py**, and add the permission as shown above. You will The current user's permissions are stored in a template variable called `\{{ perms }}`. You can check whether the current user has a particular permission using the specific variable name within the associated Django "app" — e.g. `\{{ perms.catalog.can_mark_returned }}` will be `True` if the user has this permission, and `False` otherwise. We typically test for the permission using the template `{% if %}` tag as shown: -```python +```django {% if perms.catalog.can_mark_returned %} diff --git a/files/en-us/learn/server-side/express_nodejs/mongoose/index.md b/files/en-us/learn/server-side/express_nodejs/mongoose/index.md index 64c17861be9dbf9..3351e45ae8ec640 100644 --- a/files/en-us/learn/server-side/express_nodejs/mongoose/index.md +++ b/files/en-us/learn/server-side/express_nodejs/mongoose/index.md @@ -142,16 +142,16 @@ try { ``` The asynchronous methods above are run in sequence. -If the methods don't depends on each other then you can run them in parallel and finish the whole operation more quickly. +If the methods don't depend on each other then you can run them in parallel and finish the whole operation more quickly. This done using the [`Promise.all()`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/all) method, which takes an iterable of promises as input and returns a single `Promise`. This returned promise fulfills when all of the input's promises fulfill, with an array of the fulfillment values. It rejects when any of the input's promises rejects, with this first rejection reason. The code below shows how this works. -First we have two functions that return promises. -We `await` on both of them to compete using the promise returned by `Promise.all()`. -Once they both complete `await` returns and the results array is populated. -The function then continues to the next `await`, and waits until the promise returned by `anotherFunctionThatReturnsPromise()` is settled. +First, we have two functions that return promises. +We `await` on both of them to complete using the promise returned by `Promise.all()`. +Once they both complete `await` returns and the results array is populated, +the function then continues to the next `await`, and waits until the promise returned by `anotherFunctionThatReturnsPromise()` is settled. You would call the `myFunction()` in a `try...catch` block to catch any errors. ```js @@ -705,9 +705,7 @@ AuthorSchema.virtual("name").get(function () { if (this.first_name && this.family_name) { fullname = `${this.family_name}, ${this.first_name}`; } - if (!this.first_name || !this.family_name) { - fullname = ""; - } + return fullname; }); diff --git a/files/en-us/learn/server-side/first_steps/web_frameworks/index.md b/files/en-us/learn/server-side/first_steps/web_frameworks/index.md index c99bee0e88347f6..f06ac77301f02d4 100644 --- a/files/en-us/learn/server-side/first_steps/web_frameworks/index.md +++ b/files/en-us/learn/server-side/first_steps/web_frameworks/index.md @@ -137,7 +137,7 @@ def youngest(request): ### Rendering data -Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of document. +Web frameworks often provide templating systems. These allow you to specify the structure of an output document, using placeholders for data that will be added when a page is generated. Templates are often used to create HTML, but can also create other types of documents. Web frameworks often provide a mechanism to make it easy to generate other formats from stored data, including {{glossary("JSON")}} and {{glossary("XML")}}. diff --git a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/introduction/index.md b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/introduction/index.md index 3064b399c602a59..fdc295b83eb325d 100644 --- a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/introduction/index.md +++ b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/introduction/index.md @@ -206,7 +206,7 @@ The most essential feature of the web is that it allows users to navigate from o Modern web applications typically do not fetch and render new HTML files — they load a single HTML shell, and continually update the DOM inside it (referred to as **single page apps**, or **SPAs**) without navigating users to new addresses on the web. Each new pseudo-webpage is usually called a _view_, and by default, no routing is done. -When a SPA is complex enough, and renders enough unique views, it's important to bring routing functionality into your application. People are used to being able to link to specific pages in an application, travel forward and backward in their navigation history, etc., and their experience suffers when these standard web features are broken. When routing is handled by a client application in this fashion, it is aptly called **client-side routing**. +When an SPA is complex enough, and renders enough unique views, it's important to bring routing functionality into your application. People are used to being able to link to specific pages in an application, travel forward and backward in their navigation history, etc., and their experience suffers when these standard web features are broken. When routing is handled by a client application in this fashion, it is aptly called **client-side routing**. It's _possible_ to make a router using the native capabilities of JavaScript and the browser, but popular, actively developed frameworks have companion libraries that make routing a more intuitive part of the development process. @@ -228,7 +228,7 @@ Frameworks allow you to write more declarative code – and sometimes _less_ cod Some extra code is inevitable, and a framework that supports tree-shaking (removal of any code that isn't actually used in the app during the build process) will allow you to keep your applications small, but this is still a factor you need to keep in mind when considering your app's performance, especially on more network/storage-constrained devices, like mobile phones. -The abstraction of frameworks affects not only your JavaScript but your relationship with the very nature of the web. No matter how you build for the web, the end result, the layer that your users ultimately interact with, is HTML. Writing your whole application in JavaScript can make you lose sight of HTML and the purpose of its various tags, and lead you to produce an HTML document that is un-semantic and inaccessible. In fact, it's possible to write a fragile application that depends entirely on JavaScript and will not function without it. +The abstraction of frameworks affects not only your JavaScript, but also your relationship with the very nature of the web. No matter how you build for the web, the end result, the layer that your users ultimately interact with, is HTML. Writing your whole application in JavaScript can make you lose sight of HTML and the purpose of its various tags, and lead you to produce an HTML document that is un-semantic and inaccessible. In fact, it's possible to write a fragile application that depends entirely on JavaScript and will not function without it. Frameworks are not the source of our problems. With the wrong priorities, any application can be fragile, bloated, and inaccessible. Frameworks do, however, amplify our priorities as developers. If your priority is to make a complex web app, it's easy to do that. However, if your priorities don't carefully guard performance and accessibility, frameworks will amplify your fragility, your bloat, and your inaccessibility. Modern developer priorities, amplified by frameworks, have inverted the structure of the web in many places. Instead of a robust, content-first network of documents, the web now often puts JavaScript first and user experience last. diff --git a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/react_resources/index.md b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/react_resources/index.md index 41e855a288c7afc..77389d4b5248fb8 100644 --- a/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/react_resources/index.md +++ b/files/en-us/learn/tools_and_testing/client-side_javascript_frameworks/react_resources/index.md @@ -91,7 +91,7 @@ Although this tutorial doesn't mention them, it is possible to build React compo ## Routing -While routing is traditionally handled by a server and not an application on the user's computer, it is possible to configure a web application to read and update the browser's location, and render certain user interfaces. This is called client-side routing. It's possible to create many unique routes for your application (such as `/home`, `/dashboard`, or `login/`). +While routing is traditionally handled by a server and not an application on the user's computer, it is possible to configure a web application to read and update the browser's location, and render certain user interfaces. This is called client-side routing. It's possible to create many unique routes for your application (such as `/home`, `/dashboard`, or `/login`). The React community has produced two major libraries for client-side routing: [React Router](https://reactrouter.com/) and [Reach Router](https://reach.tech/router/). diff --git a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md index ae1d935a57b2c7d..3fbc32dd72c94ec 100644 --- a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md +++ b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md @@ -52,7 +52,7 @@ Make sure that the opening paragraph(s) before the first heading adequately summ In a guide or tutorial, the introductory paragraph(s) should inform the reader about the topics that will be covered as well as the prerequisite knowledge the reader is expected to have, if any. The opening paragraph should mention the technologies and/or APIs that are being documented or discussed, with links to the related information, and it should offer hints to situations in which the article's contents might be useful. -- **Example of short introduction** This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth. +- **Example of short introduction**: This example of an introduction is far too short. It leaves out too much information, such as what it means exactly to "stroke" text, where the text is drawn, and so forth. > **`CanvasRenderingContext2D.strokeText()`** draws a string. diff --git a/files/en-us/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md b/files/en-us/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md index dd9c0cb6beadab7..d532e925a27ccfc 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/cookies/cookiestore/index.md @@ -9,7 +9,9 @@ browser-compat: webextensions.api.cookies.CookieStore The `CookieStore` type of the {{WebExtAPIRef("cookies")}} API represents a cookie store in the browser. -Windows in different browsing modes may use different cookie stores — a private browsing/incognito mode window, for instance, will use a separate cookie store from a non-incognito/private window. +Windows in different browsing modes may use different cookie stores. For example, a private browsing/incognito mode window uses a separate cookie store from a non-incognito/private window. Also, a window may have several cookie stores when using [container tabs](https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers) in Firefox. + +See [Work with the Cookies API](/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_the_Cookies_API#cookie_stores) for more information about cookie stores. ## Type @@ -17,8 +19,9 @@ Values of this type are objects, which can contain the following properties: - `id` - : A `string` representing the unique identifier for the cookie store. -- `incognito` +- `incognito` {{optional_inline}} - : A boolean value that indicates whether this is an incognito cookie store. + This property is not supported in Chrome or Safari. However, you can identify incognito cookie stores in Chrome because their `id` is always "1". - `tabIds` - : An `array` of `integers`, which identifies all of the browser tabs that share this cookie store. diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/dynamic_ruleset_id/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/dynamic_ruleset_id/index.md index b02618845cbbd2b..0016c03c98f6b33 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/dynamic_ruleset_id/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/dynamic_ruleset_id/index.md @@ -11,7 +11,7 @@ Ruleset ID for the dynamic rules added by the extension using {{WebExtAPIRef("de Its value is `"_dynamic"`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/getmatchedrules_quota_interval/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/getmatchedrules_quota_interval/index.md index af722edd62be9c2..38a0db390d78689 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/getmatchedrules_quota_interval/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/getmatchedrules_quota_interval/index.md @@ -11,7 +11,7 @@ The time interval within which {{WebExtAPIRef("declarativeNetRequest.MAX_GETMATC Its value is `10`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/guaranteed_minimum_static_rules/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/guaranteed_minimum_static_rules/index.md index 71d83114d6ca0fd..cd9fc7787398648 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/guaranteed_minimum_static_rules/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/guaranteed_minimum_static_rules/index.md @@ -11,7 +11,7 @@ The minimum number of static rules guaranteed to an extension across its enabled Its value is `30000` on Chrome. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/index.md index c983d441cd27b43..1167ca176545ad3 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/index.md @@ -122,14 +122,18 @@ When the browser evaluates how to handle requests, it checks each extension's ru 3. "block" cancels the request. 4. "upgradeScheme" upgrades the scheme of the request. 5. "redirect" redirects the request. - 6. "modifyHeaders" rewrites request and response headers. - If this doesn't result in one rule to apply: -3. the ruleset the rule belongs to, in this order of precedence: - 1. session - 2. dynamic - 3. static - If this doesn't result in one rule to apply: -4. the order of the rule in the ruleset, determined as the lowest value rule ID. + 6. "modifyHeaders" rewrites request or response headers or both. + +> **Note:** When multiple matching rules have the same rule priority and rule action type, the outcome can be ambiguous when the matched action support additional properties. These properties can result in outcomes that cannot be combined. For example: +> +> - The "block" action does not support additional properties, and therefore there is no ambiguity: all matching "block" actions would result in the same outcome. +> - The "redirect" action redirects a request to one destination. When multiple "redirect" actions match, all but one "redirect" action is ignored. It is still possible to redirect repeatedly when the redirected request matches another rule condition. +> - Multiple "modifyHeaders" actions can be applied independently when they touch different headers. The result is ambiguous when they touch the same header, because some combination of operations are not allowed (as explained at ("declarativeNetRequest.ModifyHeaderInfo")}}). The evaluation order of "modifyHeaders" actions is therefore important. +> +> To control the order in which actions are applied, assign distinct `priority` values to rules whose order of precedence is important. + +> **Note:** After rule priority and rule action, Firefox considers the ruleset the rule belongs to, in this order of precedence: session > dynamic > session rulesets. +> This cannot be relied upon across browsers, see [WECG issue 280](https://github.com/w3c/webextensions/issues/280). If only one extension provides a rule for the request, that rule is applied. However, where more than one extension has a matching rule, the browser chooses the one to apply in this order of precedence: diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/matchedrule/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/matchedrule/index.md index c37594d6aec5b9e..49cfa5399435644 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/matchedrule/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/matchedrule/index.md @@ -23,6 +23,8 @@ Values of this type are objects. They contain these properties: - For a rule originating from the set of dynamic rules, the value defined in {{WebExtAPIRef("declarativeNetRequest.DYNAMIC_RULESET_ID")}}, i.e., `"_dynamic"`. - For a rule originating from the set of session rules, the value defined in {{WebExtAPIRef("declarativeNetRequest.SESSION_RULESET_ID")}}, i.e., `"_session"`. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_getmatchedrules_calls_per_interval/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_getmatchedrules_calls_per_interval/index.md index f0806ba520f37e4..5fdc0a3af205920 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_getmatchedrules_calls_per_interval/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_getmatchedrules_calls_per_interval/index.md @@ -11,7 +11,7 @@ The number of times {{WebExtAPIRef("declarativeNetRequest.getMatchedRules")}} ca Its value is `20`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_dynamic_and_session_rules/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_dynamic_and_session_rules/index.md index 5d46045ee29941b..8b3e9eac0de4281 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_dynamic_and_session_rules/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_dynamic_and_session_rules/index.md @@ -15,7 +15,7 @@ In Firefox, each ruleset has its own quota. Its value is `5000`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_enabled_static_rulesets/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_enabled_static_rulesets/index.md index 0dc7eb6fd61e408..0791ced39951494 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_enabled_static_rulesets/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_enabled_static_rulesets/index.md @@ -13,7 +13,7 @@ An extension can change the number of enabled rulesets using the {{WebExtAPIRef( Its value is `10`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_regex_rules/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_regex_rules/index.md index a98d8408b95a057..c4aee9b8bdf5d5c 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_regex_rules/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_regex_rules/index.md @@ -15,7 +15,7 @@ In Firefox, this limit is evaluated separately per ruleset. In Safari, there is no separate limit on the number of `regexFilter` rules. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_static_rulesets/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_static_rulesets/index.md index 189058febad1d1f..4cbc32dc78146cd 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_static_rulesets/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/max_number_of_static_rulesets/index.md @@ -11,7 +11,7 @@ The maximum number of static rulesets an extension can specify as part of the [` Its value is `50`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/modifyheaderinfo/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/modifyheaderinfo/index.md index eaba721bddca3eb..9977edeadf24b47 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/modifyheaderinfo/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/modifyheaderinfo/index.md @@ -60,6 +60,8 @@ In Chrome, `"append"` is supported for the following request headers: In Firefox, the extension needs host permissions for the new value of the `Host` header. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/onrulematcheddebug/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/onrulematcheddebug/index.md index 574ab8707aba9dc..6a9aa4a004c52a7 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/onrulematcheddebug/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/onrulematcheddebug/index.md @@ -65,7 +65,7 @@ Events have three functions: - `rule` - : {{WebExtAPIRef("declarativeNetRequest.MatchedRule", "MatchedRule")}}. Details of a matched rule. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/redirect/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/redirect/index.md index 801589d6c1c6cbb..c73cdbeaa6e5270 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/redirect/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/redirect/index.md @@ -20,7 +20,7 @@ Details describing how a redirect should be performed, as the `redirect` propert Values of this type are objects. They contain these properties: - `extensionPath` {{optional_inline}} - - : A `string`. The path relative to the extension directory. Should start with '/'. + - : A `string`. The path relative to the extension directory. Should start with '/'. The initiator of the request can only follow the redirect when the resource is listed in [`web_accessible_resources`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/web_accessible_resources). - `regexSubstitution` {{optional_inline}} - : A `string`. The substitution pattern for rules that specify a `regexFilter`. The first match of `regexFilter` within the URL is replaced with this pattern. Within `regexSubstitution`, backslash-escaped digits (`\1` to `\9`) are used to insert the corresponding capture groups. `\0` refers to the entire matching text. - `transform` {{optional_inline}} @@ -28,6 +28,8 @@ Values of this type are objects. They contain these properties: - `url` {{optional_inline}} - : A `string`. The redirect URL. Redirects to JavaScript URLs are not allowed. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/resourcetype/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/resourcetype/index.md index 35da09ba4c36896..fe471685b566e6c 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/resourcetype/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/resourcetype/index.md @@ -66,6 +66,8 @@ Values of this type are strings. Possible values are: - `other` - : Resources that aren't covered by any other available type. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rule/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rule/index.md index 84d246f8fb22428..a4d1e559a399350 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rule/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rule/index.md @@ -24,6 +24,8 @@ Values of this type are objects. They contain these properties: - `priority` {{optional_inline}} - : `number`. Rule priority. Defaults to 1. When specified, should be >= 1. See [Matching precedents](/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedents) for details on how priority affects which rules are applied. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/ruleaction/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/ruleaction/index.md index 0b593b8c0589883..03d6b3e9854977d 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/ruleaction/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/ruleaction/index.md @@ -22,6 +22,8 @@ Values of this type are objects. They contain these properties: - `type` - : A `string`. The type of action to perform. Possible values are `"block"`, `"redirect"`, `"allow"`, `"upgradeScheme"`, `"modifyHeaders"`, and `"allowAllRequests"`. The use of the `"redirect"` and `"modifyHeaders"` actions require [host permissions](/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions) for the request and request initiator. The "block" and "upgradeScheme" actions also require host permissions unless the "declarativeNetRequest" permission is specified. Without these permissions, matching rules are ignored. See [Permissions at declarativeNetRequest](/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#permissions) for more information. More details about the effects of rule actions are provided in [Matching precedents](/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedents). +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rulecondition/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rulecondition/index.md index 5aa246b35ceebeb..d6af57ff0a4ef33 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rulecondition/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/rulecondition/index.md @@ -72,6 +72,8 @@ Domains specified in `initiatorDomains`, `excludedInitiatorDomains`, `requestDom To programmatically generate the canonical domain for a URL, use the [URL API](/docs/Web/API/URL) and read its `hostname` property, i.e., `new URL(url).hostname`. +{{WebExtExamples("h2")}} + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/session_ruleset_id/index.md b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/session_ruleset_id/index.md index e2cb235e1b63fab..52e1adce681ccfd 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/session_ruleset_id/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/session_ruleset_id/index.md @@ -11,7 +11,7 @@ The ruleset ID for the session-scoped rules added by the extension. Its value is `"_session"`. -{{WebExtExamples}} +{{WebExtExamples("h2")}} ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md b/files/en-us/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md index 338f0aa67594a67..f8c7e9d7240f6dd 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/webrequest/onauthrequired/index.md @@ -7,7 +7,7 @@ browser-compat: webextensions.api.webRequest.onAuthRequired {{AddonSidebar()}} -Fired when the server sends a `401` or `407` status code (that is, when the server is asking the client to provide authentication credentials, such as a username and password). +Fired when the server sends a `401` or `407` status code and a `WWW-Authenticate` header using the `Basic` scheme (that is, when the server is asking the client to provide authentication credentials, such as a username and password). The listener can respond in one of four different ways: diff --git a/files/en-us/mozilla/add-ons/webextensions/manifest.json/declarative_net_request/index.md b/files/en-us/mozilla/add-ons/webextensions/manifest.json/declarative_net_request/index.md index 69650d7eff5e1a8..36270f4277362af 100644 --- a/files/en-us/mozilla/add-ons/webextensions/manifest.json/declarative_net_request/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/manifest.json/declarative_net_request/index.md @@ -86,6 +86,12 @@ The `"declarative_net_request"` key is an object that must contain the `"rule_re } ``` +## Example extensions + + +- [dnr-block-only](https://github.com/mdn/webextensions-examples/tree/master/dnr-block-only) +- [dnr-redirect-url](https://github.com/mdn/webextensions-examples/tree/master/dnr-redirect-url) + ## Browser compatibility {{Compat}} diff --git a/files/en-us/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.md b/files/en-us/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.md index 00bcfbf692ef857..2a49ea78262f38e 100644 --- a/files/en-us/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/manifest.json/web_accessible_resources/index.md @@ -46,7 +46,7 @@ With the `web_accessible_resources` key, you list all the packaged resources tha Note that content scripts don't need to be listed as web accessible resources. -If an extension wants to use {{WebExtAPIRef("webRequest")}} to redirect a public URL (e.g., HTTPS) to a page that's packaged in the extension, then the extension must list the page in the `web_accessible_resources` key. +If an extension wants to use {{WebExtAPIRef("webRequest")}} or {{WebExtAPIRef("declarativeNetRequest")}} to redirect a public URL (e.g., HTTPS) to a page that's packaged in the extension, then the extension must list the page in the `web_accessible_resources` key. ### Manifest V2 syntax @@ -62,7 +62,7 @@ In Manifest V2, web accessible resources are added as an array under the key, li In Manifest V3, the `web_accessible_resources` key is an array of objects like this: -``` +```json { // … "web_accessible_resources": [ @@ -94,21 +94,26 @@ Each object must include a `"resources"` property and either a `"matches"` or `" extension_ids - String + Array of String + Optional. Defaults to [], meaning that other extensions cannot access the resource. +

    A list of extension IDs specifying the extensions that can access the resources. + "*" matches all extensions. matches - String + Array of String - A list of URL match patterns specifying the pages that can access the resources. Only the origin is used to match URLs. Origins include subdomain matching. Paths are ignored. + Optional. Defaults to [], meaning that other websites cannot access the resource. +

    + A list of URL match patterns specifying the pages that can access the resources. Only the origin is used to match URLs. Origins include subdomain matching. Paths must be set to /*. resources - String + Array of String An array of resources to be exposed. Resources are specified as strings and may contain * for wildcard matches. For example, "/images/*" exposes everything in the extension's /images directory recursively, while "*.png" exposes all PNG files. @@ -117,6 +122,8 @@ Each object must include a `"resources"` property and either a `"matches"` or `" use_dynamic_url Boolean + Optional. Defaults to false. +

    Whether resources to be accessible through the dynamic ID. The dynamic ID is generated per session and regenerated on browser restart or extension reload. @@ -177,11 +184,45 @@ Web-accessible extension resources are not blocked by [CORS](/en-US/docs/Web/HTT ## Example +### Manifest V2 example + ```json "web_accessible_resources": ["images/my-image.png"] ``` -Make the file at "images/my-image.png" web accessible. +Make the file at "images/my-image.png" web accessible to any website and extension. + +### Manifest V3 example + +```json +"web_accessible_resources": [ + { + "resources": [ "images/my-image.png" ], + "extension_ids": ["*"], + "matches": [ "*://*/*" ] + } +] +``` + +Make the file at "images/my-image.png" web accessible to any website and extension. + +It is recommended to only specify `extension_ids` or `matches` if needed. +For example, if the resource only needs to be accessible to web pages at example.com: + +```json +"web_accessible_resources": [ + { + "resources": [ "images/my-image.png" ], + "matches": [ "https://example.com/*" ] + } +] +``` + +## Example extensions + + +- [beastify](https://github.com/mdn/webextensions-examples/tree/master/beastify) +- [dnr-redirect-url](https://github.com/mdn/webextensions-examples/tree/master/dnr-redirect-url) ## Browser compatibility diff --git a/files/en-us/mozilla/add-ons/webextensions/work_with_the_cookies_api/index.md b/files/en-us/mozilla/add-ons/webextensions/work_with_the_cookies_api/index.md index b4741b329bd2cfd..732210ebee286c1 100644 --- a/files/en-us/mozilla/add-ons/webextensions/work_with_the_cookies_api/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/work_with_the_cookies_api/index.md @@ -87,6 +87,9 @@ Firefox provides three types of cookie store: - The default store, which stores cookies from normal browsing. - Private browsing mode stores, which stores cookies created during a private browsing session. These stores and any cookies they contain are removed when the related private browsing window closes. + > **Note:** + > Only visible if {{WebExtAPIRef("extension.isAllowedIncognitoAccess()")}} returns true. Safari doesn't support access to private cookies. + - Container tabs stores, which stores cookies for each contextual identity in Firefox. Contextual identities enable a user to maintain multiple identities within one browser window. This is useful if, for example, you've a company and personal email account on Gmail. With contextual identities, you can open one tab against a personal identity and a second tab against a business identity. Each tab can then sign into Google mail with a different username, and the two accounts can be used side-by-side. For more information, see [Security/Contextual Identity Project/Containers](https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers) in the Mozilla wiki. You can find out what cookie stores are available using {{WebExtAPIRef("cookies.getAllCookieStores")}}, which returns an object containing the ID of each cookie store and a list of the IDs of the tabs using each cookie store. diff --git a/files/en-us/mozilla/firefox/experimental_features/index.md b/files/en-us/mozilla/firefox/experimental_features/index.md index b0d18ae66488bff..c213af3db9b2609 100644 --- a/files/en-us/mozilla/firefox/experimental_features/index.md +++ b/files/en-us/mozilla/firefox/experimental_features/index.md @@ -888,46 +888,6 @@ The `groupBy` method should be used when strings can be used to represent elemen -#### Static module import in workers - -[Workers](/en-US/docs/Web/API/Web_Workers_API) can now [`import`](/en-US/docs/Web/JavaScript/Reference/Statements/import) [JavaScript modules](/en-US/docs/Web/JavaScript/Guide/Modules) ([Firefox bug 1247687](https://bugzil.la/1247687)). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Release channelVersion removedEnabled by default?
    Nightly111Yes
    Developer Edition111No
    Beta111No
    Release111No
    Preference namedom.workers.modules.enabled
    - ## APIs ### Graphics: Canvas, WebGL, and WebGPU diff --git a/files/en-us/mozilla/firefox/releases/114/index.md b/files/en-us/mozilla/firefox/releases/114/index.md index ec9232e77124d8a..6e01332fa866b63 100644 --- a/files/en-us/mozilla/firefox/releases/114/index.md +++ b/files/en-us/mozilla/firefox/releases/114/index.md @@ -21,6 +21,11 @@ This article provides information about the changes in Firefox 114 that affect d ### JavaScript +- [Workers](/en-US/docs/Web/API/Web_Workers_API) now support loading [ECMAScript modules](/en-US/docs/Web/JavaScript/Guide/Modules). + You can load modules into workers by specifying the `{type: "module"}` option in the [`Worker`](/en-US/docs/Web/API/Worker/Worker#type) and [`SharedWorker` constructors](/en-US/docs/Web/API/SharedWorker/SharedWorker#type). + Worker scripts can also statically or dynamically import modules using [`import`](/en-US/docs/Web/JavaScript/Reference/Statements/import) and [`import()`](/en-US/docs/Web/JavaScript/Reference/Operators/import), respectively ([Firefox bug 1812591](https://bugzil.la/1812591)). +- [Worklets](/en-US/docs/Web/API/Worklet) can now use [`import`](/en-US/docs/Web/JavaScript/Reference/Statements/import) to statically import [ECMAscript/JavaScript modules](/en-US/docs/Web/JavaScript/Guide/Modules) ([Firefox bug 1812591](https://bugzil.la/1812591)). + #### Removals ### SVG diff --git a/files/en-us/mozilla/firefox/releases/56/index.md b/files/en-us/mozilla/firefox/releases/56/index.md index d461bac414e9813..5efbd12de517a08 100644 --- a/files/en-us/mozilla/firefox/releases/56/index.md +++ b/files/en-us/mozilla/firefox/releases/56/index.md @@ -80,7 +80,7 @@ _No changes._ ### HTML - The {{htmlelement("isindex")}} element has been removed from the HTML parser, and from form submission ([Firefox bug 1266495](https://bugzil.la/1266495)). -- The {{htmlelement("applet")}} element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)). +- The `` element has been removed ([Firefox bug 1279218](https://bugzil.la/1279218)). ### APIs diff --git a/files/en-us/web/accessibility/aria/attributes/aria-label/index.md b/files/en-us/web/accessibility/aria/attributes/aria-label/index.md index 382973d6db223eb..f130fb58301afd7 100644 --- a/files/en-us/web/accessibility/aria/attributes/aria-label/index.md +++ b/files/en-us/web/accessibility/aria/attributes/aria-label/index.md @@ -96,6 +96,7 @@ The `aria-label` attribute is **NOT** supported in: - {{HTMLElement('label')}} element - [`aria-labelledby`](/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-labelledby) +- [Using HTML landmark roles to improve accessibility](/en-US/blog/aria-accessibility-html-landmark-roles/) on MDN blog (May 15, 2023)