Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

tabs.reload()

Rechargez un onglet, en contournant éventuellement le cache Web local.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var reloading = browser.tabs.reload(
  tabId,            // optional integer
  reloadProperties  // optional object
)

Paramètres

tabIdFacultatif

integer. L'ID de l'onglet à recharger. Par défaut à l'onglet sélectionné de la fenêtre en cours.

reloadPropertiesFacultatif

object.

bypassCacheFacultatif

boolean. Contourner le cache web local. La valeur par défaut est false.

Valeur retournée

Une Promise qui sera remplie sans arguments lorsque l'onglet a été rechargé. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Exemples

Recharger l'onglet actif de la fenêtre en cours :

browser.tabs.reload();

Rechargez l'onglet actif de la fenêtre en cours, en ignorant le cache :

browser.tabs.reload({bypassCache: true});

Rechargez l'onglet dont l'ID est 2, en ignorant le cache et en appelant un rappel lorsque vous avez terminé :

function onReloaded() {
  console.log(`Reloaded`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

var reloading = browser.tabs.reload(2, {bypassCache: true});
reloading.then(onReloaded, onError);

Example extensions

Compatibilité du navigateur

BCD tables only load in the browser

Note :

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

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.