From 6772831200d14c2436aea2d0c837f40dbf12156f Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sun, 26 Sep 2021 13:11:47 +0200 Subject: Prepare Web API section for Markdown conversion (#2464) * Remove summary classes and ids * Remove unecessary hidden * Remove useless span filled with useless attributes / ids * Remove useless font * Remove notranslate * Remove id in other elements than headings * Remove name attributes * Remove 
 for JS w/ language-js class

* Remove 
 for HTML w/ language-html class

* Remove 
 for other lang w/ language-* class

* Rm highlighted line in code samples

* fix links, internal, external, absolute URLs

* missing file from last commit

* Fix styles errors apart from table + some classes

* Fix notes and warnings (+ some other :x)

* fix typo during merge which broke a doc

* aand forgot a conflict

* fix remaining classes of errors except dls and images

* Fix dls

* Fix images (deki/mozillademos) and remaining style issues

* Remove script tag from svg file

* Remove script tag from svg fileS

* Compress SVG files for CI
---
 files/fr/web/api/cache/add/index.html      |  4 ++--
 files/fr/web/api/cache/addall/index.html   |  2 +-
 files/fr/web/api/cache/delete/index.html   |  2 +-
 files/fr/web/api/cache/index.html          | 16 +++++++++-------
 files/fr/web/api/cache/keys/index.html     |  7 +++----
 files/fr/web/api/cache/match/index.html    |  6 +++---
 files/fr/web/api/cache/matchall/index.html |  6 +++---
 files/fr/web/api/cache/put/index.html      | 10 +++++-----
 8 files changed, 27 insertions(+), 26 deletions(-)

(limited to 'files/fr/web/api/cache')

diff --git a/files/fr/web/api/cache/add/index.html b/files/fr/web/api/cache/add/index.html
index 0106a19573..83fd3085ba 100644
--- a/files/fr/web/api/cache/add/index.html
+++ b/files/fr/web/api/cache/add/index.html
@@ -27,12 +27,12 @@ translation_of: Web/API/Cache/add
 
Pour des opérations plus complexes, il faut utiliser {{domxref("Cache.put","Cache.put()")}} directement.

 
 

-
Note: add() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à la requête.

+
Note : add() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à la requête.

 

 
 
Syntaxe

 
-
cache.add(request).then(function() {
+
cache.add(request).then(function() {
   //request a été ajoutée au cache
 });
 

diff --git a/files/fr/web/api/cache/addall/index.html b/files/fr/web/api/cache/addall/index.html
index 2c01cdc54d..98f5111d78 100644
--- a/files/fr/web/api/cache/addall/index.html
+++ b/files/fr/web/api/cache/addall/index.html
@@ -18,7 +18,7 @@ translation_of: Web/API/Cache/addAll
 
La méthode addAll() de l'interface {{domxref("Cache")}} accepte un tableau d'URLS, les récupères, et ajoute les objets réponse qui en résultent au cache en question. Les objets requêtes crées pendant la phase de récupération deviennent des clés vers les opérations de réponse stockées. 

 
 

-
Note: addAll() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à une requête, mais échouera si l'opération put() ainsi créée devrait engendrer l'éffacement d'une entrée cache créée par la même méthode addAll().

+
Note : addAll() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à une requête, mais échouera si l'opération put() ainsi créée devrait engendrer l'éffacement d'une entrée cache créée par la même méthode addAll().

 

 
 
Syntaxe

diff --git a/files/fr/web/api/cache/delete/index.html b/files/fr/web/api/cache/delete/index.html
index b75eccb772..5100ece8c8 100644
--- a/files/fr/web/api/cache/delete/index.html
+++ b/files/fr/web/api/cache/delete/index.html
@@ -43,7 +43,7 @@ translation_of: Web/API/Cache/delete
 
 
Une {{jsxref("Promise", "Promesse")}} qui est résolue à true si l'entrée de cache est supprimée, ou à false dans le cas contraire.

 
-
Exemples

+
Exemples

 
 
caches.open('v1').then(function(cache) {
   cache.delete('/images/image.png').then(function(response) {
diff --git a/files/fr/web/api/cache/index.html b/files/fr/web/api/cache/index.html
index b9215d7cf4..384689d3fa 100644
--- a/files/fr/web/api/cache/index.html
+++ b/files/fr/web/api/cache/index.html
@@ -21,12 +21,12 @@ translation_of: Web/API/Cache
 
 
Vous êtes également responsable de la purge périodique des entrées du cache. Chaque navigateur a une limite stricte sur la quantité de mémoire cache qu'une origine donnée peut utiliser. Les estimations de l'utilisation du quota de cache sont disponibles via le lien {{domxref("StorageEstimate")}} API. Le navigateur fait de son mieux pour gérer l'espace disque, mais il peut supprimer le stockage en cache d'une origine. Le navigateur supprime généralement toutes les données d'une origine ou aucune des données d'une origine. Veillez à nommer les caches et à n'utiliser les caches qu'à partir de la version du script sur laquelle ils peuvent fonctionner en toute sécurité. Pour plus d'informations, voir Suppression des anciens caches.

 
-

-
Note : Les implémentations initiales du cache (dans Blink et Gecko) résolvent les engagements {{domxref("Cache.add()")}}, {{domxref("Cache.addAll()")}}, et {{domxref("Cache.put()")}} lorsque le corps de la réponse est entièrement écrit sur le stockage. Des versions plus récentes de la spécification précisent que le navigateur peut résoudre la promesse dès que l'entrée est enregistrée dans la base de données, même si le corps de réponse est encore en cours d'écriture.

+

+
Note : Les implémentations initiales du cache (dans Blink et Gecko) résolvent les engagements {{domxref("Cache.add()")}}, {{domxref("Cache.addAll()")}}, et {{domxref("Cache.put()")}} lorsque le corps de la réponse est entièrement écrit sur le stockage. Des versions plus récentes de la spécification précisent que le navigateur peut résoudre la promesse dès que l'entrée est enregistrée dans la base de données, même si le corps de réponse est encore en cours d'écriture.

 

 
-

-
Note : L'algorithme des correspondances de clés est dépendant de la valeur de l'en-tête VARY. Ainsi, pour faire correspondre une nouvelle clé, il faut examiner à la fois la clé et la valeur des entrées dans le Cache.

+

+
Note : L'algorithme des correspondances de clés est dépendant de la valeur de l'en-tête VARY. Ainsi, pour faire correspondre une nouvelle clé, il faut examiner à la fois la clé et la valeur des entrées dans le Cache.

 

 
 

@@ -62,7 +62,9 @@ translation_of: Web/API/Cache
 
 
Cet extrait de code illustre également une bonne pratique pour versionner les caches utilisés par le service worker. Bien qu'il y ait seulement un cache dans cet exemple, la même approche peut être utilisée pour des caches multiples. Il associe un identifiant  court avec un nom de cache versionné et spécifique. Le code supprime aussi tous les caches qui ne sont pas nommés dans CURRENT_CACHES.

 
-
Note: In Chrome, visit chrome://inspect/#service-workers and click on the "inspect" link below the registered service worker to view logging statements for the various actions the service-worker.js script is performing.

+

+  
Note: In Chrome, visit chrome://inspect/#service-workers and click on the "inspect" link below the registered service worker to view logging statements for the various actions the service-worker.js script is performing.

+

 
 
var CACHE_VERSION = 1;
 
@@ -145,8 +147,8 @@ self.addEventListener('fetch', function(event) {
 
 
diff --git a/files/fr/web/api/cache/keys/index.html b/files/fr/web/api/cache/keys/index.html
index 090d9375a7..faabe1581d 100644
--- a/files/fr/web/api/cache/keys/index.html
+++ b/files/fr/web/api/cache/keys/index.html
@@ -19,7 +19,7 @@ translation_of: Web/API/Cache/keys
 
Les requêtes sont retournées dans le même ordre que l'ordre d'insertion.

 
 

-
Note: Les requêtes avec des URLs déjà présentes mais des headers différents peuvent être retournées si leurs réponses comportent le header VARY.

+
Note : Les requêtes avec des URLs déjà présentes mais des headers différents peuvent être retournées si leurs réponses comportent le header VARY.

 

 
 
Syntaxe

@@ -35,8 +35,7 @@ translation_of: Web/API/Cache/keys
  
request {{optional_inline}}

  
La {{domxref("Request", "Requête")}} à retourner, si une clé en particulier est désirée.

  
options {{optional_inline}}

- 
Un objet dont les paramètres contrôlent comment le matching est effectué lors de l'opération keys. Les options disponibles sont :

- 

+ 
Un objet dont les paramètres contrôlent comment le matching est effectué lors de l'opération keys. Les options disponibles sont :

  
    
   
  • ignoreSearch: Un {{domxref("Boolean")}} qui spécifie si le matching doit ignorer ou non la query string dans l'url.  Si mis à true, la partie ?value=bar de l'url http://foo.com/?value=bar sera ignorée lors du matching. Est à false par défaut.
    • 
   
  • ignoreMethod: Un {{domxref("Boolean")}} qui, quand mis à true, empêche les opérations de matching de valider la méthode HTTP de la {{domxref("Request", "Requête")}} (en temps normal, seules GET et HEAD sont autorisées). Est à  false par défaut.
    • 
@@ -50,7 +49,7 @@ translation_of: Web/API/Cache/keys
 
 
    Une {{jsxref("Promise", "Promesse")}} qui est résolue en un tableau de clé de {{domxref("Cache")}}.
    
 
-
    Exemples
    
+
    Exemples
    
 
 
    caches.open('v1').then(function(cache) {
   cache.keys().then(function(keys) {
diff --git a/files/fr/web/api/cache/match/index.html b/files/fr/web/api/cache/match/index.html
index a49e733af6..7867ba79a6 100644
--- a/files/fr/web/api/cache/match/index.html
+++ b/files/fr/web/api/cache/match/index.html
@@ -44,16 +44,16 @@ translation_of: Web/API/Cache/match
 
    Une {{jsxref("Promise", "Promesse")}} qui est résolue en la première {{domxref("Response", "Réponse")}} qui match la requête, ou en {{jsxref("undefined")}} si aucune requête n'est trouvée.
    
 
 
    
-
    Note: Cache.match() est quasiment identique à {{domxref("Cache.matchAll()")}}, si ce n'est qu'elle est résolue en response[0] (la première réponse qui matche) plutôt que response[] (un tableau de toutes les réponses qui matchent).
    
+
    Note : Cache.match() est quasiment identique à {{domxref("Cache.matchAll()")}}, si ce n'est qu'elle est résolue en response[0] (la première réponse qui matche) plutôt que response[] (un tableau de toutes les réponses qui matchent).
    
 
    
 
-
    Exemples
    
+
    Exemples
    
 
 
    Cet exemple est extrait de l'exemple Page hors ligne custom (demo).
    
 
 
    L'exemple suivant se sert d'un cache pour fournir les données demandées même quand une requête échoue. Une clause catch() est déclenchée quand l'appel à fetch() lève une exception. A l'intérieur de la clause catch(), match() est utilisée to pour retourner la réponse appropriée.
    
 
-
    Dans cet exemple, nous avons décidé que seul les documents HTML récupérés via le verbe HTTP GET seront mis en cache. Si notre condition if() est false, le gestionnaire fetch n'intercepte pas la requête. Si d'autres gestionnaires fetch sont enregistrés, ils ont une occasion d'appeler event.respondWith(). Si aucun gestionnaire fetch ne décide d'appeler event.respondWith(), la requête sera gérée par le navigateur comme si les service workers n'avaient pas existé. Si fetch() retourne une réponse HTTP valide avec un code réponse dans les 4xx ou 5xx, la clause catch() ne sera PAS appelée. 
    
+
    Dans cet exemple, nous avons décidé que seul les documents HTML récupérés via le verbe HTTP GET seront mis en cache. Si notre condition if() est false, le gestionnaire fetch n'intercepte pas la requête. Si d'autres gestionnaires fetch sont enregistrés, ils ont une occasion d'appeler event.respondWith(). Si aucun gestionnaire fetch ne décide d'appeler event.respondWith(), la requête sera gérée par le navigateur comme si les service workers n'avaient pas existé. Si fetch() retourne une réponse HTTP valide avec un code réponse dans les 4xx ou 5xx, la clause catch() ne sera PAS appelée. 
    
 
 
    self.addEventListener('fetch', function(event) {
   // We only want to call event.respondWith() if this is a GET request for an HTML document.
diff --git a/files/fr/web/api/cache/matchall/index.html b/files/fr/web/api/cache/matchall/index.html
index 50126ead5c..86d1dad2bf 100644
--- a/files/fr/web/api/cache/matchall/index.html
+++ b/files/fr/web/api/cache/matchall/index.html
@@ -30,7 +30,7 @@ translation_of: Web/API/Cache/matchAll
  
    request
    
  
    La {{domxref("Request", "Requête")}} à trouver dans le {{domxref("Cache")}}.
    
  
    options {{optional_inline}}
    
- 
    Un objet d'options vous permettant de définir des options de contrôle spécifiques pour la correspondance effectuée. Les options disponibles sont les suivantes :
+ 
    Un objet d'options vous permettant de définir des options de contrôle spécifiques pour la correspondance effectuée. Les options disponibles sont les suivantes :
    
  
      
   
    • ignoreSearch: Un {{domxref("Boolean")}} qui spécifie si le matching doit ignorer ou non la query string dans l'url.  Si mis à true, la partie ?value=bar de l'url http://foo.com/?value=bar sera ignorée lors du matching. Est à false par défaut.
      • 
   
    • ignoreMethod: Un {{domxref("Boolean")}} qui, quand mis à true, empêche les opérations de matching de valider la méthode HTTP de la {{domxref("Request", "Requête")}} (en temps normal, seules GET et HEAD sont autorisées.) Est à  false par défaut.
      • 
@@ -44,10 +44,10 @@ translation_of: Web/API/Cache/matchAll
 
      Une {{jsxref("Promise", "Promesse")}} qui est résolue en un tableau de toutes les requêtes qui matchent dans l'objet {{domxref("Cache")}}.
      
 
 
      
-
      Note: {{domxref("Cache.match()")}} est quasiment identique à Cache.matchAll(), si ce n'est qu'elle est résolue en response[0] (la première réponse qui matche) plutôt que response[] (un tableau de toutes les réponses qui matchent).
      
+
      Note : {{domxref("Cache.match()")}} est quasiment identique à Cache.matchAll(), si ce n'est qu'elle est résolue en response[0] (la première réponse qui matche) plutôt que response[] (un tableau de toutes les réponses qui matchent).
      
 
      
 
-
      Exemples
      
+
      Exemples
      
 
 
      caches.open('v1').then(function(cache) {
   cache.matchAll('/images/').then(function(response) {
diff --git a/files/fr/web/api/cache/put/index.html b/files/fr/web/api/cache/put/index.html
index c5d6b0a51e..b8a7f9f5cd 100644
--- a/files/fr/web/api/cache/put/index.html
+++ b/files/fr/web/api/cache/put/index.html
@@ -27,15 +27,15 @@ translation_of: Web/API/Cache/put
 })
      
 
 
      
-
      Note: put() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à la requête.
      
+
      Note : put() écrasera toute paire clé/valeur précedemment stockée en cache et qui correspond à la requête.
      
 
      
 
 
      
-
      Note: Les implémentations initiales de Cache (à la fois dans Blink et Gecko) résolvent les promesses   {{domxref("Cache.add")}}, {{domxref("Cache.addAll")}}, et {{domxref("Cache.put")}} quand le corps de la réponse est entièrement écrit en stockage.  Les versions plus récentes des spécifications sont plus précises en déclarant que le navigateur peut résoudre ces promesses dès que l'entrée est enregistrée en base de donnée, même si le reste de la requête est encore en train d'arriver.
      
+
      Note : Les implémentations initiales de Cache (à la fois dans Blink et Gecko) résolvent les promesses   {{domxref("Cache.add")}}, {{domxref("Cache.addAll")}}, et {{domxref("Cache.put")}} quand le corps de la réponse est entièrement écrit en stockage.  Les versions plus récentes des spécifications sont plus précises en déclarant que le navigateur peut résoudre ces promesses dès que l'entrée est enregistrée en base de donnée, même si le reste de la requête est encore en train d'arriver.
      
 
      
 
 
      
-
      Note: Depuis Chrome 46, l'API Cache ne stocke que les requêtes depuis des origines sécurisées, à savoir celles servies en HTTPS.
      
+
      Note : Depuis Chrome 46, l'API Cache ne stocke que les requêtes depuis des origines sécurisées, à savoir celles servies en HTTPS.
      
 
      
 
 
      Syntaxe
      
@@ -59,10 +59,10 @@ translation_of: Web/API/Cache/put
 
      Une {{jsxref("Promise", "Promesse")}} est retournée avec void.
      
 
 
      
-
      Note: La promesse sera rompue avec un TypeError si le schéma d'URL n'est pas http ou https.
      
+
      Note : La promesse sera rompue avec un TypeError si le schéma d'URL n'est pas http ou https.
      
 
      
 
-
      Exemples
      
+
      Exemples
      
 
 
      Cet extrait de code est tiré du MDN sw-test example (lancez sw-test dans votre navigateur). On attend le déclenchement d'un {{domxref("FetchEvent")}}, puis l'on va retourner une réponse spéciale d'après la procédure suivante :
      
 
-- 
cgit v1.2.3-54-g00ecf