`browsingContext.downloadWillBegin`-Ereignis

Das Ereignis browsingContext.downloadWillBegin des Moduls browsingContext wird ausgelöst, wenn der Browser kurz davor steht, einen Dateidownload zu starten.

Ereignisdaten

Das Feld params in der Ereignisbenachrichtigung ist ein Objekt mit den folgenden Feldern:

context: Eine Zeichenfolge mit der ID des Kontexts, in dem der Download ausgelöst wurde.
download: Eine Zeichenfolge mit der UUID, die diesen Download eindeutig identifiziert. Dieselbe ID ist im zugehörigen Ereignis browsingContext.downloadEnd enthalten, sodass Sie die beiden Ereignisse einander zuordnen können.
navigation: Eine Zeichenfolge mit der UUID, die die zugehörige Navigation eindeutig identifiziert, oder null, wenn der Download keiner Navigation zugeordnet ist. Wenn die Navigation mit dem Befehl browsingContext.navigate oder browsingContext.reload gestartet wurde, stimmt diese ID mit dem Wert von navigation in der Antwort auf den Befehl überein. Dieselbe ID wird auch von anderen Ereignissen verwendet, die bei dieser Navigation ausgelöst werden, beispielsweise browsingContext.navigationStarted und Ereignissen des Moduls network.
suggestedFilename: Eine Zeichenfolge mit dem Dateinamen, den der Browser für den Download vorschlägt.
timestamp: Eine nicht negative Ganzzahl, die den Zeitpunkt angibt, zu dem das Ereignis ausgelöst wurde, als Anzahl der seit der Epoche verstrichenen Millisekunden.
url: Eine Zeichenfolge mit der URL des Downloads.

Ein Download kann auf verschiedene Weise starten. Er kann beispielsweise beginnen, wenn ein Link mit dem Attribut download aktiviert wird. Er kann auch beginnen, wenn der Browser eine Antwort mit einem Content-Disposition-Header erhält, der die Ressource als Anhang kennzeichnet.

Nachdem dieses Ereignis ausgelöst wurde, bestimmt der Browser anhand des mit browser.setDownloadBehavior konfigurierten Download-Verhaltens, ob der Download zugelassen und wo er gespeichert wird.

Beispiele

Ein Ereignis beim Start eines Downloads empfangen

Angenommen, Sie haben eine WebDriver-BiDi-Verbindung, eine aktive Sitzung und ein aktives Abonnement für browsingContext.downloadWillBegin.

Ein Link auf der Seite verweist auf https://example.com/files/report.pdf. Bevor der Download startet, sendet der Browser die folgende Benachrichtigung:

json

{
  "type": "event",
  "method": "browsingContext.downloadWillBegin",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "download": "6bfa8781-e33c-4f2c-8e63-4d0f6dc5d1a1",
    "navigation": "0e2f4d20-8f0a-4de7-9749-1b12a0d6c8b0",
    "suggestedFilename": "report.pdf",
    "timestamp": 1737033600000,
    "url": "https://example.com/files/report.pdf"
  }
}