Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
proxy
Verwenden Sie die Proxy-API, um Webanfragen zu proxen. Sie können denproxy.onRequest Ereignis-Listener nutzen, um Webanfragen abzufangen und ein Objekt zurückzugeben, das beschreibt, ob und wie diese proxied werden sollen.
Der Vorteil des Ansatzes mitproxy.onRequest besteht darin, dass der Code, der Ihre Proxy-Richtlinie implementiert, im Hintergrundskript Ihrer Erweiterung läuft, sodass er vollen Zugriff auf die WebExtension-APIs hat, die Ihrer Erweiterung zur Verfügung stehen (einschließlich z.B. Zugriff auf denstorage und Netzwerk-APIs wiedns).
Neben dieser API können Erweiterungen auch die EigenschaftbrowserSettings.proxyConfig verwenden, um globale Proxyeinstellungen zu konfigurieren.
Hinweis:Chrome, Edge und Opera habeneine Erweiterungs-API, die ebenfalls "proxy" genannt wird, die funktional ähnlich zu dieser API ist, indem Erweiterungen sie nutzen können, um eine Proxy-Richtlinie umzusetzen. Das Design der Chrome-API ist jedoch völlig anders als diese API. Da diese API nicht mit der Chromeproxy API kompatibel ist, ist sie nur über denbrowser Namespace verfügbar.
Um diese API zu nutzen, benötigen Sie die "proxy"Berechtigung. Da, wo Sie Anfragen abfangen möchten, benötigen Sie auchHost-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 nutzen, fügen Sie den Schlüssel"browser_specific_settings" immanifest.json hinzu oder aktualisieren Sie ihn, um eine minimale Firefox-Version anzugeben. Weitere Informationen finden Sie unterSicherung der Proxy-API für Firefox-Add-ons.
Hinweis:Der Browser kann spekulative Verbindungen herstellen, bei denen er feststellt, dass eine Anfrage an eine URI bald kommen könnte. Diese Art von Verbindung liefert keine gültigen Tab-Informationen, sodass Anfragedetails wietabId,frameId,parentFrameId usw. ungenau sind. Diese Verbindungen haben einenwebRequest.ResourceType vonspeculative.
Typen
proxy.ProxyInfoBeschreibt einen Proxy.
proxy.RequestDetailsEnthält Informationen über eine Webanfrage, die der Browser zu stellen beabsichtigt.
Eigenschaften
proxy.settingsProxy-Einstellungen abrufen und setzen.
Ereignisse
proxy.onErrorWird ausgelöst, wenn das System auf einen Fehler stößt, während das PAC-Skript oder der
onRequest-Listener ausgeführt wird.proxy.onRequestWird ausgelöst, wenn eine Webanfrage gestellt werden soll, was der Erweiterung die Möglichkeit gibt, sie zu proxen.