recursal/MDN huggingface dataset:
history.getVisits()
===================

Récupère des informations sur toutes les visites de l'URL donnée.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var getting = browser.history.getVisits(
  details, // object
);
```

### Paramètres

`details`

`object`.

`url`

`string`. L'URL pour laquelle récupérer les informations de visite.


### Valeur retournée

Une `Promise` sera remplie avec un tableau d'objets ``history.VisitItem`` représentant chacun une visite à l'URL donnée. Les visites sont triées dans l'ordre chronologique inverse.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

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);
  }
}

function listVisits(historyItems) {
  if (historyItems.length) {
    console.log("URL " + historyItems[0].url);
    var gettingVisits = browser.history.getVisits({
      url: historyItems[0].url,
    });
    gettingVisits.then(gotVisits);
  }
}

var searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1,
});

searching.then(listVisits);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.onVisitRemoved
======================

Lancé lorsqu'une page est complètement supprimée de l'historique du navigateur.

* Si toutes les visites d'une seule page sont supprimées (par exemple, en utilisant `history.deleteUrl`), cet événement est déclenché une fois.
* Si une série de visites est supprimée (par exemple, en utilisant `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 `history.deleteAll`), il est déclenché une seule fois.
Syntaxe
-------


```js
browser.history.onVisitRemoved.addListener(listener);
browser.history.onVisitRemoved.removeListener(listener);
browser.history.onVisitRemoved.hasListener(listener);
```


Les événements ont trois fonctions:

`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`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction sera passée l'argument suivant :

`removed`

`object`. Détails de l'enlèvement. C'est un objet contenant deux propriétés: un booléen `allHistory` et un tableau `urls`.

* 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é des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------


```js
function onRemoved(removed) {
  if (removed.allHistory) {
    console.log("All history removed");
  } else if (removed.urls.length) {
    console.log("URL removed: " + removed.urls[0]);
  }
}

browser.history.onVisitRemoved.addListener(onRemoved);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.TransitionType
======================

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

Type
----

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

"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é configuré par l'utilisateur.

"keyword\_generated"

Correspond à une visite générée pour un mot clé.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.deleteAll()
===================

Supprime toutes les visites de l'historique du navigateur.

Cette fonction déclenche `history.onVisitRemoved` une seule fois, avec `allHistory` défini sur `true` et un argument `urls` vide.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var deletingAll = browser.history.deleteAll();
```

### Paramètres

None.

### Valeur retournée

Une `Promise` sera remplie sans paramètre lorsque tout l'historique a été supprimé.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer tout l'historique lorsque l'utilisateur clique sur une action du navigateur :


```js
function onDeleteAll() {
  console.log("Deleted all history");
}

function deleteAllHistory() {
  var deletingAll = browser.history.deleteAll();
  deletingAll.then(onDeleteAll);
}

deleteAllHistory();
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.VisitItem
=================

Un objet décrivant une seule visite sur une page.

Type
----

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

`id`

`string`. L'identifiant unique du `history.HistoryItem` associé à cette visite.

`visitId`

`string`. L'identifiant unique pour cette visite.

`visitTime`Facultatif

`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`

`history.TransitionType`. Décrit comment le navigateur a navigué vers la page à cette occasion.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.addUrl()
================

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 `TransitionType` est enregistré comme "liens".

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var addingUrl = browser.history.addUrl(
  details, // object
);
```

### Paramètres

`details`

`object`. Objet contenant l'URL à ajouter.

`url`

`string`. L'URL à ajouter.

`title`Facultatif

string: Le titre de la page. Si ce n'est pas fourni, le titre sera enregistré comme `null`.

`transition`Facultatif

`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`Facultatif

`number` ou `string` ou `object`. Cela peut être représenté par: un objet `Date`, une chaîne de date ISO 8601, 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.


### Valeur retournée

Une `Promise` sera rempli sans paramètres lorsque l'élément a été ajouté.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

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));
  }
}

function onAdded() {
  var searching = browser.history.search({
    text: "https://example.org/",
    startTime: 0,
    maxResults: 1,
  });
  searching.then(onGot);
}

var addingUrl = browser.history.addUrl({ url: "https://example.org/" });
addingUrl.then(onAdded);
```


Ajouter un enregistrement d'une visite à "https://example.org", mais lui donner une `visitTime` de 24 heures dans le passé, et une `transition` "typed":


```js
const DAY = 24 \* 60 \* 60 \* 1000;

function oneDayAgo() {
  return Date.now() - DAY;
}

function onGot(visits) {
  for (visit of visits) {
    console.log(new Date(visit.visitTime));
    console.log(visit.transition);
  }
}

function onAdded() {
  var gettingVisits = browser.history.getVisits({
    url: "https://example.org/",
  });

  gettingVisits.then(onGot);
}

var addingUrl = browser.history.addUrl({
  url: "https://example.org/",
  visitTime: oneDayAgo(),
  transition: "typed",
});

addingUrl.then(onAdded);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.deleteUrl()
===================

Supprime toutes les visites à l'URL donnée de l'historique du navigateur.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var deletingUrl = browser.history.deleteUrl(
  details, // object
);
```

### Paramètres

`details`

`object`. Objet contenant l'URL dont les visites doivent être supprimées.

`url`

`string`. L'URL dont les visites doivent être supprimées.


### Valeur retournée

Une `Promise` sera remplie sans paramètres lorsque les visites auront été supprimées.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimez toutes les visites de "https://example.org/" de l'historique, puis vérifiez que cette URL n'est plus renvoyée par `history.search()`:


```js
var urlToRemove = "https://example.org/";

function onGot(results) {
  if (!results.length) {
    console.log(urlToRemove + " was removed");
  } else {
    console.log(urlToRemove + " was not removed");
  }
}

