chrome.downloads

Beschrijving

Gebruik de chrome.downloads API om downloads programmatisch te initiëren, controleren, manipuleren en zoeken.

Machtigingen

downloads

U moet de machtiging "downloads" in het extensiemanifest declareren om deze API te gebruiken.

{   "name": "My extension",   ...   "permissions": [     "downloads"   ], }

Voorbeelden

Eenvoudige voorbeelden van het gebruik van de chrome.downloads API vindt u in de map examples/api/downloads . Zie Voorbeelden voor andere voorbeelden en hulp bij het bekijken van de broncode.

Typen

BooleanDelta

Eigenschappen

  • huidig

    boolean optioneel

  • vorig

    boolean optioneel

DangerType

bestand

De bestandsnaam van de download is verdacht.

url

Het is bekend dat de URL van de download schadelijk is.

inhoud

Het gedownloade bestand is als schadelijk bekend.

ongewoon

De URL van de download wordt niet vaak gedownload en kan gevaarlijk zijn.

gastheer

De download kwam van een host waarvan bekend is dat deze schadelijke binaire bestanden verspreidt en is waarschijnlijk gevaarlijk.

ongewenst

De download is mogelijk ongewenst of onveilig. Het kan bijvoorbeeld wijzigingen in de browser- of computerinstellingen aanbrengen.

veilig

Het downloaden levert geen enkel bekend gevaar op voor de computer van de gebruiker.

geaccepteerd

De gebruiker heeft de gevaarlijke download geaccepteerd.

Enum

"bestand"

"url"

"inhoud"

"ongewoon"

"gastheer"

"ongewenst"

"veilig"

"geaccepteerd"

"toegestanelijstdoorbeleid"

"asyncScanning"

"asyncLocalPasswordScanning"

"wachtwoordbeveiligd"

"geblokkeerdTeGroot"

"gevoeligeinhoudwaarschuwing"

"gevoeligeInhoudBlok"

"deepScannedFailed"

"deepScannedSafe"

"diepGescandGeopendGevaarlijk"

"promptForScanning"

"promptVoorLokaleWachtwoordScannen"

"accountCompromise"

"geblokkeerdeScanMislukt"

DoubleDelta

Eigenschappen

  • huidig

    nummer optioneel

  • vorig

    nummer optioneel

DownloadDelta

Eigenschappen

  • kan hervatten

    BooleanDelta optioneel

    De wijziging in canResume , indien van toepassing.

  • Gevaar

    StringDelta optioneel

    De verandering in danger , indien van toepassing.

  • eindtijd

    StringDelta optioneel

    De wijziging in endTime , indien van toepassing.

  • fout

    StringDelta optioneel

    De wijziging in error , indien van toepassing.

  • bestaat

    BooleanDelta optioneel

    De wijziging exists , indien van toepassing.

  • bestandsgrootte

    DoubleDelta optioneel

    De wijziging in fileSize , indien van toepassing.

  • bestandsnaam

    StringDelta optioneel

    De wijziging in filename , indien van toepassing.

  • eind-URL

    StringDelta optioneel

    Chroom 54+

    De wijziging in finalUrl , indien van toepassing.

  • id

    nummer

    De id van het gewijzigde DownloadItem .

  • mime

    StringDelta optioneel

    De verandering in mime , indien van toepassing.

  • gepauzeerd

    BooleanDelta optioneel

    De wijziging is paused , indien van toepassing.

  • starttijd

    StringDelta optioneel

    De wijziging in startTime , indien van toepassing.

  • staat

    StringDelta optioneel

    De verandering in state , indien van toepassing.

  • totaalBytes

    DoubleDelta optioneel

    De wijziging in totalBytes , indien van toepassing.

  • url

    StringDelta optioneel

    De wijziging in url , indien van toepassing.

DownloadItem

