diff options
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/history')
13 files changed, 518 insertions, 589 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md index 089ce53843..9620adfc7c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/addurl/index.md @@ -13,50 +13,49 @@ tags: - addUrl translation_of: Mozilla/Add-ons/WebExtensions/API/history/addUrl --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Ajoute un enregistrement à l'historique du navigateur d'une visite à l'URL donnée. L'heure de la visite est enregistrée comme l'heure de l'appel, et le {{WebExtAPIRef("history.TransitionType", "TransitionType")}} est enregistré comme "liens".</p> +Ajoute un enregistrement à l'historique du navigateur d'une visite à l'URL donnée. L'heure de la visite est enregistrée comme l'heure de l'appel, et le {{WebExtAPIRef("history.TransitionType", "TransitionType")}} est enregistré comme "liens". -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var addingUrl = browser.history.addUrl( +```js +var addingUrl = browser.history.addUrl( details // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Objet contenant l'URL à ajouter.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL à ajouter.</dd> - <dt><code>title</code>{{optional_inline}}</dt> - <dd>string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme <code>null</code>.</dd> - <dt><code>transition</code>{{optional_inline}}</dt> - <dd>{{WebExtAPIRef("history.TransitionType")}}. Décrit comment le navigateur a navigué vers la page à cette occasion. Si ce n'est pas fourni, un type de transition de "lien" sera enregistré.</dd> - <dt><code>visitTime</code>{{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Cela peut être représenté par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaîne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'époque. Définit le temps de visite à cette valeur. Si ce n'est pas fourni, l'heure actuelle sera enregistrée.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournée">Valeur retournée</h3> + - : `object`. Objet contenant l'URL à ajouter. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera rempli sans paramètres lorsque l'élément a été ajouté.</p> + - `url` + - : `string`. L'URL à ajouter. + - `title`{{optional_inline}} + - : string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme `null`. + - `transition`{{optional_inline}} + - : {{WebExtAPIRef("history.TransitionType")}}. Décrit comment le navigateur a navigué vers la page à cette occasion. Si ce n'est pas fourni, un type de transition de "lien" sera enregistré. + - `visitTime`{{optional_inline}} + - : `number` ou `string` ou `object`. Cela peut être représenté par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaîne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'époque. Définit le temps de visite à cette valeur. Si ce n'est pas fourni, l'heure actuelle sera enregistrée. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### Valeur retournée -<p>{{Compat("webextensions.api.history.addUrl")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera rempli sans paramètres lorsque l'élément a été ajouté. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Ajoutez un enregistrement d'une visite à "https://example.org/", puis vérifiez que la nouvelle visite a été enregistrée en recherchant l'historique de l'élément le plus récent et en l'enregistrant :</p> +{{Compat("webextensions.api.history.addUrl")}} -<pre class="brush: js">function onGot(results) { +## Exemples + +Ajoutez un enregistrement d'une visite à "https\://example.org/", puis vérifiez que la nouvelle visite a été enregistrée en recherchant l'historique de l'élément le plus récent et en l'enregistrant : + +```js +function onGot(results) { if (results.length) { console.log(results[0].url); console.log(new Date(results[0].lastVisitTime)); @@ -73,11 +72,13 @@ function onAdded() { } var addingUrl = browser.history.addUrl({url: "https://example.org/"}); -addingUrl.then(onAdded);</pre> +addingUrl.then(onAdded); +``` -<p>Ajouter un enregistrement d'une visite à "https://example.org", mais lui donner une <code>visitTime</code> de 24 heures dans le passé, et une <code>transition</code> "typed":</p> +Ajouter un enregistrement d'une visite à "https\://example.org", mais lui donner une `visitTime` de 24 heures dans le passé, et une `transition` "typed": -<pre class="brush: js">const DAY = 24 * 60* 60 * 1000; +```js +const DAY = 24 * 60* 60 * 1000; function oneDayAgo() { return Date.now() - DAY; @@ -104,19 +105,18 @@ var addingUrl = browser.history.addUrl({ transition: "typed" }); -addingUrl.then(onAdded);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +addingUrl.then(onAdded); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -143,5 +143,4 @@ addingUrl.then(onAdded);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md index 924eb064e1..7e110263f5 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleteall/index.md @@ -13,36 +13,38 @@ tags: - deleteAll translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteAll --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites de l'historique du navigateur.</p> +Supprime toutes les visites de l'historique du navigateur. -<p>Cette fonction déclenche {{WebExtAPIRef("history.onVisitRemoved")}} une seule fois, avec <code>allHistory</code> défini sur <code>true</code> et un argument <code>urls</code> vide.</p> +Cette fonction déclenche {{WebExtAPIRef("history.onVisitRemoved")}} une seule fois, avec `allHistory` défini sur `true` et un argument `urls` vide. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var deletingAll = browser.history.deleteAll() -</pre> +```js +var deletingAll = browser.history.deleteAll() +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>None.</p> +None. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie sans paramètre lorsque tout l'historique a été supprimé.</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramètre lorsque tout l'historique a été supprimé. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.history.deleteAll")}}</p> +{{Compat("webextensions.api.history.deleteAll")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Supprimer tout l'historique lorsque l'utilisateur clique sur une action du navigateur :</p> +Supprimer tout l'historique lorsque l'utilisateur clique sur une action du navigateur : -<pre class="brush: js">function onDeleteAll() { +```js +function onDeleteAll() { console.log("Deleted all history"); } @@ -51,19 +53,18 @@ function deleteAllHistory() { deletingAll.then(onDeleteAll); } -deleteAllHistory();</pre> +deleteAllHistory(); +``` -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -90,5 +91,4 @@ deleteAllHistory();</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md index 732978f38f..a513277480 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleterange/index.md @@ -13,46 +13,45 @@ tags: - deleteRange translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteRange --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites aux pages que l'utilisateur a effectuées pendant la période donnée. Si cela supprime toutes les visites effectuées sur une page donnée, alors la page n'apparaîtra plus dans l'historique du navigateur et {{WebExtAPIRef("history.onVisitRemoved")}} se déclenchera pour cela.</p> +Supprime toutes les visites aux pages que l'utilisateur a effectuées pendant la période donnée. Si cela supprime toutes les visites effectuées sur une page donnée, alors la page n'apparaîtra plus dans l'historique du navigateur et {{WebExtAPIRef("history.onVisitRemoved")}} se déclenchera pour cela. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var deletingRange = browser.history.deleteRange( +```js +var deletingRange = browser.history.deleteRange( range // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>range</code></dt> - <dd><p><code>object</code>. Spécification de la plage de temps pour laquelle supprimer des visites.</p> - <dl> - <dt><code>startTime</code></dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut être représenté par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaîne de de date ISO 8601</a>, ou le nombre de <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'époque</a>. Spécifie l'heure de début de la plage.</dd> - <dt><code>endTime</code></dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut être représenté par: un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaîne de date ISO 8601</a>, ou le nombre de <a href="https://en.wikipedia.org/wiki/Unix_time">millisecondes depuis l'époque</a>. Spécifie l'heure de fin de la plage.</dd> - </dl> - </dd> -</dl> +- `range` -<h3 id="Valeur_retournée">Valeur retournée</h3> + - : `object`. Spécification de la plage de temps pour laquelle supprimer des visites. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie sans paramètre lorsque la plage a été supprimée.</p> + - `startTime` + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut être représenté par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaîne de de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de [millisecondes depuis l'époque](https://en.wikipedia.org/wiki/Unix_time). Spécifie l'heure de début de la plage. + - `endTime` + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut être représenté par: un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaîne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de [millisecondes depuis l'époque](https://en.wikipedia.org/wiki/Unix_time). Spécifie l'heure de fin de la plage. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### Valeur retournée -<p>{{Compat("webextensions.api.history.deleteRange")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramètre lorsque la plage a été supprimée. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Supprimer toutes les visites effectuées à la dernière minute :</p> +{{Compat("webextensions.api.history.deleteRange")}} -<pre class="brush: js">const MINUTE = 60 * 1000; +## Exemples + +Supprimer toutes les visites effectuées à la dernière minute : + +```js +const MINUTE = 60 * 1000; function oneMinuteAgo() { return Date.now() - MINUTE; @@ -61,19 +60,18 @@ function oneMinuteAgo() { browser.history.deleteRange({ startTime: oneMinuteAgo(), endTime: Date.now() -});</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +}); +``` -<p>This API is based on Chromium's <a href="https://developer.chrome.com/extensions/history#method-deleteRange"><code>chrome.history</code></a> API. This documentation is derived from <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> in the Chromium code.</p> +{{WebExtExamples}} -<p>Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.</p> -</div> +> **Note :** +> +> This API is based on Chromium's [`chrome.history`](https://developer.chrome.com/extensions/history#method-deleteRange) API. This documentation is derived from [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) in the Chromium code. +> +> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -100,5 +98,4 @@ browser.history.deleteRange({ // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md index 18259c9485..7c4402a1b6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/deleteurl/index.md @@ -13,44 +13,43 @@ tags: - deleteUrl translation_of: Mozilla/Add-ons/WebExtensions/API/history/deleteUrl --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Supprime toutes les visites à l'URL donnée de l'historique du navigateur.</p> +Supprime toutes les visites à l'URL donnée de l'historique du navigateur. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var deletingUrl = browser.history.deleteUrl( +```js +var deletingUrl = browser.history.deleteUrl( details // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>. Objet contenant l'URL dont les visites doivent être supprimées.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL dont les visites doivent être supprimées.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="Valeur_retournée">Valeur retournée</h3> + - : `object`. Objet contenant l'URL dont les visites doivent être supprimées. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie sans paramètres lorsque les visites auront été supprimées.</p> + - `url` + - : `string`. L'URL dont les visites doivent être supprimées. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### Valeur retournée -<p>{{Compat("webextensions.api.history.deleteUrl")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie sans paramètres lorsque les visites auront été supprimées. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Supprimez toutes les visites de "https://example.org/" de l'historique, puis vérifiez que cette URL n'est plus renvoyée par {{WebExtAPIRef("history.search()")}}:</p> +{{Compat("webextensions.api.history.deleteUrl")}} -<pre class="brush: js">var urlToRemove = "https://example.org/"; +## Exemples + +Supprimez toutes les visites de "https\://example.org/" de l'historique, puis vérifiez que cette URL n'est plus renvoyée par {{WebExtAPIRef("history.search()")}}: + +```js +var urlToRemove = "https://example.org/"; function onGot(results) { if (!results.length) { @@ -71,11 +70,13 @@ function onRemoved() { var deletingUrl = browser.history.deleteUrl({url: urlToRemove}); -deletingUrl.then(onRemoved);</pre> +deletingUrl.then(onRemoved); +``` -<p>Supprimez la dernière page visitée de l'historique, avec un écouteur à {{WebExtAPIRef("history.onVisitRemoved")}} pour consigner l'URL de la page supprimée :</p> +Supprimez la dernière page visitée de l'historique, avec un écouteur à {{WebExtAPIRef("history.onVisitRemoved")}} pour consigner l'URL de la page supprimée : -<pre class="brush: js">function onRemoved(removeInfo) { +```js +function onRemoved(removeInfo) { if (removeInfo.urls.length) { console.log("Removed: " + removeInfo.urls[0]); } @@ -96,19 +97,18 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(onGot);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +searching.then(onGot); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -135,5 +135,4 @@ searching.then(onGot);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md index c33457b87d..7fa7967c6d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/getvisits/index.md @@ -13,44 +13,43 @@ tags: - getVisits translation_of: Mozilla/Add-ons/WebExtensions/API/history/getVisits --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Récupère des informations sur toutes les visites de l'URL donnée.</p> +Récupère des informations sur toutes les visites de l'URL donnée. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var getting = browser.history.getVisits( +```js +var getting = browser.history.getVisits( details // object ) -</pre> +``` -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>details</code></dt> - <dd><p><code>object</code>.</p> - <dl> - <dt><code>url</code></dt> - <dd><code>string</code>. L'URL pour laquelle récupérer les informations de visite.</dd> - </dl> - </dd> -</dl> +- `details` -<h3 id="valeur_retournée">valeur retournée</h3> + - : `object`. -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie avec un tableau d'objets <code>{{WebExtAPIRef('history.VisitItem')}}</code> représentant chacun une visite à l'URL donnée. Les visites sont triées dans l'ordre chronologique inverse.</p> + - `url` + - : `string`. L'URL pour laquelle récupérer les informations de visite. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +### valeur retournée -<p>{{Compat("webextensions.api.history.getVisits")}}</p> +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie avec un tableau d'objets `{{WebExtAPIRef('history.VisitItem')}}` représentant chacun une visite à l'URL donnée. Les visites sont triées dans l'ordre chronologique inverse. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Liste toutes les visites de la page la plus récemment visitée :</p> +{{Compat("webextensions.api.history.getVisits")}} -<pre class="brush: js">function gotVisits(visits) { +## Exemples + +Liste toutes les visites de la page la plus récemment visitée : + +```js +function gotVisits(visits) { console.log("Visit count: " + visits.length); for (visit of visits) { console.log(visit.visitTime); @@ -73,19 +72,18 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(listVisits);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +searching.then(listVisits); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -112,5 +110,4 @@ searching.then(listVisits);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md index 0e9da92609..a5a79b11c7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/historyitem/index.md @@ -13,44 +13,40 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/HistoryItem --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Un objet <code>HistoryItem</code> fournit des informations sur une page dans l'historique du navigateur.</p> +Un objet `HistoryItem` fournit des informations sur une page dans l'historique du navigateur. -<h2 id="Type">Type</h2> +## Type -<p>C'est un objet avec les propriétés suivantes :</p> +C'est un objet avec les propriétés suivantes : -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. Identifiant unique pour l'article.</dd> - <dt><code>url</code> {{optional_inline}}</dt> - <dd><code>string</code>. L'URL de la page.</dd> - <dt><code>title</code> {{optional_inline}}</dt> - <dd><code>string</code>. Le titre de la page.</dd> - <dt><code>lastVisitTime</code> {{optional_inline}}</dt> - <dd><code>number</code>. Date et heure du dernier chargement de la page, représentée en millisecondes depuis l'époque.</dd> - <dt><code>visitCount</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre de fois que l'utilisateur a visité la page.</dd> - <dt><code>typedCount</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre de fois que l'utilisateur a navigué sur cette page en tapant l'adresse.</dd> -</dl> +- `id` + - : `string`. Identifiant unique pour l'article. +- `url` {{optional_inline}} + - : `string`. L'URL de la page. +- `title` {{optional_inline}} + - : `string`. Le titre de la page. +- `lastVisitTime` {{optional_inline}} + - : `number`. Date et heure du dernier chargement de la page, représentée en millisecondes depuis l'époque. +- `visitCount` {{optional_inline}} + - : `number`. Le nombre de fois que l'utilisateur a visité la page. +- `typedCount` {{optional_inline}} + - : `number`. Le nombre de fois que l'utilisateur a navigué sur cette page en tapant l'adresse. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.history.HistoryItem")}}</p> +{{Compat("webextensions.api.history.HistoryItem")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -77,5 +73,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/HistoryItem // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/index.md index ff8c4ff2eb..ffeb70276d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/index.md @@ -12,96 +12,74 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history --- -<div>{{AddonSidebar}}</div> - -<p>Utilisez l'API <code>historique</code> pour interargir avec l'historique du navigateur.</p> - -<p>Si vous recherchez des informations sur l'historique de session du navigateur, consultez l'<a href="/fr/docs/Web/API/History">interface historique</a>.</p> - -<div class="note"> -<p><strong>Note :</strong> Les téléchargements sont traités comme des objets <a href="/fr/Add-ons/WebExtensions/API/history/HistoryItem"><code>HistoryItem</code></a>. Par conséquent, des événements tels que <a href="/fr/Add-ons/WebExtensions/API/history/onVisited"><code>history.onVisited</code></a> seront également déclenchés pour les téléchargements.</p> -</div> - -<p>L'historique du navigateur est un enregistrement chronologique des pages que l'utilisateur a visitées. l'API d'historique vous permet de :</p> - -<ul> - <li><a href="/fr/Add-ons/WebExtensions/API/history/search">Recherchez dans des pagesqui apparaissent dans l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteUrl">Supprimer des pages individuelles de l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/addUrl">Ajouter des pages à l'historique du navigateur</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteAll">Supprimer toutes les pages de l'historique du navigateur</a>.</li> -</ul> - -<p>Cependant, l'utilisateur peut avoir visité une seule page, plusieurs fois, de sorte que l'API a également le concept de"visites". Vous pouvez également utiliser cette API pour :</p> - -<ul> - <li><a href="/fr/Add-ons/WebExtensions/API/history/getVisits">Récupérer l'ensemble des visites effectuées par l'utilisateur sur une page particulière</a></li> - <li><a href="/fr/Add-ons/WebExtensions/API/history/deleteRange">Supprimer les visites à toutes les pages faites pendant une période de temps</a>.</li> -</ul> - -<p>Pour utiliser cette API, une extension doit demander la <a href="/fr/Add-ons/WebExtensions/manifest.json/permissions">permission</a> "history" dans le fichier <code><a href="/fr/Add-ons/WebExtensions/manifest.json">manifest.json</a></code>.</p> - -<h2 id="Types">Types</h2> - -<dl> - <dt>{{WebExtAPIRef("history.TransitionType")}}</dt> - <dd>Décrit comment le navigateur a navigué vers une page particulière.</dd> - <dt>{{WebExtAPIRef("history.HistoryItem")}}</dt> - <dd> - <p>Fournit des informations sur une page particulière dans l'historique du navigateur.</p> - </dd> - <dt>{{WebExtAPIRef("history.VisitItem")}}</dt> - <dd> - <p>Décrit une seule visite sur une page.</p> - </dd> -</dl> - -<h2 id="Fonctions">Fonctions</h2> - -<dl> - <dt>{{WebExtAPIRef("history.search()")}}</dt> - <dd>Recherche dans l'historique du navigateur les objets <a href="/fr/Add-ons/WebExtensions/API/History/HistoryItem"><code>history.HistoryItem</code></a> correspondant aux critères donnés.</dd> - <dt>{{WebExtAPIRef("history.getVisits()")}}</dt> - <dd>Récupère des informations sur les visites sur une page donnée.</dd> - <dt>{{WebExtAPIRef("history.addUrl()")}}</dt> - <dd>Ajoute un enregistrement à l'historique du navigateur d'une visite sur la page donnée.</dd> - <dt>{{WebExtAPIRef("history.deleteUrl()")}}</dt> - <dd>Supprime toutes les visites à l'URL donnée de l'historique du navigateur.</dd> - <dt>{{WebExtAPIRef("history.deleteRange()")}}</dt> - <dd>Supprime toutes les visites aux pages que l'utilisateur a effectuées pendant la période donnée.</dd> - <dt>{{WebExtAPIRef("history.deleteAll()")}}</dt> - <dd>Supprime toutes les visites de l'historique du navigateur.</dd> -</dl> - -<h2 id="Evénements">Evénements</h2> - -<dl> - <dt>{{WebExtAPIRef("history.onTitleChanged")}}</dt> - <dd> - <div>Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.</div> - </dd> - <dt>{{WebExtAPIRef("history.onVisited")}}</dt> - <dd>Lancé chaque fois que l'utilisateur visite une page, en fournissant les données {{WebExtAPIRef("history.HistoryItem")}} pour cette page.</dd> - <dt>{{WebExtAPIRef("history.onVisitRemoved")}}</dt> - <dd> - <p>Lancé lorsqu'une URL est complètement supprimée de l'historique du navigateur.</p> - </dd> -</dl> - -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> - -<p>{{Compat("webextensions.api.history")}}</p> - -<p>{{WebExtExamples("h2")}}</p> - -<div class="note"><p><strong>Note :</strong></p> - -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +{{AddonSidebar}} + +Utilisez l'API `historique` pour interargir avec l'historique du navigateur. + +Si vous recherchez des informations sur l'historique de session du navigateur, consultez l'[interface historique](/fr/docs/Web/API/History). + +> **Note :** Les téléchargements sont traités comme des objets [`HistoryItem`](/fr/Add-ons/WebExtensions/API/history/HistoryItem). Par conséquent, des événements tels que [`history.onVisited`](/fr/Add-ons/WebExtensions/API/history/onVisited) seront également déclenchés pour les téléchargements. + +L'historique du navigateur est un enregistrement chronologique des pages que l'utilisateur a visitées. l'API d'historique vous permet de : + +- [Recherchez dans des pagesqui apparaissent dans l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/search) +- [Supprimer des pages individuelles de l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/deleteUrl) +- [Ajouter des pages à l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/addUrl) +- [Supprimer toutes les pages de l'historique du navigateur](/fr/Add-ons/WebExtensions/API/history/deleteAll). + +Cependant, l'utilisateur peut avoir visité une seule page, plusieurs fois, de sorte que l'API a également le concept de"visites". Vous pouvez également utiliser cette API pour : + +- [Récupérer l'ensemble des visites effectuées par l'utilisateur sur une page particulière](/fr/Add-ons/WebExtensions/API/history/getVisits) +- [Supprimer les visites à toutes les pages faites pendant une période de temps](/fr/Add-ons/WebExtensions/API/history/deleteRange). + +Pour utiliser cette API, une extension doit demander la [permission](/fr/Add-ons/WebExtensions/manifest.json/permissions) "history" dans le fichier [`manifest.json`](/fr/Add-ons/WebExtensions/manifest.json). + +## Types + +- {{WebExtAPIRef("history.TransitionType")}} + - : Décrit comment le navigateur a navigué vers une page particulière. +- {{WebExtAPIRef("history.HistoryItem")}} + - : Fournit des informations sur une page particulière dans l'historique du navigateur. +- {{WebExtAPIRef("history.VisitItem")}} + - : Décrit une seule visite sur une page. + +## Fonctions + +- {{WebExtAPIRef("history.search()")}} + - : Recherche dans l'historique du navigateur les objets [`history.HistoryItem`](/fr/Add-ons/WebExtensions/API/History/HistoryItem) correspondant aux critères donnés. +- {{WebExtAPIRef("history.getVisits()")}} + - : Récupère des informations sur les visites sur une page donnée. +- {{WebExtAPIRef("history.addUrl()")}} + - : Ajoute un enregistrement à l'historique du navigateur d'une visite sur la page donnée. +- {{WebExtAPIRef("history.deleteUrl()")}} + - : Supprime toutes les visites à l'URL donnée de l'historique du navigateur. +- {{WebExtAPIRef("history.deleteRange()")}} + - : Supprime toutes les visites aux pages que l'utilisateur a effectuées pendant la période donnée. +- {{WebExtAPIRef("history.deleteAll()")}} + - : Supprime toutes les visites de l'historique du navigateur. + +## Evénements + +- {{WebExtAPIRef("history.onTitleChanged")}} + - : Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré. +- {{WebExtAPIRef("history.onVisited")}} + - : Lancé chaque fois que l'utilisateur visite une page, en fournissant les données {{WebExtAPIRef("history.HistoryItem")}} pour cette page. +- {{WebExtAPIRef("history.onVisitRemoved")}} + - : Lancé lorsqu'une URL est complètement supprimée de l'historique du navigateur. + +## Compatibilité du navigateur + +{{Compat("webextensions.api.history")}} + +{{WebExtExamples("h2")}} + +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. + +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -128,5 +106,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md index aa3124d95e..5371ad6a99 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/ontitlechanged/index.md @@ -11,80 +11,64 @@ tags: - onTitleChanged translation_of: Mozilla/Add-ons/WebExtensions/API/history/onTitleChanged --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}}Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.Pour écouter les visites d'une page, vous pouvez utiliser {{WebExtAPIRef("history.onVisited")}}. Cependant, le {{WebExtAPIRef("history.HistoryItem")}} que cet événement passe à son écouteur n'inclut pas le titre de la page, car le titre de la page n'est généralement pas connu au moment où `history.onVisited` est envoyé.Au lieu de cela, {{WebExtAPIRef("history.HistoryItem")}} stocké est mis à jour avec le titre de la page après le chargement de la page, une fois le titre connu. L'événement history.onTitleChanged est déclenché à ce moment-là. Donc, si vous avez besoin de connaître les titres des pages telles qu'elles sont visitées, écoutez `history.onTitleChanged`. -<div>Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.</div> +## Syntaxe -<div></div> - -<div>Pour écouter les visites d'une page, vous pouvez utiliser {{WebExtAPIRef("history.onVisited")}}. Cependant, le {{WebExtAPIRef("history.HistoryItem")}} que cet événement passe à son écouteur n'inclut pas le titre de la page, car le titre de la page n'est généralement pas connu au moment où <code>history.onVisited</code> est envoyé.</div> - -<div></div> - -<div>Au lieu de cela, {{WebExtAPIRef("history.HistoryItem")}} stocké est mis à jour avec le titre de la page après le chargement de la page, une fois le titre connu. L'événement history.onTitleChanged est déclenché à ce moment-là. Donc, si vous avez besoin de connaître les titres des pages telles qu'elles sont visitées, écoutez <code>history.onTitleChanged</code>.</div> - -<h2 id="Syntaxe">Syntaxe</h2> - -<pre class="brush: js">browser.history.onTitleChanged.addListener(listener) +```js +browser.history.onTitleChanged.addListener(listener) browser.history.onTitleChanged.removeListener(listener) browser.history.onTitleChanged.hasListener(listener) -</pre> +``` + +Les événements ont trois fonctions : -<p>Les événements ont trois fonctions :</p> +- `addListener(listener)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument `listener` argument est l'écouteur à supprimer +- `hasListener(listener)` + - : Vérifiez si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -<dl> - <dt><code>addListener(listener)</code></dt> - <dd>Ajoute un écouteur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouter cet événement. L'argument <code>listener</code> argument est l'écouteur à supprimer</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifiez si <code>listener</code> est enregistré pour cet événement. Renvoie <code>true</code> s'il écoute, sinon <code>false</code>.</dd> -</dl> +## Syntaxe addListener -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +### Paramètres -<h3 id="Paramètres">Paramètres</h3> +- `callback` -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Function that will be called when this event occurs. The function will be passed an object with the following properties:</p> + - : Function that will be called when this event occurs. The function will be passed an object with the following properties: - <dl> - <dt><code>url</code></dt> - <dd><code>String</code>. URL of the page visited.</dd> - <dt><code>title</code></dt> - <dd><code>String</code>. Title of the page visited.</dd> - </dl> - </dd> -</dl> + - `url` + - : `String`. URL of the page visited. + - `title` + - : `String`. Title of the page visited. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.history.onTitleChanged")}}</p> +{{Compat("webextensions.api.history.onTitleChanged")}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>Écoutez les événements de changement de titre et consignez l'URL et le titre des pages visitées</p> +Écoutez les événements de changement de titre et consignez l'URL et le titre des pages visitées -<pre class="brush: js">function handleTitleChanged(item) { +```js +function handleTitleChanged(item) { console.log(item.title); console.log(item.url); } -browser.history.onTitleChanged.addListener(handleTitleChanged);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onTitleChanged.addListener(handleTitleChanged); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -111,5 +95,4 @@ browser.history.onTitleChanged.addListener(handleTitleChanged);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md index 20a507a95d..a5c16a414b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/onvisited/index.md @@ -13,74 +13,67 @@ tags: - onVisited translation_of: Mozilla/Add-ons/WebExtensions/API/history/onVisited --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Mise en place à chaque fois que l'utilisateur visite une page. Un objet {{WebExtAPIRef("history.HistoryItem")}} est transmis à l'écouteur. Cet événement se déclenche avant que la page ne soit chargée.</p> +Mise en place à chaque fois que l'utilisateur visite une page. Un objet {{WebExtAPIRef("history.HistoryItem")}} est transmis à l'écouteur. Cet événement se déclenche avant que la page ne soit chargée. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.history.onVisited.addListener(listener) +```js +browser.history.onVisited.addListener(listener) browser.history.onVisited.removeListener(listener) browser.history.onVisited.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions :</p> +Les événements ont trois fonctions : -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un écouteur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouter cet événement. L'argument <code>listener</code> est l'écouteur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifie si <code>listener</code> est enregistré pour cet événement. Renvoie <code>true</code> s'il écoute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer. +- `hasListener(listener)` + - : Vérifie si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>callback</code></dt> - <dd> - <p>Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :</p> +- `callback` - <dl> - <dt><code>result</code></dt> - <dd> - <p>{{WebExtAPIRef('history.HistoryItem')}}. Un objet représentant l'élément dans l'historique du navigateur.</p> + - : Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants : - <p>Au moment où cet événement est envoyé, le navigateur ne connaît pas encore le titre de la page. Si le navigateur a déjà visité cette page et s'est souvenu de son ancien titre, l'objet <code>HistoryItem.title</code> contiendra l'ancien titre de la page. Si le navigateur n'a pas d'enregistrement de l'ancien titre de la page, alors <code>HistoryItem.title</code> sera vide. Pour obtenir les titres des pages dès qu'ils sont connus, écoutez {{WebExtAPIRef("history.onTitleChanged")}}.</p> - </dd> - </dl> - </dd> -</dl> + - `result` -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - : {{WebExtAPIRef('history.HistoryItem')}}. Un objet représentant l'élément dans l'historique du navigateur. -<p>{{Compat("webextensions.api.history.onVisited")}}</p> + Au moment où cet événement est envoyé, le navigateur ne connaît pas encore le titre de la page. Si le navigateur a déjà visité cette page et s'est souvenu de son ancien titre, l'objet `HistoryItem.title` contiendra l'ancien titre de la page. Si le navigateur n'a pas d'enregistrement de l'ancien titre de la page, alors `HistoryItem.title` sera vide. Pour obtenir les titres des pages dès qu'ils sont connus, écoutez {{WebExtAPIRef("history.onTitleChanged")}}. -<h2 id="Exemples">Exemples</h2> +## Compatibilité du navigateur -<p>Écoutez les visites et consignez l'URL et l'heure de visite.</p> +{{Compat("webextensions.api.history.onVisited")}} -<pre class="brush: js">function onVisited(historyItem) { +## Exemples + +Écoutez les visites et consignez l'URL et l'heure de visite. + +```js +function onVisited(historyItem) { console.log(historyItem.url); console.log(new Date(historyItem.lastVisitTime)); } -browser.history.onVisited.addListener(onVisited);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onVisited.addListener(onVisited); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -107,5 +100,4 @@ browser.history.onVisited.addListener(onVisited);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md index 57e2a4a063..14317d8a5c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/onvisitremoved/index.md @@ -13,60 +13,54 @@ tags: - onVisitRemoved translation_of: Mozilla/Add-ons/WebExtensions/API/history/onVisitRemoved --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Lancé lorsqu'une page est complètement supprimée de l'historique du navigateur.</p> +Lancé lorsqu'une page est complètement supprimée de l'historique du navigateur. -<ul> - <li>Si toutes les visites d'une seule page sont supprimées (par exemple, en utilisant {{WebExtAPIRef("history.deleteUrl")}}), cet événement est déclenché une fois.</li> - <li>Si une série de visites est supprimée (par exemple, en utilisant {{WebExtAPIRef("history.deleteRange")}} ou une fonctionnalité de navigateur telle que "Effacer l'historique récent"), alors il est tiré une fois pour chaque page <em>dont les visites tombent toutes dans la plage autorisée</em>.</li> - <li>Si l'historique complet du navigateur est effacé (par exemple, en utilisant {{WebExtAPIRef("history.deleteAll")}}), il est déclenché une seule fois.</li> -</ul> +- Si toutes les visites d'une seule page sont supprimées (par exemple, en utilisant {{WebExtAPIRef("history.deleteUrl")}}), cet événement est déclenché une fois. +- Si une série de visites est supprimée (par exemple, en utilisant {{WebExtAPIRef("history.deleteRange")}} ou une fonctionnalité de navigateur telle que "Effacer l'historique récent"), alors il est tiré une fois pour chaque page _dont les visites tombent toutes dans la plage autorisée_. +- Si l'historique complet du navigateur est effacé (par exemple, en utilisant {{WebExtAPIRef("history.deleteAll")}}), il est déclenché une seule fois. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">browser.history.onVisitRemoved.addListener(listener) +```js +browser.history.onVisitRemoved.addListener(listener) browser.history.onVisitRemoved.removeListener(listener) browser.history.onVisitRemoved.hasListener(listener) -</pre> +``` -<p>Les événements ont trois fonctions:</p> +Les événements ont trois fonctions: -<dl> - <dt><code>addListener(callback)</code></dt> - <dd>Ajoute un écouteur à cet événement.</dd> - <dt><code>removeListener(listener)</code></dt> - <dd>Arrêtez d'écouter cet événement. L'argument <code>listener</code> est l'écouteur à supprimer.</dd> - <dt><code>hasListener(listener)</code></dt> - <dd>Vérifiez si <code>listener</code> est enregistré pour cet événement. Renvoie <code>true</code> s'il écoute, sinon <code>false</code>.</dd> -</dl> +- `addListener(callback)` + - : Ajoute un écouteur à cet événement. +- `removeListener(listener)` + - : Arrêtez d'écouter cet événement. L'argument `listener` est l'écouteur à supprimer. +- `hasListener(listener)` + - : Vérifiez si `listener` est enregistré pour cet événement. Renvoie `true` s'il écoute, sinon `false`. -<h2 id="Syntaxe_addListener">Syntaxe addListener</h2> +## Syntaxe addListener -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>callback</code></dt> - <dd><p>Fonction qui sera appelée lorsque cet événement se produit. La fonction sera passée l'argument suivant :</p> - <dl> - <dt><code>removed</code></dt> - <dd><p><code>object</code>. Détails de l'enlèvement. C'est un objet contenant deux propriétés: un booléen <code>allHistory</code> et un tableau <code>urls</code>.</p> - <ul> - <li>Si cet événement se déclenche parce qu'il est clair, <code>allHistory</code> sera <code>true</code> et <code>urls</code> sera un tableau vide.</li> - <li>Dans le cas contraire, <code>allHistory</code> sera <code>false</code> et <code>urls</code> contiendront un qui est l'URL de la page supprimée.</li> - </ul> - </dd> - </dl> - </dd> -</dl> +- `callback` -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> + - : Fonction qui sera appelée lorsque cet événement se produit. La fonction sera passée l'argument suivant : -<p>{{Compat("webextensions.api.history.onVisitRemoved")}}</p> + - `removed` -<h2 id="Exemples">Exemples</h2> + - : `object`. Détails de l'enlèvement. C'est un objet contenant deux propriétés: un booléen `allHistory` et un tableau `urls`. -<pre class="brush: js">function onRemoved(removed) { + - Si cet événement se déclenche parce qu'il est clair, `allHistory` sera `true` et `urls` sera un tableau vide. + - Dans le cas contraire, `allHistory` sera `false` et `urls` contiendront un qui est l'URL de la page supprimée. + +## Compatibilité du navigateur + +{{Compat("webextensions.api.history.onVisitRemoved")}} + +## Exemples + +```js +function onRemoved(removed) { if (removed.allHistory) { console.log("All history removed"); } else if (removed.urls.length) { @@ -74,19 +68,18 @@ browser.history.onVisitRemoved.hasListener(listener) } } -browser.history.onVisitRemoved.addListener(onRemoved);</pre> - -<p>{{WebExtExamples}}</p> - -<div class="note"><p><strong>Note :</strong></p> +browser.history.onVisitRemoved.addListener(onRemoved); +``` -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{WebExtExamples}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -113,5 +106,4 @@ browser.history.onVisitRemoved.addListener(onRemoved);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md index 9538c36511..4ed3e94435 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/search/index.md @@ -13,55 +13,61 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/search --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Recherche dans l'historique du navigateur les objets {{WebExtAPIRef("history.HistoryItem")}} correspondant aux critères donnés.</p> +Recherche dans l'historique du navigateur les objets {{WebExtAPIRef("history.HistoryItem")}} correspondant aux critères donnés. -<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p> +C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="brush: js">var searching = browser.history.search( +```js +var searching = browser.history.search( query // object ) -</pre> - -<h3 id="Paramètres">Paramètres</h3> - -<dl> - <dt><code>query</code></dt> - <dd><p>Un objet qui indique ce qu'il faut rechercher dans l'historique du navigateur. Cet objet a les champs suivants :</p> - <dl> - <dt><code>text</code></dt> - <dd><p><code>string</code>. Rechercher des éléments d'historique par URL et titre. La chaîne est divisée en termes de recherche distincts aux limites de l'espace. Chaque terme de recherche est insensible à la casse par rapport à l'URL et au titre de l'élément d'historique. L'élément d'historique sera renvoyé si tous les termes de recherche correspondent.</p> - <p>Par exemple, considérez cet article :</p> - <p><p>URL: <code>"http://example.org"</code></p> - <p>Title: <code>"Example Domain"</code></p> - <pre>"http" -> matches -"domain" -> matches -"MAIN ample" -> matches -"main tt" -> matches -"main https" -> does not match</pre> - <p>Spécifiez une chaîne vide (<code>""</code>) pour récupérer tous les objets {{WebExtAPIRef("history.HistoryItem")}} qui répondent à tous les autres critères.</p></dd> - <dt><code>startTime</code> {{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut être représenté par : un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaîne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'époque. Si elle est fournie, cette option exclut les résultats dont <code>lastVisitTime</code> est antérieure à cette heure. Si elle est omise, la recherche est limitée aux dernières 24 heures.</dd> - <dt><code>endTime</code> {{optional_inline}}</dt> - <dd><code>number</code> ou <code>string</code> ou <code>object</code>. Une valeur indiquant une date et une heure. Cela peut être représenté par : un objet <code><a href="/fr/docs/Web/JavaScript/Reference/Global_Objects/Date">Date</a></code>, une <a href="http://www.iso.org/iso/home/standards/iso8601.htm">chaîne de date ISO 8601</a>, ou le nombre de millisecondes depuis l'époque. Si elle est fournie, cette option exclut les résultats dont <code>lastVisitTime</code> est postérieur à cette fois. Si elle est omise, toutes les entrées sont prises en compte à partir de l'heure de début.</dd> - <dt><code>maxResults</code> {{optional_inline}}</dt> - <dd><code>number</code>. Le nombre maximum de résultats à récupérer. La valeur par défaut est 100, avec une valeur minimale de 1. La fonction renvoie une erreur si vous lui transmettez une valeur <code>maxResults</code> inférieure à 1.</dd> - </dl> - </dd> -</dl> - -<h3 id="Valeur_retournée">Valeur retournée</h3> - -<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> sera remplie avec un tableau d'objets de type {{WebExtAPIRef("history.HistoryItem")}}, chacun décrivant un seul élément d'historique correspondant. Les articles sont triés dans l'ordre chronologique inverse.</p> - -<h2 id="Exemples">Exemples</h2> - -<p>Consigne l'URL et la dernière heure de visite pour tous les éléments d'historique visités au cours des dernières 24 heures :</p> - -<pre class="brush: js">function onGot(historyItems) { +``` + +### Paramètres + +- `query` + + - : Un objet qui indique ce qu'il faut rechercher dans l'historique du navigateur. Cet objet a les champs suivants : + + - `text` + + - : `string`. Rechercher des éléments d'historique par URL et titre. La chaîne est divisée en termes de recherche distincts aux limites de l'espace. Chaque terme de recherche est insensible à la casse par rapport à l'URL et au titre de l'élément d'historique. L'élément d'historique sera renvoyé si tous les termes de recherche correspondent. + + Par exemple, considérez cet article : + + URL: `"http://example.org"` + + Title: `"Example Domain"` + + "http" -> matches + "domain" -> matches + "MAIN ample" -> matches + "main tt" -> matches + "main https" -> does not match + + Spécifiez une chaîne vide (`""`) pour récupérer tous les objets {{WebExtAPIRef("history.HistoryItem")}} qui répondent à tous les autres critères. + + - `startTime` {{optional_inline}} + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut être représenté par : un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaîne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'époque. Si elle est fournie, cette option exclut les résultats dont `lastVisitTime` est antérieure à cette heure. Si elle est omise, la recherche est limitée aux dernières 24 heures. + - `endTime` {{optional_inline}} + - : `number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut être représenté par : un objet [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date), une [chaîne de date ISO 8601](http://www.iso.org/iso/home/standards/iso8601.htm), ou le nombre de millisecondes depuis l'époque. Si elle est fournie, cette option exclut les résultats dont `lastVisitTime` est postérieur à cette fois. Si elle est omise, toutes les entrées sont prises en compte à partir de l'heure de début. + - `maxResults` {{optional_inline}} + - : `number`. Le nombre maximum de résultats à récupérer. La valeur par défaut est 100, avec une valeur minimale de 1. La fonction renvoie une erreur si vous lui transmettez une valeur `maxResults` inférieure à 1. + +### Valeur retournée + +Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise) sera remplie avec un tableau d'objets de type {{WebExtAPIRef("history.HistoryItem")}}, chacun décrivant un seul élément d'historique correspondant. Les articles sont triés dans l'ordre chronologique inverse. + +## Exemples + +Consigne l'URL et la dernière heure de visite pour tous les éléments d'historique visités au cours des dernières 24 heures : + +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -70,11 +76,13 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/search var searching = browser.history.search({text: ""}); -searching.then(onGot);</pre> +searching.then(onGot); +``` -<p>Logs the URL and last visit time for all history items ever visited:</p> +Logs the URL and last visit time for all history items ever visited: -<pre class="brush: js">function onGot(historyItems) { +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -86,11 +94,13 @@ var searching = browser.history.search({ startTime: 0 }); -searching.then(onGot);</pre> +searching.then(onGot); +``` -<p>Consigne l'URL et la dernière visite de la dernière visite sur une page contenant la chaîne "mozilla" :</p> +Consigne l'URL et la dernière visite de la dernière visite sur une page contenant la chaîne "mozilla" : -<pre class="brush: js">function onGot(historyItems) { +```js +function onGot(historyItems) { for (item of historyItems) { console.log(item.url); console.log(new Date(item.lastVisitTime)); @@ -103,23 +113,22 @@ var searching = browser.history.search({ maxResults: 1 }); -searching.then(onGot);</pre> - -<p>{{WebExtExamples}}</p> - -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +searching.then(onGot); +``` -<p>{{Compat("webextensions.api.history.search")}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +## Compatibilité du navigateur -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> +{{Compat("webextensions.api.history.search")}} -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -146,5 +155,4 @@ searching.then(onGot);</pre> // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md index c64743e6f1..45a6e3fd23 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/transitiontype/index.md @@ -13,54 +13,50 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/TransitionType --- -<p>{{AddonSidebar()}}</p> +{{AddonSidebar()}} -<p>Ceci décrit comment le navigateur a navigué vers une page particulière. Par exemple, "lien" signifie que le navigateur a navigué vers la page parce que l'utilisateur a cliqué sur un lien</p> +Ceci décrit comment le navigateur a navigué vers une page particulière. Par exemple, "lien" signifie que le navigateur a navigué vers la page parce que l'utilisateur a cliqué sur un lien -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :</p> +Les valeurs de ce type sont des chaînes. Les valeurs possibles sont : -<dl> - <dt>"link"</dt> - <dd>L'utilisateur a cliqué sur un lien dans une autre page.</dd> - <dt>"typed"</dt> - <dd>L'utilisateur a tapé l'URL dans la barre d'adresse. Ceci est également utilisé si l'utilisateur a commencé à taper dans la barre d'adresse, puis sélectionné une URL parmi les suggestions qu'il a proposées. Voir aussi "généré".</dd> - <dt>"auto_bookmark"</dt> - <dd>L'utilisateur a cliqué sur un signet ou un élément dans l'historique du navigateur.</dd> - <dt>"auto_subframe"</dt> - <dd>Les iframes imbriqués qui sont automatiquement chargés par leur parent.</dd> - <dt>"manual_subframe"</dt> - <dd>Les iframes imbriqués chargés en tant qu'action utilisateur explicite. Le chargement d'une telle iframe générera une entrée dans la liste de navigation avant / arrière.</dd> - <dt>"generated"</dt> - <dd>L'utilisateur a commencé à taper dans la barre d'adresse, puis a cliqué sur une entrée suggérée qui ne contenait pas d'URL.</dd> - <dt>"auto_toplevel"</dt> - <dd>La page a été passée à la ligne de commande ou est la page de démarrage.</dd> - <dt>"form_submit"</dt> - <dd>L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraîne pas ce type de transition.</dd> - <dt>"reload"</dt> - <dd>L'utilisateur a rechargé la page en utilisant le bouton Recharger ou en appuyant sur Entrée dans la barre d'adresse. Ceci est également utilisé pour la restauration de session et la réouverture des onglets fermés.</dd> - <dt>"keyword"</dt> - <dd>L'URL a été générée à l'aide d'une <a href="https://support.mozilla.org/en-US/kb/how-search-from-address-bar">recherche par mot clé</a> configuré par l'utilisateur.</dd> - <dt>"keyword_generated"</dt> - <dd>Correspond à une visite générée pour un mot clé.</dd> -</dl> +- "link" + - : L'utilisateur a cliqué sur un lien dans une autre page. +- "typed" + - : L'utilisateur a tapé l'URL dans la barre d'adresse. Ceci est également utilisé si l'utilisateur a commencé à taper dans la barre d'adresse, puis sélectionné une URL parmi les suggestions qu'il a proposées. Voir aussi "généré". +- "auto_bookmark" + - : L'utilisateur a cliqué sur un signet ou un élément dans l'historique du navigateur. +- "auto_subframe" + - : Les iframes imbriqués qui sont automatiquement chargés par leur parent. +- "manual_subframe" + - : Les iframes imbriqués chargés en tant qu'action utilisateur explicite. Le chargement d'une telle iframe générera une entrée dans la liste de navigation avant / arrière. +- "generated" + - : L'utilisateur a commencé à taper dans la barre d'adresse, puis a cliqué sur une entrée suggérée qui ne contenait pas d'URL. +- "auto_toplevel" + - : La page a été passée à la ligne de commande ou est la page de démarrage. +- "form_submit" + - : L'utilisateur a soumis un formulaire. Notez que dans certaines situations, par exemple lorsqu'un formulaire utilise un script pour soumettre son contenu, l'envoi d'un formulaire n'entraîne pas ce type de transition. +- "reload" + - : L'utilisateur a rechargé la page en utilisant le bouton Recharger ou en appuyant sur Entrée dans la barre d'adresse. Ceci est également utilisé pour la restauration de session et la réouverture des onglets fermés. +- "keyword" + - : L'URL a été générée à l'aide d'une [recherche par mot clé](https://support.mozilla.org/en-US/kb/how-search-from-address-bar) configuré par l'utilisateur. +- "keyword_generated" + - : Correspond à une visite générée pour un mot clé. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.history.TransitionType")}}</p> +{{Compat("webextensions.api.history.TransitionType")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -87,5 +83,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/TransitionType // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> diff --git a/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md b/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md index 5a0b34fdd2..d49417ce9a 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/history/visititem/index.md @@ -13,42 +13,38 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/history/VisitItem --- -<div>{{AddonSidebar()}}</div> +{{AddonSidebar()}} -<p>Un objet décrivant une seule visite sur une page.</p> +Un objet décrivant une seule visite sur une page. -<h2 id="Type">Type</h2> +## Type -<p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p> +Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes : -<dl> - <dt><code>id</code></dt> - <dd><code>string</code>. L'identifiant unique du {{WebExtAPIRef("history.HistoryItem")}} associé à cette visite.</dd> - <dt><code>visitId</code></dt> - <dd><code>string</code>. L'identifiant unique pour cette visite.</dd> - <dt><code>visitTime</code>{{optional_inline}}</dt> - <dd><code>number</code>. Lorsque cette visite s'est produite, représentée en millisecondes depuis l'époque.</dd> - <dt><code>referringVisitId</code></dt> - <dd><code>string</code>. L'ID de visite du référent.</dd> - <dt><code>transition</code></dt> - <dd>{{WebExtAPIRef('history.TransitionType')}}. Décrit comment le navigateur a navigué vers la page à cette occasion.</dd> -</dl> +- `id` + - : `string`. L'identifiant unique du {{WebExtAPIRef("history.HistoryItem")}} associé à cette visite. +- `visitId` + - : `string`. L'identifiant unique pour cette visite. +- `visitTime`{{optional_inline}} + - : `number`. Lorsque cette visite s'est produite, représentée en millisecondes depuis l'époque. +- `referringVisitId` + - : `string`. L'ID de visite du référent. +- `transition` + - : {{WebExtAPIRef('history.TransitionType')}}. Décrit comment le navigateur a navigué vers la page à cette occasion. -<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2> +## Compatibilité du navigateur -<p>{{Compat("webextensions.api.history.VisitItem")}}</p> +{{Compat("webextensions.api.history.VisitItem")}} -<p>{{WebExtExamples}}</p> +{{WebExtExamples}} -<div class="note"><p><strong>Note :</strong></p> +> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.history`](https://developer.chrome.com/extensions/history). Cette documentation est dérivée de [`history.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json) dans le code de Chromium. +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -<p>Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/history"><code>chrome.history</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/history.json"><code>history.json</code></a> dans le code de Chromium.</p> - -<p>Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p> -</div> - -<div class="hidden"> -<pre>// Copyright 2015 The Chromium Authors. All rights reserved. +<div class="hidden"><pre>// Copyright 2015 The Chromium Authors. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -75,5 +71,4 @@ translation_of: Mozilla/Add-ons/WebExtensions/API/history/VisitItem // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -</pre> -</div> +</pre></div> |