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/cachestorage/delete/index.html |  2 +-
 files/fr/web/api/cachestorage/has/index.html    |  2 +-
 files/fr/web/api/cachestorage/index.html        | 13 +++++++++----
 files/fr/web/api/cachestorage/keys/index.html   |  2 +-
 files/fr/web/api/cachestorage/match/index.html  |  8 +++++---
 files/fr/web/api/cachestorage/open/index.html   |  4 ++--
 6 files changed, 19 insertions(+), 12 deletions(-)

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

diff --git a/files/fr/web/api/cachestorage/delete/index.html b/files/fr/web/api/cachestorage/delete/index.html
index d1d5499d48..6d088f5d7f 100644
--- a/files/fr/web/api/cachestorage/delete/index.html
+++ b/files/fr/web/api/cachestorage/delete/index.html
@@ -35,7 +35,7 @@ translation_of: Web/API/CacheStorage/delete
 
 

Une {{jsxref("Promise", "Promesse")}} qui renvoie true si l'objet {{domxref("Cache")}} est trouvé et supprimé, false sinon.

-

Exemples

+

Exemples

Dans ce fragment de code, nous attendons un évènement, et bloquons avec un {{domxref("ExtendableEvent.waitUntil","waitUntil()")}}, qui nettoie les anciens, inutilisés, caches avant que le nouveau service worker soit activé. Nous avons ici une liste blanche contenant le nom du cache que nous voulons garder. Nous retournons les clés des caches dans l'objet {{domxref("CacheStorage")}} utilisant {{domxref("CacheStorage.keys")}}, pour ensuite vérifier que chaque clé est dans la liste blance. Sinon, nous la supprimons avec delete().

diff --git a/files/fr/web/api/cachestorage/has/index.html b/files/fr/web/api/cachestorage/has/index.html index d28ba6eeb0..5b1b6a6ae0 100644 --- a/files/fr/web/api/cachestorage/has/index.html +++ b/files/fr/web/api/cachestorage/has/index.html @@ -36,7 +36,7 @@ translation_of: Web/API/CacheStorage/has

Une {{jsxref("Promise", "Promesse")}} qui renvoie true si le cache existe.

-

Exemples

+

Exemples

L'exemple suivant vérifie qu'un cache nommé 'v1' exists. Si c'est le cas, nous lui ajoutons une liste d'assets. Si non (la promesse has() est rejetée) alors nous exécutons une sorte d'initialisation du cache.

diff --git a/files/fr/web/api/cachestorage/index.html b/files/fr/web/api/cachestorage/index.html index 73138a4baf..276393aa31 100644 --- a/files/fr/web/api/cachestorage/index.html +++ b/files/fr/web/api/cachestorage/index.html @@ -19,7 +19,8 @@ translation_of: Web/API/CacheStorage
  • Fournit un répertoire principal de tous les caches nommés qui peut être accessible par un {{domxref("ServiceWorker")}} ou un autre type de travailleur ou portée de {{domxref("window")}} (vous n'êtes pas limité à l'utiliser uniquement avec des Service Workers, même si la spécification {{SpecName("Service Workers")}} le définit). -
    Note : Chrome et Safari n'exposent que "CacheStorage" au contexte fenêtré sur HTTPS (EN). {{domxref("window.caches")}} sera indéfinie, à moins qu'un certificat SSL ne soit configuré.
    +
    +

    Note : Chrome et Safari n'exposent que "CacheStorage" au contexte fenêtré sur HTTPS. {{domxref("window.caches")}} sera indéfinie, à moins qu'un certificat SSL ne soit configuré.

  • Maintient une correspondance entre les noms des chaînes de caractères et les objets {{domxref("Cache")}} correspondants.
@@ -30,9 +31,13 @@ translation_of: Web/API/CacheStorage

Vous pouvez accéder à CacheStorage via la propriété globale {{domxref("WindowOrWorkerGlobalScope.caches", "caches")}}.

