downloads.DownloadQuery

Le type DownloadQuery de l'API downloads définit un ensemble de paramètres pouvant être utilisés pour rechercher dans le gestionnaire de téléchargements un ensemble spécifique de téléchargements.

Ce type est utilisé par exemple dans downloads.search() et downloads.erase(), en tant qu'objet de requête pour filtrer l'ensemble de DownloadItems pour retourner ou effacer.

Type

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

queryFacultatif
Un tableau dechaines. Inclure uniquement DownloadItems dont le nom de fichier ou l'URL contient toutes les chaînes données. Vous pouvez également inclure des termes commençant par un titet (-) — ces termes ne doivent pas figurer dans le nom du fichier ou l'url de l'élément à inclure.
startedBeforeFacultatif
Un DownloadTime. Inclure uniquement DownloadItems qui a démarré avant l'heure indiquée.
startedAfterFacultatif
Un DownloadTime. Inclure uniquement DownloadItems qui a démarré après l'heure indiquée.
endedBeforeFacultatif
Un DownloadTime. Inclure uniquement DownloadItems qui s'est terminé avant l'heure indiquée.
endedAfterFacultatif
Un DownloadTime. Inclure uniquement DownloadItems qui s'est terminé après l'heure indiquée.
totalBytesGreaterFacultatif
Un number représentant un nombre d'octets. Inclure uniquement DownloadItems dont le  totalBytes est supérieur au nombre donné.
totalBytesLessFacultatif
Un number représentant un nombre d'octets. Inclure seulement  DownloadItems dont le totalBytes est inférieur au nombre donné.
filenameRegexFacultatif
Un string représentant une expression régulière. Inclure uniquement DownloadItems dont le nom du fichier correspond à l'expression régulière donnée..
urlRegexFacultatif
Un string représentant une expression régulière. Inclure uniquement DownloadItems dont la valeur d'url correspond à l'expression régulière donnée..
limitFacultatif
Un integer représentant un nombre de résultats. Incluez uniquement le nombre spécifié de DownloadItems.
orderByFacultatif
Un tableaude chaînes représentant les propriétés  DownloadItem les résultats de la recherche doivent être tirés par exemple, en incluant startTime puis totalBytes dans le tableau trierait DownloadItems par leur heure de début, puis le total des octets — dans l'ordre croissant. Pour spécifier le tri par une propriété dans l'ordre décroissant, préfixez-le avec un trait d'union, par exemple -startTime.
idFacultatif
Un integer représentant l'ID du downloads.DownloadItem que vous souhaitez interroger.
urlFacultatif
Un string représentant l'URL absolue à partir de laquelle le téléchargement a été initié, avant toute redirection.
filenameFacultatif
Un string représentant le chemin local absolu du fichier téléchargé que vous souhaitez interroger.
dangerFacultatif
Une chaîne représentant un downloads.DangerType — inclut uniquement DownloadItems avec cette valeur de danger .
mimeFacultatif
Un string représentant un type MIME. Incluez uniquement  DownloadItems avec cette valeur mime.
startTimeFacultatif
Un string représentant une heure au format ISO 8601. Incluez seulement  DownloadItems avec cette valeur  startTime.
endTimeFacultatif
Un string représentant une heure au format ISO 8601. Inclure uniquement sera limité à DownloadItems avec cette valeur endTime.
stateFacultatif
Un string représentant un téléchargement downloads.State (in_progress, interrupted, or complete). Inclure uniquement DownloadItems avec cette valeur d' état.
pausedFacultatif
Un boolean qui indique si un téléchargement est en pause — c'est-à-dire qui a cessé de lire les données de l'hôte, mais qui a conservé la connexion ouverte (true), ou non (false). inclure uniquement DownloadItems avec cette valeur de pause.
errorFacultatif
Une chaîne représentant un downloads.InterruptReason — une raison pour laquelle un téléchargement a été interrompu. Inclure uniquement  DownloadItems avec cette valeur d'  erreur .
bytesReceivedFacultatif
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte, sans tenir compte de la compression de fichier. Inclure seulement  DownloadItems avec cette valeur bytesReceived.
totalBytesFacultatif
Un number représentant le nombre total d'octets dans le fichier téléchargé, sans tenir compte de la compression de fichier. Inclure seulement  DownloadItems avec cette valeur  totalBytes.
fileSizeFacultatif
number. Nombre d'octets dans le fichier entier après la décompression, ou -1 si inconnu. Un nombre représentant le nombre total d'octets dans le fichier après la décompression. Inclure seulement DownloadItems avec cette valeur fileSize.
existsFacultatif
Un boolean si un fichier téléchargé existe toujours (true) ou non (false). Inclure seulement DownloadItems avec cette valeur existe.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 47Opera Support complet OuiFirefox Android Support complet 48

Légende

Support complet  
Support complet
Aucun support  
Aucun support

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,