function onRemoved() {
  var searching = browser.history.search({
    text: urlToRemove,
    startTime: 0,
  });

  searching.then(onGot);
}

var deletingUrl = browser.history.deleteUrl({ url: urlToRemove });

deletingUrl.then(onRemoved);
```


Supprimez la dernière page visitée de l'historique, avec un écouteur à `history.onVisitRemoved` pour consigner l'URL de la page supprimée :


```js
function onRemoved(removeInfo) {
  if (removeInfo.urls.length) {
    console.log("Removed: " + removeInfo.urls[0]);
  }
}

browser.history.onVisitRemoved.addListener(onRemoved);

function onGot(results) {
  if (results.length) {
    console.log("Removing: " + results[0].url);
    browser.history.deleteUrl({ url: results[0].url });
  }
}

var searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1,
});

searching.then(onGot);
```

### Example extensions

* history-deleter

**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.HistoryItem
===================

Un objet `HistoryItem` fournit des informations sur une page dans l'historique du navigateur.

Type
----

C'est un objet avec les propriétés suivantes :

`id`

`string`. Identifiant unique pour l'article.

`url` Facultatif

`string`. L'URL de la page.

`title` Facultatif

`string`. Le titre de la page.

`lastVisitTime` Facultatif

`number`. Date et heure du dernier chargement de la page, représentée en millisecondes depuis l'époque.

`visitCount` Facultatif

`number`. Le nombre de fois que l'utilisateur a visité la page.

`typedCount` Facultatif

`number`. Le nombre de fois que l'utilisateur a navigué sur cette page en tapant l'adresse.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.onVisited
=================

Mise en place à chaque fois que l'utilisateur visite une page. Un objet `history.HistoryItem` est transmis à l'écouteur. Cet événement se déclenche avant que la page ne soit chargée.

Syntaxe
-------


```js
browser.history.onVisited.addListener(listener);
browser.history.onVisited.removeListener(listener);
browser.history.onVisited.hasListener(listener);
```


Les événements ont trois fonctions :

`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`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

`result`

`history.HistoryItem`. Un objet représentant l'élément dans l'historique du navigateur.

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 `history.onTitleChanged`.


Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

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);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.onTitleChanged
======================

Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.Pour écouter les visites d'une page, vous pouvez utiliser `history.onVisited`. Cependant, le `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, `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`.Syntaxe
-------


```js
browser.history.onTitleChanged.addListener(listener);
browser.history.onTitleChanged.removeListener(listener);
browser.history.onTitleChanged.hasListener(listener);
```


Les événements ont trois fonctions :

`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`.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Function that will be called when this event occurs. The function will be passed an object with the following properties:

`url`

`String`. URL of the page visited.

`title`

`String`. Title of the page visited.


Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Écoutez les événements de changement de titre et consignez l'URL et le titre des pages visitées


```js
function handleTitleChanged(item) {
  console.log(item.title);
  console.log(item.url);
}

browser.history.onTitleChanged.addListener(handleTitleChanged);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.history`. Cette documentation est dérivée de `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.
history.deleteRange()
=====================

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 `history.onVisitRemoved` se déclenchera pour cela.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var deletingRange = browser.history.deleteRange(
  range, // object
);
```

### Paramètres

`range`

`object`. Spécification de la plage de temps pour laquelle supprimer des visites.

`startTime`

`number` ou `string` ou `object`. Une valeur indiquant une date et une heure. Cela peut être représenté par: un objet `Date`, une chaîne de de date ISO 8601, ou le nombre de millisecondes depuis l'époque. 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`, une chaîne de date ISO 8601, ou le nombre de millisecondes depuis l'époque. Spécifie l'heure de fin de la plage.


### Valeur retournée

Une `Promise` sera remplie sans paramètre lorsque la plage a été supprimée.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprimer toutes les visites effectuées à la dernière minute :


```js
const MINUTE = 60 \* 1000;

function oneMinuteAgo() {
  return Date.now() - MINUTE;
}

browser.history.deleteRange({
  startTime: oneMinuteAgo(),
  endTime: Date.now(),
});
```


**Note :**

This API is based on Chromium's `chrome.history` API. This documentation is derived from `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.
browsingData.removeCookies()
============================

Efface les cookies du navigateur

Vous pouvez utiliser le paramètre `removalOptions`, qui est un objet `browsingData.RemovalOptions` pour :

* Efface seulement les cookies créés après un temps donné
* Contrôlez si les cookies doivent être supprimés uniquement à partir des pages Webnormales ou si vous souhaitez supprimer les cookies des applications et des extensions hébergées.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.browsingData.removeCookies(
  removalOptions, // RemovalOptions object
);
```

### Paramètres

`removalOptions`

`object`. Un objet `browsingData.RemovalOptions`, qui peut être utilisé pour effacer uniquement les cookies créés après un délais donné, et pour supprimer les cookies uniquement des pages Web normales ou pour supprimer les cookies des applications et extensions hébergées.

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Exemples
--------

Supprime les cookies créés la semaine dernière :


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 \* 60 \* 60 \* 24 \* 7;
}

var oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeCookies({ since: oneWeekAgo })
  .then(onRemoved, onError);
```


Supprime tous les cookies :

**Attention :**

L'utilisation de l'API pour supprimer tous les cookies effacera simultanément tous les objets de stockage locaux (y compris ceux des autres extensions).

Si vous souhaitez simplement effacer tous les cookies sans perturber les installations de stockage locales, utilisez browser.cookies pour faire une boucle et supprimer le contenu de tous les magasins de cookies.


```js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeCookies({}).then(onRemoved, onError);
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.browsingData`.

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.