Eigenschappen

  • doorExtensionId

    string optioneel

    De identificatiecode voor de extensie die deze download heeft geïnitieerd, indien deze download door een extensie is geïnitieerd. Verandert niet nadat deze is ingesteld.

  • opExtensieNaam

    string optioneel

    De gelokaliseerde naam van de extensie die deze download heeft geïnitieerd, indien deze download door een extensie is geïnitieerd. Kan veranderen als de extensie van naam verandert of als de gebruiker de landinstelling wijzigt.

  • bytesOntvangen

    nummer

    Aantal bytes dat tot nu toe van de host is ontvangen, zonder rekening te houden met bestandscompressie.

  • kan hervatten

    Booleaanse

    Waar als het downloaden bezig is en is gepauzeerd, of als het wordt onderbroken en kan worden hervat vanaf het punt waarop het werd onderbroken.

  • Gevaar

    GevaarType

    Geeft aan of deze download als veilig of verdacht wordt beschouwd.

  • eindtijd

    string optioneel

    Het tijdstip waarop de download eindigde in ISO 8601-formaat. Kan rechtstreeks worden doorgegeven aan de Date-constructor: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

  • fout

    InterruptReason optioneel

    Waarom de download werd onderbroken. Verschillende soorten HTTP-fouten kunnen worden gegroepeerd onder een van de fouten die beginnen met SERVER_ . Fouten met betrekking tot het netwerk beginnen met NETWORK_ , fouten met betrekking tot het schrijfproces van het bestand naar het bestandssysteem beginnen met FILE_ , en onderbrekingen die door de gebruiker zijn geïnitieerd beginnen met USER_ .

  • geschatte eindtijd

    string optioneel

    Geschatte tijd waarop de download voltooid zal zijn in ISO 8601-formaat. Kan rechtstreeks worden doorgegeven aan de Date-constructor: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

  • bestaat

    Booleaanse

    Of het gedownloade bestand nog bestaat. Deze informatie is mogelijk verouderd omdat Chrome niet automatisch controleert of een bestand is verwijderd. Roep search () aan om de controle op het bestaan van een bestand te activeren. Wanneer de controle is voltooid en het bestand is verwijderd, wordt de gebeurtenis onChanged geactiveerd. Houd er rekening mee dat search () niet wacht tot de controle is voltooid voordat het bestand wordt geretourneerd, waardoor de resultaten van search () mogelijk niet nauwkeurig het bestandssysteem weerspiegelen. Bovendien kan search () zo vaak worden aangeroepen als nodig is, maar controleert het niet vaker dan eens per 10 seconden op het bestaan van een bestand.

  • bestandsgrootte

    nummer

    Aantal bytes in het hele bestand na decompressie, of -1 indien onbekend.

  • bestandsnaam

    snaar

    Absoluut lokaal pad.

  • eind-URL

    snaar

    Chroom 54+

    De absolute URL waarvandaan deze download wordt gemaakt, na alle omleidingen.

  • id

    nummer

    Een identificatie die permanent blijft tijdens browsersessies.

  • incognito

    Booleaanse

    Onwaar als deze download in de geschiedenis is vastgelegd, waar als dit niet het geval is.

  • mime

    snaar

    Het MIME-type van het bestand.

  • gepauzeerd

    Booleaanse

    Waar als het downloaden is gestopt met het lezen van gegevens van de host, maar de verbinding open is gebleven.

  • verwijzer

    snaar

    Absolute URL.

  • starttijd

    snaar

    Het tijdstip waarop de download begon in ISO 8601-formaat. Kan rechtstreeks worden doorgegeven aan de Date-constructor: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

  • staat

    Staat

    Geeft aan of het downloaden bezig is, onderbroken is of voltooid is.

  • totaalBytes

    nummer

    Aantal bytes in het gehele bestand, zonder rekening te houden met bestandscompressie, of -1 indien onbekend.

  • url

    snaar

    De absolute URL van waaruit deze download is gestart, vóór eventuele omleidingen.

DownloadOptions

Eigenschappen

  • lichaam

    string optioneel

    Berichttekst.

  • conflictActie

    BestandsnaamConflictActie optioneel

    De actie die moet worden uitgevoerd als filename al bestaat.

  • bestandsnaam

    string optioneel

    Een relatief bestandspad ten opzichte van de map Downloads om het gedownloade bestand te bevatten, mogelijk met submappen. Absolute paden, lege paden en paden met terugverwijzingen ".." veroorzaken een fout. onDeterminingFilename maakt het mogelijk om een bestandsnaam voor te stellen nadat het MIME-type en een voorlopige bestandsnaam zijn bepaald.

  • kopteksten

    HeaderNameValuePair [] optioneel

    Extra HTTP-headers die met de aanvraag worden meegestuurd als de URL het HTTP[s]-protocol gebruikt. Elke header wordt weergegeven als een woordenboek met de name en ofwel value ofwel binaryValue , beperkt tot wat XMLHttpRequest toestaat.

  • methode

    HttpMethod optioneel

    De HTTP-methode die moet worden gebruikt als de URL het HTTP[S]-protocol gebruikt.

  • opslaan als

    boolean optioneel

    Gebruik een bestandskiezer zodat de gebruiker een bestandsnaam kan selecteren, ongeacht of filename is ingesteld of al bestaat.

  • url

    snaar

    De URL om te downloaden.

