proxy
Verwenden Sie die Proxy-API, um Webanfragen zu proxen. Sie können den proxy.onRequest-Ereignis-Listener verwenden, um Webanfragen abzufangen und ein Objekt zurückzugeben, das beschreibt, ob und wie diese proxied werden sollen.
Der Vorteil des Ansatzes mit proxy.onRequest besteht darin, dass der Code, der Ihre Proxy-Richtlinie implementiert, im Hintergrundskript Ihrer Erweiterung läuft. So erhält er vollen Zugriff auf die WebExtension-APIs, die Ihrer Erweiterung zur Verfügung stehen (einschließlich z. B. Zugriff auf den storage Ihrer Erweiterung und Netzwerkanfragen wie dns).
Abgesehen von dieser API können Erweiterungen auch die Eigenschaft browserSettings.proxyConfig verwenden, um globale Proxy-Einstellungen zu konfigurieren.
Hinweis: Chrome, Edge und Opera haben eine Extension-API, die auch "proxy" genannt wird, die funktional ähnlich zu dieser API ist, da Erweiterungen sie nutzen können, um eine Proxy-Richtlinie zu implementieren. Die Chrome-API ist jedoch völlig anders als diese API.
Um diese API zu nutzen, benötigen Sie die "proxy" Berechtigung. Außerdem benötigen Sie dort, wo Sie Anfragen abfangen möchten, auch Host-Berechtigungen für die URLs der abgefangenen Anfragen.
Die "proxy"-Berechtigung erfordert, dass "strict_min_version" auf "91.1.0" oder höher gesetzt wird. Um diese Berechtigung zu verwenden, fügen Sie den Schlüssel "browser_specific_settings" in Ihrer manifest.json hinzu oder aktualisieren ihn, um eine Mindestversion von Firefox anzugeben. Weitere Informationen finden Sie unter Sicherung der Proxy-API für Firefox-Add-ons.
Hinweis:
Der Browser kann spekulative Verbindungen herstellen, bei denen er feststellt, dass eine Anfrage an ein URI bald erfolgen könnte. Diese Art von Verbindung liefert keine gültigen Tab-Informationen, daher sind Anfragedetails wie tabId, frameId, parentFrameId usw. ungenau. Diese Verbindungen haben einen webRequest.ResourceType vom Typ speculative.
Typen
proxy.ProxyInfo-
Beschreibt einen Proxy.
proxy.RequestDetails-
Enthält Informationen über eine Webanfrage, die der Browser gleich senden wird.
Eigenschaften
proxy.settings-
Proxy-Einstellungen abrufen und festlegen.
Ereignisse
proxy.onError-
Wird ausgelöst, wenn das System auf einen Fehler beim Ausführen des PAC-Skripts oder des
onRequest-Listeners stößt. proxy.onRequest-
Wird ausgelöst, wenn eine Webanfrage gesendet wird, und gibt der Erweiterung die Möglichkeit, sie zu proxien.