externally_connectable

Properti manifes "externally_connectable" mendeklarasikan ekstensi dan halaman web mana yang dapat terhubung ke ekstensi Anda menggunakan runtime.connect() dan runtime.sendMessage().

Untuk melihat tutorial tentang penerusan pesan, lihat pengiriman pesan lintas ekstensi dan mengirim pesan dari halaman web.

Menghubungkan tanpa externally_connectable

Jika kunci externally_connectable tidak dideklarasikan dalam manifes ekstensi Anda, semua ekstensi dapat terhubung, tetapi tidak ada halaman web yang dapat terhubung. Akibatnya, saat memperbarui manifes untuk menggunakan externally_connectable, jika "ids": ["*"] tidak ditentukan, ekstensi lain akan kehilangan kemampuan untuk terhubung ke ekstensi Anda. Hal ini mungkin merupakan konsekuensi yang tidak diinginkan, jadi perhatikan hal ini.

Manifes

{
  "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
  },
  ...
}

Referensi

Kunci manifes "externally_connectable" mencakup properti opsional berikut:

"ids"

ID ekstensi yang diizinkan untuk terhubung. Jika dibiarkan kosong atau tidak ditentukan, tidak ada ekstensi atau aplikasi yang dapat terhubung. Wildcard "*" akan mengizinkan semua ekstensi dan aplikasi untuk terhubung.

"matches"

Pola pencocokan untuk halaman web yang diizinkan untuk terhubung. Jika dibiarkan kosong atau tidak ditentukan, tidak ada halaman web yang dapat terhubung.

"accepts_tls_channel_id"

Memungkinkan ekstensi menggunakan ID channel TLS dari halaman web yang terhubung ke ekstensi. Halaman web juga harus memilih untuk mengirim ID saluran TLS ke ekstensi dengan menyetel includeTlsChannelId ke true di connectInfo runtime.connect atau options runtime.sendMessage. Jika ditetapkan ke false, runtime.MessageSender.tlsChannelId tidak akan pernah ditetapkan dalam keadaan apa pun.

Hal ini tidak memengaruhi skrip konten.