XMLHttpRequestUpload: loadstart-Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("loadstart", (event) => { })

onloadstart = (event) => { }

Ein ProgressEvent. Erbt von Event.

Zusätzlich zu den unten aufgeführten Eigenschaften sind Eigenschaften aus der übergeordneten Schnittstelle, Event, verfügbar.

lengthComputable Schreibgeschützt

Ein boolesches Kennzeichen, das angibt, ob die gesamte auszuführende Arbeit und die bereits geleistete Arbeit durch den zugrunde liegenden Prozess berechenbar ist. Mit anderen Worten, es zeigt an, ob der Fortschritt messbar ist oder nicht.

loaded Schreibgeschützt

Ein 64-Bit-Integer-Wert, der die Menge an Arbeit angibt, die bereits vom zugrunde liegenden Prozess ausgeführt wurde. Das Verhältnis der geleisteten Arbeit kann berechnet werden, indem total durch den Wert dieser Eigenschaft dividiert wird. Beim Herunterladen einer Ressource mit HTTP zählt dies nur den Körper der HTTP-Nachricht und schließt Header und anderen Overhead nicht ein.

total Schreibgeschützt

Ein 64-Bit-Integer, der die Gesamtmenge an Arbeit darstellt, die der zugrunde liegende Prozess in der Ausführung ist. Beim Herunterladen einer Ressource mit HTTP ist dies die Content-Length (die Größe des Körpers der Nachricht) und schließt die Header und anderen Overhead nicht ein.

Sie können das loadstart-Ereignis verwenden, um den Beginn eines Uploads zu erkennen. Für ein vollständiges Code-Beispiel, das eine Datei hochlädt und eine Fortschrittsanzeige anzeigt, siehe die Hauptseite XMLHttpRequestUpload.

// When the upload starts, we display the progress bar
xhr.upload.addEventListener("loadstart", (event) => {
  progressBar.classList.add("visible");
  progressBar.value = 0;
  progressBar.max = event.total;
  log.textContent = "Uploading (0%)…";
  abortButton.disabled = false;
});

• Verwandte Ereignisse: load, progress, error, loadend, abort, timeout
• XMLHttpRequestUpload