webRequest.StreamFilter.onstart

Ein Ereignishandler, der aufgerufen wird, wenn der Stream geöffnet wird und kurz davor steht, Daten zu liefern. Von diesem Punkt an kann die Erweiterung Filterfunktionen wie write(), disconnect() oder close() verwenden.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Dieses Beispiel wird den Seiteninhalt mit "replacement text" ersetzen:

js
function listener(details) {
  let filter = browser.webRequest.filterResponseData(details.requestId);

  filter.onstart = (event) => {
    console.log("started");
    let encoder = new TextEncoder();
    filter.write(encoder.encode("replacement content"));
    filter.close();
  };
}

browser.webRequest.onBeforeRequest.addListener(
  listener,
  { urls: ["https://example.org/"], types: ["main_frame"] },
  ["blocking"],
);