Herunterladen lädt herunter

Entfernen Sie die heruntergeladene Datei, falls sie vorhanden ist und das DownloadItem abgeschlossen ist. Andernfalls geben Sie einen Fehler über runtime.lastError zurück. Während des Dateinamensermittlungsprozesses erhalten Erweiterungen die Möglichkeit, den Ziel-DownloadItem.filename zu überschreiben. Jede Erweiterung darf nicht mehr als einen Listener für dieses Ereignis registrieren. Jeder Listener muss genau einmal vorschlagen, entweder synchron oder asynchron. Wenn die Listeneraufrufe asynchron vorschlagen, muss sie true zurückgeben. Wenn der Listener weder synchron vorschlägt noch true zurückgibt, wird der Vorschlag automatisch aufgerufen. Das DownloadItem wird erst abgeschlossen, wenn alle Listener vorgeschlagen haben. Listener können ohne Argumente vorschlagen, damit der Download downloadItem.filename für seinen Dateinamen verwenden kann, oder ein Vorschlagsobjekt übergeben, das vorgeschlagen werden soll, um den Zieldateinamen zu überschreiben. Wenn mehr als eine Erweiterung den Dateinamen überschreibt, dann die letzte installierte Erweiterung, deren Listener ein Vorschlagsobjekt übergibt, um Wins vorzuschlagen. Um Verwirrung darüber zu vermeiden, welche Erweiterung gewinnen wird, sollten Benutzer keine Erweiterungen installieren, die in Konflikt geraten können. Wenn der Download per Download initiiert wird und der Zieldateiname bekannt ist, bevor der MIME-Typ und der vorläufige Dateiname bestimmt wurden, übergeben Sie den Dateinamen, um ihn herunterzuladen. Um alle Dateien anzuzeigen, die Sie auf Ihr Gerät heruntergeladen haben, öffnen Sie die Downloads-App.

Erfahren Sie mehr über die Verwaltung heruntergeladener Dateien. Legen Sie Elemente dieses Arrays auf DownloadItem-Eigenschaften fest, um Suchergebnisse zu sortieren. Wenn Sie z. B. orderBy=[`startTime`] festlegen, wird das DownloadItem nach ihrer Startzeit in aufsteigender Reihenfolge sortiert. Um die absteigende Reihenfolge anzugeben, setzen Sie das Präfix mit einem Bindestrich voraus: `-startTime`. Ein Dateipfad relativ zum Download-Verzeichnis, der die heruntergeladene Datei enthält, möglicherweise mit Unterverzeichnissen. Absolute Pfade, leere Pfade und Pfade, die Rückverweise „..“ enthalten, verursachen einen Fehler. onDeterminingFilename ermöglicht das Vorschlagen eines Dateinamens, nachdem der MIME-Typ der Datei ermittelt und ein vorläufiger Dateiname ermittelt wurde. Rufen Sie ein Symbol für den angegebenen Download ab. Für neue Downloads stehen Dateisymbole zur Verfügung, nachdem das onCreated-Ereignis empfangen wurde. Das Bild, das von dieser Funktion zurückgegeben wird, während ein Download ausgeführt wird, kann sich von dem Bild unterscheiden, das nach Abschluss des Downloads zurückgegeben wird.

Der Icon-Abruf erfolgt durch Abfragen des zugrunde liegenden Betriebssystems oder Toolkits je nach Plattform. Das Symbol, das zurückgegeben wird, hängt daher von einer Reihe von Faktoren ab, einschließlich Zustand des Downloads, Plattform, registrierte Dateitypen und visuelles Design. Wenn ein Dateisymbol nicht bestimmt werden kann, enthält runtime.lastError eine Fehlermeldung. Das neue DownloadItem-Ziel DownloadItem.filename als Pfad relativ zum Standard-Downloads-Verzeichnis des Benutzers, möglicherweise mit Unterverzeichnissen. Absolute Pfade, leere Pfade und Pfade, die Rückverweise „..“ enthalten, werden ignoriert. Aktivieren oder deaktivieren Sie das graue Regal am unteren Rand jedes Fensters, das dem aktuellen Browserprofil zugeordnet ist. Das Regal wird deaktiviert, solange mindestens eine Erweiterung es deaktiviert hat. Wenn Sie das Regal aktivieren, während mindestens eine andere Erweiterung deaktiviert wurde, wird ein Fehler über runtime.lastError zurückgegeben. Erfordert zusätzlich zur Berechtigung „Downloads“ die Berechtigung „downloads.shelf“. Laden Sie eine URL herunter. Wenn die URL das HTTP[S]-Protokoll verwendet, enthält die Anforderung alle Cookies, die derzeit für den Hostnamen festgelegt sind.

Wenn sowohl Dateiname als auch saveAs angegeben sind, wird das Dialogfeld Speichern unter angezeigt, das mit dem angegebenen Dateinamen vorab aufgefüllt wird. Wenn der Download erfolgreich gestartet wurde, wird der Rückruf mit der neuen DownloadItem-DownloadId aufgerufen. Wenn beim Starten des Downloads ein Fehler aufgetreten ist, wird callback mit downloadId=undefined aufgerufen, und runtime.lastError enthält eine beschreibende Zeichenfolge. Die Fehlerzeichenfolgen bleiben zwischen Den Releases nicht abwärtskompatibel.