Manifest V2-Erweiterungen wurden am 31. August 2026 aus dem Chrome Web Store entfernt. Migriere deine Erweiterung zu Manifest V3, damit sie Nutzern wieder zur Verfügung steht.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

chrome.devtools.inspectedWindow

Aktualisierungsdatum: 2026-09-25 robots: noindex

Beschreibung

Mit der chrome.devtools.inspectedWindow API können Sie mit dem untersuchten Fenster interagieren: Sie können die Tab-ID für die untersuchte Seite abrufen, den Code im Kontext des untersuchten Fensters auswerten, die Seite neu laden oder die Liste der Ressourcen auf der Seite abrufen.

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, um diese API verwenden zu können.

"devtools_page"

Mit chrome.devtools.inspectedWindow können Sie mit dem untersuchten Fenster interagieren: Sie können die Tab-ID für die untersuchte Seite abrufen, den Code im Kontext des untersuchten Fensters auswerten, die Seite neu laden oder die Liste der Ressourcen auf der Seite abrufen.

Eine allgemeine Einführung in die Verwendung von Developer Tools-APIs finden Sie unter DevTools APIs summary.

Übersicht

Die Property tabId enthält die Tab-ID, die Sie für die API-Aufrufe chrome.tabs.* verwenden können. Die chrome.tabs.* API ist aus Sicherheitsgründen jedoch nicht auf den Erweiterungsseiten der Entwicklertools verfügbar. Sie müssen die Tab-ID an die Hintergrundseite übergeben und die chrome.tabs.* API-Funktionen von dort aus aufrufen.

Mit der Methode reload kann die geprüfte Seite neu geladen werden. Außerdem kann der Aufrufer eine Überschreibung für den User-Agent-String, ein Skript, das früh beim Seitenaufbau eingefügt wird, oder eine Option zum Erzwingen des Neuladens von im Cache gespeicherten Ressourcen angeben.

Verwenden Sie den getResources-Aufruf und das onResourceContent-Ereignis, um die Liste der Ressourcen (Dokumente, Stylesheets, Skripts, Bilder usw.) auf der untersuchten Seite abzurufen. Die Methoden getContent und setContent der Klasse Resource sowie das Ereignis onResourceContentCommitted können verwendet werden, um die Änderung des Ressourceninhalts zu unterstützen, z. B. durch einen externen Editor.

Code im untersuchten Fenster ausführen

Mit der Methode eval können Erweiterungen JavaScript-Code im Kontext der untersuchten Seite ausführen. Diese Methode ist leistungsstark, wenn sie im richtigen Kontext verwendet wird, und gefährlich, wenn sie unangemessen eingesetzt wird. Verwenden Sie die Methode tabs.executeScript, sofern Sie nicht die spezifische Funktionalität benötigen, die die Methode eval bietet.

Im Folgenden sind die wichtigsten Unterschiede zwischen den Methoden eval und tabs.executeScript aufgeführt:

Bei der Methode eval wird keine isolierte Umgebung für den auszuwertenden Code verwendet. Der JavaScript-Status des untersuchten Fensters ist also für den Code zugänglich. Verwenden Sie diese Methode, wenn Sie auf den JavaScript-Status der untersuchten Seite zugreifen müssen.
Der Ausführungskontext des auszuwertenden Codes umfasst die Developer Tools Console API. Im Code können beispielsweise inspect und $0 verwendet werden.
Der ausgewertete Code kann einen Wert zurückgeben, der an den Erweiterungs-Callback übergeben wird. Der zurückgegebene Wert muss ein gültiges JSON-Objekt sein. Er darf nur primitive JavaScript-Typen und azyklische Verweise auf andere JSON-Objekte enthalten. Bitte gehen Sie beim Verarbeiten der von der untersuchten Seite empfangenen Daten besonders sorgfältig vor. Der Ausführungskontext wird im Wesentlichen von der untersuchten Seite gesteuert. Eine schädliche Seite kann die an die Erweiterung zurückgegebenen Daten beeinflussen.

