chrome.extension

refresh date: 2026-09-25 robots: noindex

Beschrijving

De chrome.extension API heeft hulpprogramma's die kunnen worden gebruikt door elke extensiepagina. De API biedt ondersteuning voor de uitwisseling van berichten tussen een extensie en de bijbehorende contentscripts of tussen extensies, zoals gedetailleerd beschreven in Berichten doorgeven.

Typen

ViewType

Chrome 44+

Het type extensieweergave.

Enum

tabblad

"popup"

Eigenschappen

inIncognitoContext

Waar voor contentscripts die worden uitgevoerd op incognitotabbladen en voor extensiepagina's die worden uitgevoerd in een incognitoproces. Dit laatste is alleen van toepassing op extensies met incognito_behavior 'split'.

Type

booleaans

lastError

≤ MV2 Beëindigd sinds Chrome 58

Gebruik runtime.lastError.

Ingesteld voor de levensduur van een callback als een asynchrone extensie-API een fout heeft veroorzaakt. Als er geen fout is opgetreden, is lastError undefined.

Type

object

Eigenschappen

  • bericht

    tekenreeks

    Beschrijving van de fout die is opgetreden.

Methoden

getBackgroundPage()

Alleen voorgrond 
chrome.extension.getBackgroundPage(): Window | undefined

Retourneert het JavaScript-vensterobject voor de achtergrondpagina die wordt uitgevoerd in de huidige extensie. Retourneert null als de extensie geen achtergrondpagina heeft.

Retourzendingen

  • Venster | undefined

getExtensionTabs()

≤ MV2 Alleen voorgrond Beëindigd
chrome.extension.getExtensionTabs(
  windowId?: number,
): Window[]

Gebruik extension.getViews {type: "tab"}.

Retourneert een matrix van de JavaScript-vensterobjecten voor elk van de tabbladen die in de huidige extensie worden uitgevoerd. Als windowId is ingevoerd, worden alleen de vensterobjecten van tabbladen geretourneerd die aan het ingevoerde venster zijn gekoppeld.

Parameters

  • windowId

    number optioneel

Retourzendingen

  • Venster[]

    Matrix van algemene vensterobjecten

getURL()

≤ MV2 Beëindigd sinds Chrome 58
chrome.extension.getURL(
  path: string,
): string

Gebruik runtime.getURL.

Converteert een relatief pad binnen een installatiemap van een extensie naar een volledig gekwalificeerde URL.

Parameters

  • pad

    tekenreeks

    Een pad naar een bron binnen een extensie, uitgedrukt ten opzichte van de installatiemap.

Retourzendingen

  • tekenreeks

    De volledig gekwalificeerde URL naar de bron.

getViews()

Alleen voorgrond 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

Retourneert een matrix van de JavaScript-vensterobjecten voor elk van de pagina's die worden uitgevoerd in de huidige extensie.

Parameters

  • fetchProperties

    object optioneel

    • tabId

      number optioneel

      Chrome 54+

      Een weergave zoeken op basis van een tabblad-ID. Als dit veld wordt weggelaten, worden alle weergaven geretourneerd.

    • type

      ViewType optioneel

      Het type weergave dat moet worden opgehaald. Als dit wordt weggelaten, worden alle weergaven geretourneerd (inclusief achtergrondpagina's en tabbladen).

    • windowId

      number optioneel

      Het venster waartoe de zoekopdracht moet worden beperkt. Als u dit weglaat, worden alle weergaven geretourneerd.

Retourzendingen

  • Venster[]

    Matrix van algemene objecten

isAllowedFileSchemeAccess()

Promise 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
): Promise<boolean>

Haalt de status op van de toegang van de extensie tot het schema 'file://'. Dit komt overeen met de door de gebruiker beheerde instelling 'Toegang tot bestands-URL's toestaan' per extensie, die toegankelijk is via de pagina chrome://extensions.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleaans

      Waar als de extensie toegang heeft tot het schema 'file://', anders onwaar.

Retourzendingen

  • Promise<boolean>

    Chrome 99 of hoger

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

isAllowedIncognitoAccess()

Promise 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
): Promise<boolean>

Haalt de status van de toegang van de extensie tot de incognitomodus op. Dit komt overeen met de door de gebruiker beheerde instelling Toegestaan in incognitomodus per extensie, die toegankelijk is via de pagina chrome://extensions.

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleaans

      Waar als de extensie toegang heeft tot de incognitomodus, anders onwaar.

Retourzendingen

  • Promise<boolean>

    Chrome 99 of hoger

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

sendRequest()

Promise &leq; MV2 Beëindigd
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
): Promise<any>

Gebruik runtime.sendMessage.

Stuurt één verzoek naar andere listeners binnen de extensie. Vergelijkbaar met runtime.connect, maar stuurt maar één verzoek met een optionele reactie. De gebeurtenis extension.onRequest wordt geactiveerd op elke pagina van de extensie.

Parameters

  • extensionId

    tekenreeks optioneel

    De extensie-ID van de extensie waarmee je verbinding wilt maken. Als je dit weglaat, is de standaardwaarde je eigen extensie.

  • verzoek

    alle

  • callback

    functie optioneel

    Chrome 99 of hoger

    De parameter callback ziet er zo uit: 

    (response: any) => void

    • reactie

      alle

      Het json-reactieobject dat is gestuurd door de verwerker van het verzoek. Als er een fout optreedt tijdens het koppelen met de extensie, wordt de promise afgewezen.

Retourzendingen

  • Promise<any>

    Chrome 99 of hoger

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

Hiermee stel je de waarde in van de CGI-parameter ap die wordt gebruikt in de update-URL van de extensie. Deze waarde wordt genegeerd voor extensies die worden gehost in de Chrome-extensiegalerij.

Parameters

  • gegevens

    tekenreeks

Evenementen

onRequest

&leq; MV2 Beëindigd
chrome.extension.onRequest.addListener(
  callback: function,
)

Gebruik runtime.onMessage.

Wordt geactiveerd als een verzoek wordt gestuurd vanuit een extensieproces of een contentscript.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • verzoek

      alle

    • sendResponse

      functie

      De parameter sendResponse ziet er zo uit: 

      () => void

onRequestExternal

&leq; MV2 Beëindigd
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

Gebruik runtime.onMessageExternal.

Wordt geactiveerd als een verzoek wordt gestuurd vanuit een andere extensie.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • verzoek

      alle

    • sendResponse

      functie

      De parameter sendResponse ziet er zo uit: 

      () => void