downloads.DownloadItem

Le type DownloadItem de l'API downloads représente un fichier téléchargé.

Type

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

byExtensionIdFacultatif
Un string représentant l'ID de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela ne change pas une fois réglé. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
byExtensionNameFacultatif
Un string représentant le nom de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela peut changer si l'extension change de nom ou si l'utilisateur change ses paramètres régionaux. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
bytesReceived
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte pendant le téléchargement ; cela ne prend pas en compte la compression de fichier.
canResume
Un boolean indiquant si un téléchargement actuellement interrompu (par exemple en pause) peut être repris à partir du point où il a été interrompu (true), ou non (false).
danger
Une chaîne indiquant si ce téléchargement est considéré comme sûr ou suspect. Ses valeurs possibles sont définies dans le type  downloads.DangerType.
endTimeFacultatif
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et la fin de ce téléchargement. Ceci n'est pas défini si le téléchargement n'est pas encore terminé.
errorFacultatif
Une chaîne indiquant pourquoi un téléchargement a été interrompu. Les valeurs possibles sont définies dans le type downloads.InterruptReason. Ceci n'est pas défini si une erreur ne s'est pas produite.
estimatedEndTimeFacultatif
Un string (au format ISO 8601) représentant le nombre estimé de millisecondes entre l'époque UNIX et la date à laquelle ce téléchargement est estimé terminé. Ceci est indéfini s'il n'est pas connu (en particulier, il n'est pas défini dans le  DownloadItem qui est passé dans downloads.onCreated).
exists
Un boolean indiquant si un fichier téléchargé existe toujours (true) ou non (false). Ces informations peuvent être périmées, car les navigateurs ne surveillent pas automatiquement la suppression des fichiers. Pour vérifier si un fichier existe, appelez la méthode downloads.search(), en filtrant le fichier question.
filename
Un string représentant le chemin local absolu du fichier.
fileSize
Un number indiquant le nombre total d'octets dans le fichier entier, après décompression. La valeur -1 signifie que la taille totale du fichier est inconnue.
id
Un integer représentant un identifiant unique pour le fichier téléchargé qui est persistant entre les sessions du navigateur.
incognito
Un boolean qui indique si le téléchargement est enregistré dans l'historique du navigateur (false), ou non (true).
mime
Un string représentant le type MIME du fichier téléchargé.
paused
Un boolean indiquant si le téléchargement est en pause, c'est-à-dire si le téléchargement a cessé de lire les données de l'hôte mais a maintenu la connexion ouverte. Si c'est le cas, la valeur est true, sinon false.
referrer
Un string représentant le référent du fichier téléchargé.
startTime
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et le début du téléchargement.
state
Un string Indique si le téléchargement progresse, est interrompu ou terminé. Les valeurs possibles sont définies dans le type downloads.State.
totalBytes
Un number indiquant le nombre total d'octets dans le fichier en cours de téléchargement. Cela ne prend pas en compte la compression de fichier. Une valeur de -1 signifie que le nombre total d'octets est inconnu..
url
Un string représentant l'URL absolue à partir de laquelle le fichier a été téléchargé.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaSafariFirefox pour Android
byExtensionIdChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
byExtensionNameChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
bytesReceivedChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
canResumeChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
dangerChrome Support complet OuiEdge Support complet 79Firefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Always given as 'safe'.
Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Always given as 'safe'.
endTimeChrome Support complet OuiEdge Support complet 79Firefox Aucun support NonOpera Support complet OuiSafari Aucun support NonFirefox Android Aucun support Non
errorChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
estimatedEndTimeChrome Support complet OuiEdge Support complet 79Firefox Support complet 57Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 57 — 79
existsChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
filenameChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
fileSizeChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
idChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
incognitoChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
mimeChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
pausedChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
referrerChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
startTimeChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
stateChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
totalBytesChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79
urlChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 48 — 79

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Remerciements :

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

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.