Eine Seite kann mehrere verschiedene JavaScript-Ausführungskontexte enthalten. Jeder Frame hat einen eigenen Kontext sowie einen zusätzlichen Kontext für jede Erweiterung, in der Inhalts-Scripts in diesem Frame ausgeführt werden.

Standardmäßig wird die Methode eval im Kontext des Hauptframes der untersuchten Seite ausgeführt.

Die eval-Methode akzeptiert ein optionales zweites Argument, mit dem Sie den Kontext angeben können, in dem der Code ausgewertet wird. Dieses options-Objekt kann einen oder mehrere der folgenden Schlüssel enthalten:

frameURL: Wird verwendet, um einen anderen Frame als den Hauptframe der untersuchten Seite anzugeben.
contextSecurityOrigin: Wird verwendet, um einen Kontext innerhalb des angegebenen Frames anhand seines Webursprungs auszuwählen.
useContentScriptContext: Bei „true“ wird das Skript im selben Kontext wie die Inhaltsskripts der Erweiterung ausgeführt. (Entspricht der Angabe des eigenen Webursprungs der Erweiterung als Sicherheitsursprung des Kontexts.) Damit können Daten mit dem Content-Script ausgetauscht werden.

Beispiele

Mit dem folgenden Code wird geprüft, welche Version von jQuery auf der untersuchten Seite verwendet wird:

chrome.devtools.inspectedWindow.eval(
  "jQuery.fn.jquery",
  function(result, isException) {
    if (isException) {
      console.log("the page is not using jQuery");
    } else {
      console.log("The page is using jQuery v" + result);
    }
  }
);

Wenn Sie diese API ausprobieren möchten, installieren Sie die devtools API-Beispiele aus dem Repository chrome-extension-samples.

Typen

Resource

Eine Ressource auf der untersuchten Seite, z. B. ein Dokument, ein Skript oder ein Bild.

Attribute

URL

String

Die URL der Ressource.
getContent

void

Promise

Ruft den Inhalt der Ressource ab.

Die Funktion getContent sieht so aus:
```
(callback?: function) => {...}
```
- callback
  
  Funktion optional
  
  Der Parameter callback sieht so aus:
```
(response: object) => void
```
  - Antwort
    
    Objekt
    
    Chrome 151 und höher
    
    Ein Objekt, das den Ressourceninhalt und seine Codierung enthält.
    
    Inhalt
    
    String
    
    Inhalt der Ressource (möglicherweise codiert).
    
    encoding
    
    String
    
    Leer, wenn der Inhalt nicht codiert ist. Andernfalls der Name der Codierung. Derzeit wird nur base64 unterstützt.
- Gibt zurück
  Promise<object>
  
  Chrome 151 und höher
  
  Eine Funktion, die Ressourceninhalte empfängt, wenn die Anfrage abgeschlossen ist.
  
  Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.
setContent

void

Promise

Legt den Inhalt der Ressource fest.

Die Funktion setContent sieht so aus:
```
(content: string, commit: boolean, callback?: function) => {...}
```
- Inhalt
  
  String
  
  Neue Inhalte der Ressource. Derzeit werden nur Ressourcen mit dem Texttyp unterstützt.
- commit
  
  boolean
  
  „True“, wenn der Nutzer die Bearbeitung der Ressource abgeschlossen hat und der neue Inhalt der Ressource gespeichert werden soll. „False“, wenn es sich um eine geringfügige Änderung handelt, die während der Bearbeitung der Ressource durch den Nutzer gesendet wird.
- callback
  
  Funktion optional
  
  Der Parameter callback sieht so aus:
```
(error?: object) => void
```
  - Fehler
    
    object optional
    
    Wird auf „undefined“ gesetzt, wenn der Ressourceninhalt erfolgreich festgelegt wurde. Andernfalls wird ein Fehler beschrieben.
