Deze pagina is vertaald door de Cloud Translation API.

chrome.devtools.inspectedWindow

Beschrijving

Gebruik de chrome.devtools.inspectedWindow API voor interactie met het geïnspecteerde venster: verkrijg de tabblad-ID voor de geïnspecteerde pagina, evalueer de code in de context van het geïnspecteerde venster, laad de pagina opnieuw of verkrijg de lijst met bronnen op de pagina.

Manifest

De volgende sleutels moeten in het manifest worden gedeclareerd om deze API te kunnen gebruiken.

"devtools_page"

Gebruik chrome.devtools.inspectedWindow voor interactie met het geïnspecteerde venster: verkrijg de tabblad-ID voor de geïnspecteerde pagina, evalueer de code in de context van het geïnspecteerde venster, laad de pagina opnieuw of verkrijg de lijst met bronnen op de pagina.

Zie het overzicht van DevTools API's voor een algemene inleiding tot het gebruik van Developer Tools API's.

Overzicht

De eigenschap tabId biedt de tabblad-ID die u kunt gebruiken bij de chrome.tabs.* API-aanroepen. Houd er echter rekening mee dat chrome.tabs.* API vanwege veiligheidsoverwegingen niet wordt weergegeven op de Developer Tools-extensiepagina's. U moet de tabblad-ID doorgeven aan de achtergrondpagina en vanaf daar de chrome.tabs.* API-functies aanroepen.

De reload kan worden gebruikt om de geïnspecteerde pagina opnieuw te laden. Bovendien kan de beller een overschrijving opgeven voor de user-agentstring, een script dat vroeg bij het laden van de pagina wordt geïnjecteerd, of een optie om het herladen van in de cache opgeslagen bronnen te forceren.

Gebruik de getResources aanroep en de onResourceContent gebeurtenis om de lijst met bronnen (documenten, stylesheets, scripts, afbeeldingen, enz.) op de geïnspecteerde pagina te verkrijgen. De methoden getContent en setContent van de klasse Resource kunnen samen met de gebeurtenis onResourceContentCommitted worden gebruikt om wijziging van de broninhoud te ondersteunen, bijvoorbeeld door een externe editor.

Code uitvoeren in het geïnspecteerde venster

De eval methode biedt extensies de mogelijkheid om JavaScript-code uit te voeren in de context van de geïnspecteerde pagina. Deze methode is krachtig als deze in de juiste context wordt gebruikt en gevaarlijk als deze op de verkeerde manier wordt gebruikt. Gebruik de methode tabs.executeScript tenzij u de specifieke functionaliteit nodig hebt die de eval -methode biedt.

Dit zijn de belangrijkste verschillen tussen de methoden eval en tabs.executeScript :

De eval methode gebruikt geen geïsoleerde wereld voor de code die wordt geëvalueerd, dus de JavaScript-status van het geïnspecteerde venster is toegankelijk voor de code. Gebruik deze methode wanneer toegang tot de JavaScript-status van de geïnspecteerde pagina vereist is.
De uitvoeringscontext van de code die wordt geëvalueerd, omvat de Developer Tools-console-API . De code kan bijvoorbeeld inspect en $0 gebruiken.
De geëvalueerde code retourneert mogelijk een waarde die wordt doorgegeven aan de extensie-callback. De geretourneerde waarde moet een geldig JSON-object zijn (deze mag alleen primitieve JavaScript-typen en acyclische verwijzingen naar andere JSON-objecten bevatten). Wees extra voorzichtig bij het verwerken van de gegevens die u van de geïnspecteerde pagina ontvangt; de uitvoeringscontext wordt in wezen bepaald door de geïnspecteerde pagina; een kwaadaardige pagina kan invloed hebben op de gegevens die naar de extensie worden geretourneerd.

Houd er rekening mee dat een pagina meerdere verschillende JavaScript-uitvoeringscontexten kan bevatten. Elk frame heeft zijn eigen context, plus een extra context voor elke extensie waarvoor inhoudsscripts in dat frame worden uitgevoerd.

