De manifesteigenschap "externally_connectable"
geeft aan welke extensies en webpagina's verbinding kunnen maken met uw extensie met behulp van runtime.connect()
en runtime.sendMessage()
.
Voor een tutorial over het doorgeven van berichten, zie Berichten over meerdere extensies en berichten verzenden vanaf webpagina's .
Verbind zonder extern_connectable
Als de externally_connectable
sleutel niet wordt gedeclareerd in het manifest van uw extensie, kunnen alle extensies verbinding maken, maar kunnen geen webpagina's verbinding maken. Als gevolg hiervan verliezen andere extensies de mogelijkheid om verbinding te maken met uw extensie als u uw manifest bijwerkt om externally_connectable
te gebruiken en "ids": ["*"]
niet is opgegeven. Dit kan een onbedoeld gevolg zijn, dus houd hier rekening mee.
Manifest
{
"name": "My externally connectable extension",
"externally_connectable": {
"ids": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
...
],
// If this field is not specified, no web pages can connect.
"matches": [
"https://*.google.com/*",
"*://*.chromium.org/*",
...
],
"accepts_tls_channel_id": false
},
...
}
Referentie
De manifestsleutel "externally_connectable"
bevat de volgende optionele eigenschappen:
-
"ids"
- De ID's van extensies die verbinding mogen maken. Als u dit leeg of niet specificeert, kunnen er geen extensies of apps verbinding maken. Met het jokerteken
"*"
kunnen alle extensies en apps verbinding maken. -
"matches"
- De URL-patronen voor webpagina's die verbinding mogen maken. Indien leeg of niet gespecificeerd, kunnen geen webpagina's verbinding maken. Patronen kunnen geen jokertekendomeinen of subdomeinen van (effectieve) topniveaudomeinen bevatten, bijvoorbeeld:
✅ Geldige URL's | ❌ Ongeldige URL's |
---|---|
*://example.com/ | *://example.com/one/ |
http://*.example.org/* | <all_urls> |
https://example.com/* | http://*/* |
-
"accepts_tls_channel_id"
- Hiermee kan de extensie de TLS-kanaal-ID gebruiken van de webpagina die verbinding maakt met de extensie. De webpagina moet er ook voor kiezen om de TLS-kanaal-ID naar de extensie te verzenden door
includeTlsChannelId
in te stellen optrue
in connectInfo van runtime.connect of in de opties van runtime.sendMessage. Indien ingesteld opfalse
, zal runtime.MessageSender.tlsChannelId onder geen enkele omstandigheid worden ingesteld.
Dit heeft geen invloed op inhoudsscripts.