webRequest.StreamFilter.close()
Schließt die Anfrage. Nachdem dies aufgerufen wurde, werden keine weiteren Antwortdaten an die Rendering-Engine des Browsers übermittelt und keine weiteren Filterereignisse an die Erweiterung gegeben.
Beachten Sie den Unterschied zwischen dieser Funktion und disconnect()
. Mit disconnect()
wird der Browser fortfahren, weitere Antwortdaten zu verarbeiten, aber sie werden nicht über den Filter zugänglich sein. Mit close()
wird der Browser alle Antwortdaten ignorieren, die noch nicht an die Rendering-Engine übergeben wurden.
Sie sollten immer close()
oder disconnect()
aufrufen, sobald Sie nicht mehr mit der Antwort interagieren müssen.
Sie können diese Funktion nicht aufrufen, bevor das Ereignis onstart
ausgelöst wurde.
Syntax
filter.close()
Parameter
Keine.
Rückgabewert
Keine.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Dieses Beispiel ersetzt den Seiteninhalt mit "replacement text":
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"],
);