Standaard wordt de eval methode uitgevoerd in de context van het hoofdframe van de geïnspecteerde pagina.

De eval methode heeft een optioneel tweede argument nodig dat u kunt gebruiken om de context op te geven waarin de code wordt geëvalueerd. Dit optieobject kan een of meer van de volgende sleutels bevatten:

frameURL: Gebruik deze optie om een ander frame op te geven dan het hoofdframe van de geïnspecteerde pagina.
contextSecurityOrigin: Gebruik deze optie om een context binnen het opgegeven frame te selecteren op basis van de weboorsprong .
useContentScriptContext: Indien waar, voer het script dan uit in dezelfde context als de inhoudsscripts van de extensies. (Gelijkwaardig aan het opgeven van de eigen weborganisatie van de extensie als de oorsprong van de contextbeveiliging.) Dit kan worden gebruikt om gegevens uit te wisselen met het inhoudsscript.

Voorbeelden

De volgende code controleert de versie van jQuery die door de geïnspecteerde pagina wordt gebruikt:

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);
    }
  }
);

Als u deze API wilt uitproberen, installeert u de devtools API-voorbeelden uit de chrome-extension-samples- repository.

Soorten

Resource

Een bron binnen de geïnspecteerde pagina, zoals een document, een script of een afbeelding.

Eigenschappen

URL
snaar
De URL van de bron.
krijg inhoud
leegte
Haalt de inhoud van de bron op.
De getContent functie ziet er als volgt uit:
```
(callback: function) => {...}
```
- terugbellen
  functie
  De callback parameter ziet er als volgt uit:
```
(content: string, encoding: string) => void
```
  - inhoud
    snaar
    Inhoud van de bron (mogelijk gecodeerd).
  - codering
    snaar
    Leeg als de inhoud niet is gecodeerd, anders codeernaam. Momenteel wordt alleen base64 ondersteund.
setInhoud
leegte
Stelt de inhoud van de bron in.
De setContent functie ziet er als volgt uit:
```
(content: string, commit: boolean, callback?: function) => {...}
```
- inhoud
  snaar
  Nieuwe inhoud van de bron. Momenteel worden alleen bronnen met het teksttype ondersteund.
- verbinden
  Booleaans
  Waar als de gebruiker klaar is met het bewerken van de bron en de nieuwe inhoud van de bron behouden moet blijven; false als dit een kleine wijziging is die wordt verzonden terwijl de gebruiker de bron bewerkt.
- terugbellen
  functie optioneel
  De callback parameter ziet er als volgt uit:
```
(error?: object) => void
```
  - fout
    object optioneel
    Stel in op ongedefinieerd als de broninhoud succesvol is ingesteld; beschrijft de fout anders.

Eigenschappen

tabId

De ID van het tabblad dat wordt geïnspecteerd. Deze ID kan worden gebruikt met de chrome.tabs.* API.

Type

nummer

Methoden

eval()

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

Evalueert een JavaScript-expressie in de context van het hoofdframe van de geïnspecteerde pagina. De expressie moet resulteren in een JSON-compatibel object, anders wordt er een uitzondering gegenereerd. De eval-functie kan een DevTools-fout of een JavaScript-uitzondering rapporteren die optreedt tijdens de evaluatie. In beide gevallen is de result van de callback undefined . In het geval van een fout aan de DevTools-zijde is de parameter isException niet nul en is isError ingesteld op true en is code ingesteld op een foutcode. In het geval van een JavaScript-fout wordt isException ingesteld op true en wordt value ingesteld op de tekenreekswaarde van het gegenereerde object.

Parameters

uitdrukking
snaar
Een uitdrukking om te evalueren.
opties
object optioneel
De parameter options kan een of meer opties bevatten.
- frameURL
  tekenreeks optioneel
  Indien opgegeven, wordt de expressie geëvalueerd op het iframe waarvan de URL overeenkomt met de opgegeven URL. Standaard wordt de expressie geëvalueerd in het bovenste frame van de geïnspecteerde pagina.