- Gibt zurück
  Promise<object>
  
  Chrome 151 und höher
  
  Eine Funktion, die nach Abschluss der Anfrage aufgerufen wird.
  
  Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Attribute

tabId

Die ID des Tabs, der geprüft wird. Diese ID kann mit chrome.tabs.* verwendet werden. oder die Compute Engine API.

Typ

Zahl

Methoden

eval()

Promise

chrome.devtools.inspectedWindow.eval(
  expression: string,
  options?: object,
  callback?: function,
): Promise<object>

Wertet einen JavaScript-Ausdruck im Kontext des Hauptframes der untersuchten Seite aus. Der Ausdruck muss zu einem JSON-kompatiblen Objekt ausgewertet werden. Andernfalls wird eine Ausnahme ausgelöst. Die Funktion „eval“ kann entweder einen DevTools-seitigen Fehler oder eine JavaScript-Ausnahme melden, die während der Auswertung auftritt. In beiden Fällen ist der result-Parameter des Callbacks undefined. Bei einem Fehler auf der DevTools-Seite ist der Parameter isException nicht null und isError ist auf „true“ und code auf einen Fehlercode gesetzt. Bei einem JavaScript-Fehler wird isException auf „true“ und value auf den Stringwert des ausgelösten Objekts gesetzt.

Parameter

Ausdruck

String

Ein Ausdruck, der ausgewertet werden soll.
Optionen

object optional

Der Parameter „options“ kann eine oder mehrere Optionen enthalten.
- frameURL
  
  String optional
  
  Wenn angegeben, wird der Ausdruck für den iFrame ausgewertet, dessen URL mit der angegebenen URL übereinstimmt. Standardmäßig wird der Ausdruck im obersten Frame der untersuchten Seite ausgewertet.
- scriptExecutionContext
  
  String optional
  
  Chrome 107 und höher
  
  Wertet den Ausdruck im Kontext eines Inhaltsscripts einer Erweiterung aus, die dem angegebenen Ursprung entspricht. Wenn angegeben, überschreibt „scriptExecutionContext“ die Einstellung „true“ für „useContentScriptContext“.
- useContentScriptContext
  
  Boolesch optional
  
  Wertet den Ausdruck im Kontext des Inhaltsskripts der aufrufenden Erweiterung aus, sofern das Inhaltsskript bereits in die untersuchte Seite eingefügt wurde. Andernfalls wird der Ausdruck nicht ausgewertet und der Callback wird mit dem Ausnahme-Parameter aufgerufen, der auf ein Objekt gesetzt ist, bei dem das Feld isError auf „true“ und das Feld code auf E_NOTFOUND gesetzt ist.
callback

Funktion optional

Der Parameter callback sieht so aus:
```
(response: object) => void
```
- Antwort
  
  Objekt
  
  Chrome 151 und höher
  
  Das Ergebnis der Bewertung und Informationen zu Ausnahmen.
  - exceptionInfo
    
    Objekt
    
    Ein Objekt, das Details enthält, wenn beim Auswerten des Ausdrucks eine Ausnahme aufgetreten ist.
    
    Code
    
    String
    
    Gibt an, ob der Fehler auf der Seite der Entwicklertools aufgetreten ist, bevor der Ausdruck ausgewertet wurde.
    
    Beschreibung
    
    String
    
    Gibt an, ob der Fehler auf der Seite der Entwicklertools aufgetreten ist, bevor der Ausdruck ausgewertet wurde.
    
    Details
    
    any[]
    
    Gibt an, ob der Fehler auf der DevTools-Seite aufgetreten ist, bevor der Ausdruck ausgewertet wurde. Enthält das Array der Werte, die in den Beschreibungsstring eingefügt werden können, um weitere Informationen zur Ursache des Fehlers zu liefern.
    
    isError
    
    boolean
    
    Gibt an, ob der Fehler auf der Seite der Entwicklertools aufgetreten ist, bevor der Ausdruck ausgewertet wurde.
    
    isException
    
    boolean
    
    Gibt an, ob der ausgewertete Code eine unbehandelte Ausnahme erzeugt.
    
    Wert
    
    String
    
    Gibt an, ob der ausgewertete Code eine unbehandelte Ausnahme erzeugt.
  - Ergebnis
    
    Objekt
    
    Das Ergebnis der Bewertung.