DownloadQuery

Eigenschappen

  • bytesOntvangen

    nummer optioneel

    Aantal bytes dat tot nu toe van de host is ontvangen, zonder rekening te houden met bestandscompressie.

  • Gevaar

    DangerType optioneel

    Geeft aan of deze download als veilig of verdacht wordt beschouwd.

  • eindtijd

    string optioneel

    Het tijdstip waarop het downloaden is beëindigd in ISO 8601-formaat.

  • eindigdeNa

    string optioneel

    Beperkt de resultaten tot DownloadItem dat eindigde na de opgegeven ms in ISO 8601-formaat

  • eindigdeVoor

    string optioneel

    Beperkt de resultaten tot DownloadItem dat eindigde vóór de opgegeven ms in ISO 8601-formaat.

  • fout

    InterruptReason optioneel

    Waarom een download werd onderbroken.

  • bestaat

    boolean optioneel

    Of het gedownloade bestand bestaat;

  • bestandsgrootte

    nummer optioneel

    Aantal bytes in het hele bestand na decompressie, of -1 indien onbekend.

  • bestandsnaam

    string optioneel

    Absoluut lokaal pad.

  • bestandsnaamRegex

    string optioneel

    Beperkt de resultaten tot DownloadItem waarvan filename overeenkomt met de opgegeven reguliere expressie.

  • eind-URL

    string optioneel

    Chroom 54+

    De absolute URL waarvandaan deze download wordt gemaakt, na alle omleidingen.

  • finaleUrlRegex

    string optioneel

    Chroom 54+

    Beperkt de resultaten tot DownloadItem waarvan finalUrl overeenkomt met de opgegeven reguliere expressie.

  • id

    nummer optioneel

    De id van het DownloadItem dat moet worden opgevraagd.

  • beperken

    nummer optioneel

    Het maximale aantal overeenkomende DownloadItem dat wordt geretourneerd. Standaard is dit 1000. Stel dit in op 0 om alle overeenkomende DownloadItem te retourneren. Zie search voor informatie over het bladeren door de resultaten.

  • mime

    string optioneel

    Het MIME-type van het bestand.

  • bestellenDoor

    string[] optioneel

    Stel elementen van deze array in op DownloadItem -eigenschappen om de zoekresultaten te sorteren. Door bijvoorbeeld orderBy=['startTime'] in te stellen, wordt het DownloadItem op starttijd gesorteerd in oplopende volgorde. Om de aflopende volgorde aan te geven, gebruikt u een koppelteken ervoor: '-startTime'.

  • gepauzeerd

    boolean optioneel

    Waar als het downloaden is gestopt met het lezen van gegevens van de host, maar de verbinding open is gebleven.

  • vraag

    string[] optioneel

    Deze reeks zoektermen beperkt de resultaten tot DownloadItem waarvan filename , url of finalUrl alle zoektermen bevat die niet met een koppelteken '-' beginnen en geen van de zoektermen die wel met een koppelteken beginnen.

  • starttijd

    string optioneel

    Het tijdstip waarop het downloaden begon in ISO 8601-formaat.

  • begonnenNa

    string optioneel

    Beperkt de resultaten tot DownloadItem dat na de opgegeven ms is gestart in ISO 8601-formaat.

  • begonnenVoor

    string optioneel

    Beperkt de resultaten tot DownloadItem dat begon vóór de opgegeven ms in ISO 8601-formaat.

  • staat

    Staat optioneel

    Geeft aan of het downloaden bezig is, onderbroken is of voltooid is.

  • totaalBytes

    nummer optioneel

    Aantal bytes in het gehele bestand, zonder rekening te houden met bestandscompressie, of -1 indien onbekend.

  • totaalBytesGroter

    nummer optioneel

    Beperkt de resultaten tot DownloadItem waarvan totalBytes groter is dan het opgegeven gehele getal.

  • totaalBytesMinder

    nummer optioneel

    Beperkt de resultaten tot DownloadItem waarvan totalBytes kleiner is dan het opgegeven gehele getal.

  • url

    string optioneel

    De absolute URL van waaruit deze download is gestart, vóór eventuele omleidingen.

  • urlRegex

    string optioneel

    Beperkt de resultaten tot DownloadItem waarvan url overeenkomt met de opgegeven reguliere expressie.