-
Note: CacheStorage échouera systématiquement avec une SecurityError sur les domaines non certifiés (i.e. ceux qui n'utilisent pas HTTPS, bien que cette définition risque de devenir plus complexe dans le future). Pendant vos tests vous pouvez contourner ce comportement en cochant l'option "Enable Service Workers over HTTP (when toolbox is open)" dans les options Firefox Devtools / le menu gear.
+
+

Note : CacheStorage échouera systématiquement avec une SecurityError sur les domaines non certifiés (i.e. ceux qui n'utilisent pas HTTPS, bien que cette définition risque de devenir plus complexe dans le future). Pendant vos tests vous pouvez contourner ce comportement en cochant l'option "Enable Service Workers over HTTP (when toolbox is open)" dans les options Firefox Devtools / le menu gear.

+
-
Note: {{domxref("CacheStorage.match()")}} est une méthode de convenance. Il est possible d'implémenter une fonctionnalité équivalente pour matcher une entrée de cache en appelant {{domxref("CacheStorage.open()")}}, puis en retournant {{domxref("CacheStorage.keys()")}}, et en matchant les entrées voulues avec {{domxref("CacheStorage.match()")}}.
+
+

Note : {{domxref("CacheStorage.match()")}} est une méthode de convenance. Il est possible d'implémenter une fonctionnalité équivalente pour matcher une entrée de cache en appelant {{domxref("CacheStorage.open()")}}, puis en retournant {{domxref("CacheStorage.keys()")}}, et en matchant les entrées voulues avec {{domxref("CacheStorage.match()")}}.

+

Méthodes

@@ -190,7 +195,7 @@ try {

Voir aussi

diff --git a/files/fr/web/api/cachestorage/keys/index.html b/files/fr/web/api/cachestorage/keys/index.html index 69d08de58b..ed61c3716c 100644 --- a/files/fr/web/api/cachestorage/keys/index.html +++ b/files/fr/web/api/cachestorage/keys/index.html @@ -33,7 +33,7 @@ translation_of: Web/API/CacheStorage/keys

Une {{jsxref("Promise", "Promesse")}} qui retourne une liste de noms de {{domxref("Cache")}} contenus dans un objet {{domxref("CacheStorage")}}.

-

Exemples

+

Exemples

Dans ce fragment de code, nous attendons un évènement, et bloquons avec un {{domxref("ExtendableEvent.waitUntil","waitUntil()")}}, qui nettoie les anciens caches, inutilisés, avant que le nouveau service worker soit activé. Nous avons ici une liste blanche contenant le nom du cache que nous voulons garder. Nous retournons les clés des caches dans l'objet {{domxref("CacheStorage")}} utilisant {{domxref("CacheStorage.keys")}}, pour ensuite vérifier que chaque clé est dans la liste blance. Sinon, nous la supprimons avec delete().

diff --git a/files/fr/web/api/cachestorage/match/index.html b/files/fr/web/api/cachestorage/match/index.html index 22e25ab644..704f299794 100644 --- a/files/fr/web/api/cachestorage/match/index.html +++ b/files/fr/web/api/cachestorage/match/index.html @@ -20,7 +20,9 @@ translation_of: Web/API/CacheStorage/match

Les objets Cache sont cherchés par ordre de création.

-
Note: {{domxref("CacheStorage.match()", "caches.match()")}} est une méthode de commodité. Une fonctionnalité équivalente consiste à appeler {{domxref("cache.match()")}} sur chaque cache (dans l'ordre renvoyé par {{domxref("CacheStorage.keys()", "caches.keys()")}}) jusqu'à ce qu'une {{domxref("Response", "Réponse")}} soit renvoyée.
+
+

Note : {{domxref("CacheStorage.match()", "caches.match()")}} est une méthode de commodité. Une fonctionnalité équivalente consiste à appeler {{domxref("cache.match()")}} sur chaque cache (dans l'ordre renvoyé par {{domxref("CacheStorage.keys()", "caches.keys()")}}) jusqu'à ce qu'une {{domxref("Response", "Réponse")}} soit renvoyée.

+

Syntaxe

@@ -40,7 +42,7 @@ translation_of: Web/API/CacheStorage/match
  • ignoreSearch: Un {{domxref("Boolean")}} qui détermine si le preocessus de rapprochement doit ignorer la chaîne de requête dans l'url. Défini à true, la partie ?value=bar de http://foo.com/?value=bar sera ignoré lors d'un rapporchement. La valeur par défaut est false.
  • ignoreMethod: Un {{domxref("Boolean")}} qui, quand défini à true, empêche l'opération de rapprochement de valider le verbe http de la {{domxref("Request", "Requête")}} http (normalement, seulement GET et HEAD sont authorisés) La valeur par défaut est false.
  • ignoreVary: Un {{domxref("Boolean")}} qui, quand défini à true, dit à l'opération de rapprochement de ne pas faire le rapprochement avec le header VARY. En d'autres termes, si une URL est sélectionnée elle sera conservée indépemment de la présence du header VARY. La valeur par défaut est false.
  • -
  • cacheName: Un {{domxref("DOMString")}} qui représente le cache dans lequel on recherche.
  • +
  • cacheName: Un {{domxref("DOMString")}} qui représente le cache dans lequel on recherche.
  • @@ -49,7 +51,7 @@ translation_of: Web/API/CacheStorage/match

    Une {{jsxref("Promise", "Promesse")}} qui renvoie les {{domxref("Response", "Réponses")}} correspondante.

    -

    Exemples

    +

    Exemples

    Cet exemple est tiré du MDN sw-test example (voir sw-test running live). Nous attendons pour un évènement {{domxref("FetchEvent")}} et nous construisons une réponse comme suit:

    diff --git a/files/fr/web/api/cachestorage/open/index.html b/files/fr/web/api/cachestorage/open/index.html index a2c81af6f9..87d45d11b3 100644 --- a/files/fr/web/api/cachestorage/open/index.html +++ b/files/fr/web/api/cachestorage/open/index.html @@ -19,7 +19,7 @@ translation_of: Web/API/CacheStorage/open

    Vous pouvez accéder à CacheStorage via la propriété globale {{domxref("WindowOrWorkerGlobalScope.caches", "caches")}}.

    -

    Note: Si le {{domxref("Cache")}} spécifié n'existe pas, un nouveau cache sera crée avec cacheName et retournera une {{jsxref("Promise", "Promesse")}} renvoyant le nouvel objet {{domxref("Cache")}}.

    +

    Note : Si le {{domxref("Cache")}} spécifié n'existe pas, un nouveau cache sera crée avec cacheName et retournera une {{jsxref("Promise", "Promesse")}} renvoyant le nouvel objet {{domxref("Cache")}}.

    Syntaxe

    @@ -40,7 +40,7 @@ translation_of: Web/API/CacheStorage/open

    Une {{jsxref("Promise", "Promesse")}} qui renvoie l'objet {{domxref("Cache")}} demandé.

    -

    Exemples

    +

    Exemples

    Cet exemple est tiré de l'exemple MDN sw-test (voir sw-test en direct). Ici, nous attendons qu'un {{domxref("InstallEvent")}} se déclenche, puis nous lançons {{domxref("ExtendableEvent.waitUntil", "waitUntil()")}} pour gérer le processus d'installation de l'application. Cela consiste à appeler CacheStorage.open() pour créer un nouveau cache, puis à utiliser {{domxref("Cache.addAll()")}} pour y ajouter une série d'éléments.

    -- cgit v1.2.3-54-g00ecf