- scriptExecutionContext
  tekenreeks optioneel
  Chroom 107+
  Evalueer de expressie in de context van een inhoudsscript van een extensie die overeenkomt met de opgegeven oorsprong. Indien opgegeven, overschrijft scriptExecutionContext de instelling 'true' op useContentScriptContext.
- gebruikContentScriptContext
  Booleaans optioneel
  Evalueer de expressie in de context van het inhoudsscript van de aanroepende extensie, op voorwaarde dat het inhoudsscript al in de geïnspecteerde pagina is geïnjecteerd. Als dit niet het geval is, wordt de expressie niet geëvalueerd en wordt de callback aangeroepen met de uitzonderingsparameter ingesteld op een object waarvoor het veld isError is ingesteld op true en het code is ingesteld op E_NOTFOUND .
terugbellen
functie optioneel
De callback parameter ziet er als volgt uit:
```
(result: object, exceptionInfo: object) => void
```
- resultaat
  voorwerp
  Het resultaat van de evaluatie.
- uitzonderingInfo
  voorwerp
  Een object dat details verstrekt als er een uitzondering is opgetreden tijdens het evalueren van de expressie.
  - code
    snaar
    Stel in of de fout is opgetreden aan de DevTools-kant voordat de expressie werd geëvalueerd.
  - beschrijving
    snaar
    Stel in of de fout is opgetreden aan de DevTools-kant voordat de expressie werd geëvalueerd.
  - details
    elk[]
    Instellen of de fout is opgetreden aan de DevTools-kant voordat de expressie is geëvalueerd, bevat de array met waarden die in de beschrijvingsreeks kunnen worden vervangen om meer informatie te geven over de oorzaak van de fout.
  - isFout
    Booleaans
    Stel in of de fout is opgetreden aan de DevTools-kant voordat de expressie werd geëvalueerd.
  - isUitzondering
    Booleaans
    Stel in of de geëvalueerde code een onverwerkte uitzondering oplevert.
  - waarde
    snaar
    Stel in of de geëvalueerde code een onverwerkte uitzondering oplevert.

getResources()

chrome.devtools.inspectedWindow.getResources(
  callback: function,
)

Haalt de lijst met bronnen op van de geïnspecteerde pagina.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(resources: Resource[]) => void
```
- bronnen
  Bron []
  De bronnen op de pagina.

reload()

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

Laadt de geïnspecteerde pagina opnieuw.

Parameters

herlaadopties
object optioneel
- negeer Cache
  Booleaans optioneel
  Indien waar, zal de lader de cache omzeilen voor alle geïnspecteerde paginabronnen die zijn geladen voordat de load gebeurtenis wordt geactiveerd. Het effect is vergelijkbaar met het indrukken van Ctrl+Shift+R in het geïnspecteerde venster of in het venster Ontwikkelaarstools.
- geïnjecteerdScript
  tekenreeks optioneel
  Indien gespecificeerd, wordt het script onmiddellijk na het laden in elk frame van de geïnspecteerde pagina geïnjecteerd, vóór een van de scripts van het frame. Het script wordt niet geïnjecteerd na daaropvolgende herlaadbeurten, bijvoorbeeld als de gebruiker op Ctrl+R drukt.
- gebruikerAgent
  tekenreeks optioneel
  Indien opgegeven, overschrijft de tekenreeks de waarde van de User-Agent HTTP-header die wordt verzonden tijdens het laden van de bronnen van de geïnspecteerde pagina. De tekenreeks overschrijft ook de waarde van de eigenschap navigator.userAgent die wordt geretourneerd naar scripts die op de geïnspecteerde pagina worden uitgevoerd.

Evenementen

onResourceAdded

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

Wordt geactiveerd wanneer een nieuwe bron wordt toegevoegd aan de geïnspecteerde pagina.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(resource: Resource) => void
```
- bron
  Bron

onResourceContentCommitted

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

Wordt geactiveerd wanneer een nieuwe revisie van de bron wordt vastgelegd (de gebruiker slaat bijvoorbeeld een bewerkte versie van de bron op in de Developer Tools).

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(resource: Resource, content: string) => void
```
- bron
  Bron
- inhoud
  snaar