Ausgabe

Promise<object>

Chrome 151 und höher

Eine Funktion, die aufgerufen wird, wenn die Auswertung abgeschlossen ist.

Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getResources()

Promise

chrome.devtools.inspectedWindow.getResources(
  callback?: function,
): Promise<Resource[]>

Ruft die Liste der Ressourcen von der untersuchten Seite ab.

Parameter

callback

Funktion optional

Der Parameter callback sieht so aus:
```
(resources: Resource[]) => void
```
- Ressourcen
  
  Resource[]
  
  Die Ressourcen auf der Seite.

Ausgabe

Promise<Resource[]>

Chrome 151 und höher

Eine Funktion, die die Liste der Ressourcen empfängt, wenn die Anfrage abgeschlossen ist.

Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

reload()

chrome.devtools.inspectedWindow.reload(
  reloadOptions?: object,
): void

Lädt die untersuchte Seite neu.

Parameter

reloadOptions

object optional
- ignoreCache
  
  Boolesch optional
  
  Bei „true“ umgeht der Loader den Cache für alle geprüften Seitenressourcen, die vor dem Auslösen des load-Ereignisses geladen werden. Das Ergebnis ist dasselbe, als wenn Sie im untersuchten Fenster oder im Fenster der Entwicklertools Strg+Umschalt+R drücken.
- injectedScript
  
  String optional
  
  Falls angegeben, wird das Script unmittelbar nach dem Laden in jeden Frame der geprüften Seite eingefügt, noch bevor die Scripts des Frames ausgeführt werden. Das Skript wird nach nachfolgenden Neuladevorgängen nicht eingefügt, z. B. wenn der Nutzer Strg+R drückt.
- userAgent
  
  String optional
  
  Falls angegeben, wird mit dem String der Wert des User-Agent-HTTP-Headers überschrieben, der beim Laden der Ressourcen der untersuchten Seite gesendet wird. Der String überschreibt auch den Wert des Attributs navigator.userAgent, der an alle Skripts zurückgegeben wird, die auf der untersuchten Seite ausgeführt werden.

Ereignisse

onResourceAdded

chrome.devtools.inspectedWindow.onResourceAdded.addListener(
  callback: function,
)

Wird ausgelöst, wenn der untersuchten Seite eine neue Ressource hinzugefügt wird.

Parameter

callback

Funktion

Der Parameter callback sieht so aus:
```
(resource: Resource) => void
```
- Ressource
  
  Ressource

onResourceContentCommitted

chrome.devtools.inspectedWindow.onResourceContentCommitted.addListener(
  callback: function,
)

Wird ausgelöst, wenn eine neue Version der Ressource übernommen wird, z.B. wenn ein Nutzer eine bearbeitete Version der Ressource in den Entwicklertools speichert.

Parameter

callback

Funktion

Der Parameter callback sieht so aus:
```
(resource: Resource, content: string) => void
```
- Ressource
  
  Ressource
- Inhalt
  
  String

chrome.devtools.inspectedWindow Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Beschreibung

Manifest

Übersicht

Code im untersuchten Fenster ausführen

Beispiele

Typen

Resource

Attribute

Attribute

tabId

Typ

Methoden

eval()

Parameter

Ausgabe

getResources()

Parameter

Ausgabe

reload()

Parameter

Ereignisse

onResourceAdded

Parameter

onResourceContentCommitted

Parameter

chrome.devtools.inspectedWindow