FilenameConflictAction

verenigen

Om duplicatie te voorkomen, wordt de filename gewijzigd en wordt er een teller vóór de bestandsnaamextensie geplaatst.

overschrijven

Het bestaande bestand wordt overschreven met het nieuwe bestand.

snel

De gebruiker krijgt een dialoogvenster te zien waarin hij een bestand kan kiezen.

Enum

"uniek maken"

"overschrijven"

"snel"

FilenameSuggestion

Eigenschappen

  • conflictActie

    BestandsnaamConflictActie optioneel

    De actie die moet worden uitgevoerd als filename al bestaat.

  • bestandsnaam

    snaar

    De nieuwe doelmap DownloadItem.filename van DownloadItem , als een pad relatief ten opzichte van de standaard Downloads-map van de gebruiker, mogelijk met submappen. Absolute paden, lege paden en paden met terugverwijzingen naar ".." worden genegeerd. filename wordt genegeerd als er onDeterminingFilename listeners zijn geregistreerd door welke extensie dan ook.

GetFileIconOptions

Eigenschappen

  • maat

    nummer optioneel

    De grootte van het geretourneerde pictogram. Het pictogram is vierkant met de volgende afmetingen: grootte * grootte in pixels. De standaard en grootste grootte voor het pictogram is 32x32 pixels. De enige ondersteunde formaten zijn 16 en 32. Het is fout om een andere grootte op te geven.

HeaderNameValuePair

Eigenschappen

  • naam

    snaar

    Naam van de HTTP-header.

  • waarde

    snaar

    Waarde van de HTTP-header.

HttpMethod

Enum

"KRIJGEN"

"NA"

InterruptReason

Enum

"BESTAND_MISLUKT"

"BESTANDSTOEGANG GEWEIGERD"

"BESTAND_GEEN_RUIMTE"

"BESTANDSNAAM_TE_LANG"

"BESTAND_TE_GROOT"

"BESTANDSVIRUS_GEÏNFECTEERD"

"BESTANDSVERGELIJKBARE_FOUT"

"BESTAND_GEBLOKKEERD"

"BESTANDSBEVEILIGINGSCONTROLE_MISLUKT"

"BESTAND_TE_KORT"

"BESTANDSHASH_MISMATCH"

"BESTAND_ZELFDE_ALS_BRON"

"NETWERK_FOUT"

"NETWERK_TIMEOUT"

"NETWERK_VERBROKEN"

"NETWERKSERVER_UIT"

"NETWERK_ONGELDIGE_AANVRAAG"

"SERVER_FAILED"

"SERVER_GEEN_BEREIK"

"SERVER_SLECHTE_INHOUD"

"SERVER_ONGEAUTORISEERD"

"SERVER_CERT_PROBLEEM"

"SERVER_VERBODEN"

"SERVER_ONBEREIKBAAR"

"SERVER_INHOUD_LENGTE_NIET-OVEREENKOMSTIG"

"SERVER_CROSS_ORIGIN_REDIRECT"

"GEBRUIKER_GEANNULEERD"

"GEBRUIKER_UITSCHAKELEN"

"CRASH"

State

in_uitvoering

De download ontvangt momenteel gegevens van de server.

onderbroken

Er is een fout opgetreden waardoor de verbinding met de bestandshost is verbroken.

compleet

Het downloaden is succesvol voltooid.

Enum

"in_uitvoering"

"onderbroken"

"compleet"

StringDelta

Eigenschappen

  • huidig

    string optioneel

  • vorig

    string optioneel

UiOptions

Chroom 105+

Eigenschappen

  • ingeschakeld

    Booleaanse

    De download-UI in- of uitschakelen.

Methoden

acceptDanger()

chrome.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

Vraagt de gebruiker een gevaarlijke download te accepteren. Kan alleen worden aangeroepen vanuit een zichtbare context (tabblad, venster of pop-upvenster met een pagina-/browseractie). Accepteert gevaarlijke downloads niet automatisch. Als de download wordt geaccepteerd, wordt de gebeurtenis onChanged geactiveerd, anders gebeurt er niets. Wanneer alle gegevens in een tijdelijk bestand zijn geplaatst en de download niet gevaarlijk is of het gevaar is geaccepteerd, wordt het tijdelijke bestand hernoemd naar de doelbestandsnaam, verandert de state in 'voltooid' en onChanged .

Parameters

  • download-ID

    nummer

    De identificatie voor het DownloadItem .

Retourneren

  • Belofte<leegte>

    Chroom 96+

cancel()

chrome.downloads.cancel(
  downloadId: number,
): Promise<void>

Een download annuleren. Wanneer callback wordt uitgevoerd, wordt de download geannuleerd, voltooid, onderbroken of bestaat deze niet meer.

Parameters

  • download-ID

    nummer

    De id van de te annuleren download.

Retourneren

  • Belofte<leegte>

    Chroom 96+

download()

chrome.downloads.download(
  options: DownloadOptions,
): Promise<number>

Download een URL. Als de URL het HTTP[S]-protocol gebruikt, bevat de aanvraag alle cookies die momenteel voor de hostnaam zijn ingesteld. Als zowel filename als saveAs zijn opgegeven, wordt het dialoogvenster Opslaan als weergegeven, vooraf ingevuld met de opgegeven filename . Als de download succesvol is gestart, wordt callback aangeroepen met de downloadId van het nieuwe DownloadItem . Als er een fout is opgetreden bij het starten van de download, wordt callback aangeroepen met downloadId=undefined en bevat runtime.lastError een beschrijvende tekenreeks. Er is geen garantie dat de foutreeksen achterwaarts compatibel blijven tussen releases. Extensies mogen deze niet parseren.

Parameters

Retourneren

  • Belofte<nummer>

    Chroom 96+

erase()

chrome.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

Wis het overeenkomende DownloadItem uit de geschiedenis zonder het gedownloade bestand te verwijderen. Er wordt een onErased -gebeurtenis geactiveerd voor elk DownloadItem dat overeenkomt met query , waarna callback wordt aangeroepen.

Parameters

Retourneren

  • Belofte<nummer[]>

    Chroom 96+

getFileIcon()

chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
): Promise<string | undefined>

Haal een pictogram op voor de opgegeven download. Voor nieuwe downloads zijn bestandspictogrammen beschikbaar nadat de onCreated -gebeurtenis is ontvangen. De afbeelding die door deze functie wordt geretourneerd tijdens een download, kan afwijken van de afbeelding die wordt geretourneerd nadat de download is voltooid. Het ophalen van pictogrammen gebeurt door het onderliggende besturingssysteem of de toolkit te raadplegen, afhankelijk van het platform. Het geretourneerde pictogram is daarom afhankelijk van een aantal factoren, waaronder de status van de download, het platform, de geregistreerde bestandstypen en het visuele thema. Als er geen bestandspictogram kan worden bepaald, bevat runtime.lastError een foutmelding.

Parameters

  • download-ID

    nummer

    De identificatie voor de download.

  • opties

    GetFileIconOptions optioneel

Retourneren

  • Belofte<string | undefined>

    Chroom 96+

open()

chrome.downloads.open(
  downloadId: number,
): Promise<void>

Opent het gedownloade bestand nu als DownloadItem voltooid is; anders wordt er een fout geretourneerd via runtime.lastError . Deze methode vereist naast de machtiging "downloads" "downloads.open" Een onChanged -gebeurtenis wordt geactiveerd wanneer het item voor de eerste keer wordt geopend. Deze methode kan alleen worden aangeroepen als reactie op een gebruikersgebaar.

Parameters

  • download-ID

    nummer

    De identificatie voor het gedownloade bestand.

Retourneren

  • Belofte<leegte>

    Chroom 123+

pause()

chrome.downloads.pause(
  downloadId: number,
): Promise<void>

Pauzeer de download. Als het verzoek succesvol was, is de download gepauzeerd. Anders bevat runtime.lastError een foutmelding. De aanvraag mislukt als de download niet actief is.

Parameters

  • download-ID

    nummer

    De id van de download die gepauzeerd moet worden.

Retourneren

  • Belofte<leegte>

    Chroom 96+

removeFile()

chrome.downloads.removeFile(
  downloadId: number,
): Promise<void>

Verwijder het gedownloade bestand als het bestaat en het DownloadItem compleet is. Anders wordt er een fout geretourneerd via runtime.lastError .

Parameters

  • download-ID

    nummer

Retourneren

  • Belofte<leegte>

    Chroom 96+

resume()

chrome.downloads.resume(
  downloadId: number,
): Promise<void>

Hervat een gepauzeerde download. Als het verzoek succesvol was, is de download bezig en hervat. Anders bevat runtime.lastError een foutmelding. Het verzoek mislukt als de download niet actief is.

Parameters

  • download-ID

    nummer

    De id van de download die moet worden hervat.

Retourneren

  • Belofte<leegte>

    Chroom 96+
chrome.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

Zoek DownloadItem . Stel query in op het lege object om alle DownloadItem op te halen. Om een specifieke DownloadItem op te halen, stelt u alleen het id veld in. Om door een groot aantal items te bladeren, stelt u orderBy: ['-startTime'] in, stelt u limit in voor het aantal items per pagina en stelt u startedAfter in op de startTime van het laatste item van de laatste pagina.

Parameters

Retourneren

setShelfEnabled()

Verouderd sinds Chrome 117
 
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

Gebruik in plaats daarvan setUiOptions .

Schakel de grijze plank onderaan elk venster dat aan het huidige browserprofiel is gekoppeld in of uit. De plank blijft uitgeschakeld zolang ten minste één extensie deze heeft uitgeschakeld. Als u de plank inschakelt terwijl ten minste één andere extensie deze heeft uitgeschakeld, wordt een foutmelding weergegeven via runtime.lastError . Vereist de machtiging "downloads.shelf" naast de machtiging "downloads" .

Parameters

  • ingeschakeld

    Booleaanse

setUiOptions()

Chroom 105+
chrome.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

Wijzig de download-UI van elk venster dat aan het huidige browserprofiel is gekoppeld. Zolang ten minste één extensie UiOptions.enabled op false heeft ingesteld, blijft de download-UI verborgen. Als UiOptions.enabled op true wordt ingesteld terwijl ten minste één andere extensie dit heeft uitgeschakeld, wordt een foutmelding weergegeven via runtime.lastError . Vereist de machtiging "downloads.ui" naast de machtiging "downloads" .

Parameters

Retourneren

  • Belofte<leegte>

show()

chrome.downloads.show(
  downloadId: number,
): void

Geef het gedownloade bestand weer in de map in een bestandsbeheerder.

Parameters

  • download-ID

    nummer

    De identificatie voor het gedownloade bestand.

showDefaultFolder()

chrome.downloads.showDefaultFolder(): void

Geef de standaardmap Downloads weer in een bestandsbeheerder.

Evenementen

onChanged

chrome.downloads.onChanged.addListener(
  callback: function,
)

Wanneer een van de eigenschappen van een DownloadItem (behalve bytesReceived en estimatedEndTime verandert, wordt deze gebeurtenis geactiveerd met de downloadId en een object met de gewijzigde eigenschappen.

Parameters

onCreated

chrome.downloads.onCreated.addListener(
  callback: function,
)

Deze gebeurtenis wordt geactiveerd met het DownloadItem -object wanneer een download begint.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (downloadItem: DownloadItem) => void

onDeterminingFilename

chrome.downloads.onDeterminingFilename.addListener(
  callback: function,
)

Tijdens het bepalen van de bestandsnaam krijgen extensies de mogelijkheid om het doelbestand DownloadItem.filename te overschrijven. Elke extensie mag niet meer dan één listener voor deze gebeurtenis registreren. Elke listener moet suggest precies één keer aanroepen, synchroon of asynchroon. Als de listener suggest asynchroon aanroept, moet deze true retourneren. Als de listener suggest niet synchroon aanroept en ook geen true retourneert, wordt suggest automatisch aangeroepen. Het DownloadItem wordt pas voltooid als alle listeners suggest hebben aangeroepen. Listeners kunnen suggest aanroepen zonder argumenten om de download toe te staan downloadItem.filename voor zijn bestandsnaam te gebruiken, of een suggestion aan suggest doorgeven om de doelbestandsnaam te overschrijven. Als meer dan één extensie de bestandsnaam overschrijft, wint de laatst geïnstalleerde extensie waarvan de listener een suggestion aan suggest doorgeeft. Om verwarring te voorkomen over welke extensie wint, moeten gebruikers geen extensies installeren die kunnen conflicteren. Als het downloaden wordt gestart door download en de doelbestandsnaam bekend is voordat het MIME-type en de voorlopige bestandsnaam zijn bepaald, geef dan filename door aan download .

Parameters

onErased

chrome.downloads.onErased.addListener(
  callback: function,
)

Wordt geactiveerd met de downloadId wanneer een download uit de geschiedenis wordt verwijderd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (downloadId: number) => void

    • download-ID

      nummer