chrome.action

Deskripsi

Gunakan chrome.action API untuk mengontrol ikon ekstensi di toolbar Google Chrome.

Ikon tindakan ditampilkan di toolbar browser di samping omnibox. Setelah diinstal, ikon ini akan muncul di menu ekstensi (ikon potongan puzzle). Pengguna dapat menyematkan ikon ekstensi Anda ke toolbar.

Ketersediaan

Chrome 88 dan yang lebih baru MV3 dan yang lebih baru

Manifes

Kunci berikut harus dideklarasikan dalam manifes untuk menggunakan API ini.

"action"

Untuk menggunakan chrome.action API, tentukan "manifest_version" dari 3 dan sertakan kunci "action" dalam file manifes Anda.

Catatan: Setiap ekstensi memiliki ikon di toolbar Chrome, meskipun kunci "action" tidak ditambahkan ke manifes.

{
  "name": "Action Extension",
  ...
  "action": {
    "default_icon": {              // optional
      "16": "images/icon16.png",   // optional
      "24": "images/icon24.png",   // optional
      "32": "images/icon32.png"    // optional
    },
    "default_title": "Click Me",   // optional, shown in tooltip
    "default_popup": "popup.html"  // optional
  },
  ...
}

Kunci "action" (beserta turunannya) bersifat opsional. Jika tidak disertakan, ekstensi Anda tetap ditampilkan di toolbar untuk memberikan akses ke menu ekstensi. Karena itu, sebaiknya Anda selalu menyertakan setidaknya kunci "action" dan "default_icon".

Konsep dan penggunaan

Bagian-bagian UI

Ikon

Ikon adalah gambar utama pada toolbar untuk ekstensi Anda, dan ditetapkan oleh tombol "default_icon" di kunci "action" manifes Anda. Ikon harus memiliki panjang dan lebar 16 piksel yang tidak tergantung perangkat (DIP).

Kunci "default_icon" adalah kamus ukuran untuk jalur gambar. Chrome menggunakan ikon ini untuk memilih skala gambar yang akan digunakan. Jika kecocokan persis tidak ditemukan, Chrome akan memilih yang terdekat dan menskalakannya agar sesuai dengan gambar, yang mungkin memengaruhi kualitas gambar.

Karena perangkat dengan faktor skala yang kurang umum seperti 1,5x atau 1,2x menjadi lebih umumnya, sebaiknya Anda menyediakan beberapa ukuran untuk ikon. Hal ini juga menjaga agar ekstensi Anda tetap aman dari potensi perubahan ukuran layar ikon. Namun, jika hanya menyediakan satu ukuran, kunci "default_icon" juga dapat disetel ke {i>string<i} dengan jalur ke ikon tunggal, bukan kamus.

Anda juga dapat memanggil action.setIcon() untuk menetapkan ikon ekstensi Anda secara terprogram dengan menentukan jalur gambar yang berbeda atau memberikan ikon yang dihasilkan secara dinamis menggunakan kanvas HTML elemen, atau, jika menyetel dari pekerja layanan ekstensi, parameter offscreen Canvas API.

const canvas = new OffscreenCanvas(16, 16);
const context = canvas.getContext('2d');
context.clearRect(0, 0, 16, 16);
context.fillStyle = '#00FF00';  // Green
context.fillRect(0, 0, 16, 16);
const imageData = context.getImageData(0, 0, 16, 16);
chrome.action.setIcon({imageData: imageData}, () => { /* ... */ });

Catatan: action.setIcon() API dimaksudkan untuk menyetel gambar statis. Jangan gunakan gambar animasi untuk ikon Anda.

Untuk paket ekstensi (diinstal dari file .crx), gambar dapat dalam format yang kebanyakan dapat menampilkan, termasuk PNG, JPEG, BMP, ICO, dan lainnya. SVG tidak didukung. Ekstensi yang tidak diekstrak harus menggunakan gambar PNG.

Tooltip (judul)

Tooltip, atau judul, muncul saat pengguna mengarahkan kursor mouse ke ikon ekstensi di {i>toolbar<i}. Hal ini juga disertakan dalam teks yang dapat diakses yang diucapkan oleh pembaca layar saat tombol muncul fokus.

Tooltip default ditetapkan menggunakan kolom "default_title" dari kunci "action" di manifest.json. Anda juga dapat menetapkannya secara terprogram dengan memanggil action.setTitle().

Badge

Tindakan dapat menampilkan "badge" secara opsional — sedikit teks yang dilapiskan di atas ikon. Hal ini memungkinkan Anda memperbarui tindakan untuk menampilkan sejumlah kecil informasi tentang status ekstensi, seperti penghitung. Badge memiliki komponen teks dan warna latar belakang. Karena ruangnya terbatas, sebaiknya teks badge menggunakan empat karakter atau kurang.

Untuk membuat badge, setel secara terprogram dengan memanggil action.setBadgeBackgroundColor() dan action.setBadgeText(). Tidak ada setelan badge default dalam manifes. Nilai warna badge dapat berupa array empat bilangan bulat antara 0 dan 255 yang membentuk warna RGBA badge atau string dengan nilai warna CSS.

chrome.action.setBadgeBackgroundColor(
  {color: [0, 255, 0, 0]},  // Green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: '#00FF00'},  // Also green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: 'green'},  // Also, also green
  () => { /* ... */ },
);

Pop-up

Pop-up tindakan ditampilkan saat pengguna mengklik tombol tindakan ekstensi di {i>toolbar<i}. Pop-up dapat berisi konten HTML apa pun yang Anda sukai, dan akan disesuaikan ukurannya secara otomatis isinya. Ukuran pop-up harus antara 25x25 dan 800x600 piksel.

Pop-up awalnya ditetapkan oleh properti "default_popup" di kunci "action" di File manifest.json. Jika ada, properti ini harus mengarah ke jalur relatif dalam ekstensi saat ini. Ini juga dapat diperbarui secara dinamis untuk menunjuk ke jalur relatif yang berbeda menggunakan Metode action.setPopup().

Catatan: Peristiwa action.onClicked tidak akan dikirim jika tindakan ekstensi telah menetapkan pop-up ke ditampilkan saat tab saat ini diklik.

Kasus penggunaan

Status per tab

Tindakan ekstensi dapat memiliki status yang berbeda untuk setiap tab. Untuk menetapkan nilai bagi individu Gunakan properti tabId di metode setelan API action. Misalnya, untuk menetapkan teks badge untuk tab tertentu, lakukan hal seperti berikut:

function getTabId() { /* ... */}
function getTabBadge() { /* ... */}

chrome.action.setBadgeText(
  {
    text: getTabBadge(tabId),
    tabId: getTabId(),
  },
  () => { ... }
);

Jika properti tabId tidak diisi, setelan akan diperlakukan sebagai setelan global. Khusus tab lebih diprioritaskan daripada setelan global.

Status diaktifkan

Secara default, tindakan toolbar diaktifkan (dapat diklik) pada setiap tab. Anda dapat mengontrolnya menggunakan Metode action.enable() dan action.disable(). Hal ini hanya memengaruhi apakah pop-up (jika ada) atau action.onClicked peristiwa dikirim ke ekstensi Anda; hal ini tidak memengaruhi kehadiran tindakan di toolbar.

Contoh

Contoh berikut menunjukkan beberapa cara umum penggunaan tindakan dalam ekstensi. Untuk mencoba API ini, instal contoh Action API dari chrome-extension-samples repositori resource.

Menampilkan pop-up

Sangat umum bagi ekstensi untuk menampilkan pop-up saat pengguna mengklik tindakan ekstensi. Kepada terapkan ini di ekstensi Anda sendiri, deklarasikan pop-up di manifest.json dan tentukan konten yang akan ditampilkan Chrome dalam pop-up.

// manifest.json
{
  "name": "Action popup demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to view a popup",
    "default_popup": "popup.html"
  }
}

<!-- popup.html -->
<!DOCTYPE html>
<html>
<head>
  <style>
    html {
      min-height: 5em;
      min-width: 10em;
      background: salmon;
    }
  </style>
</head>
<body>
  <p>Hello, world!</p>
</body>
</html>

Memasukkan skrip konten saat diklik

Pola umum ekstensi adalah menampilkan fitur utamanya menggunakan tindakan. Contoh berikut menunjukkan pola ini. Saat pengguna mengklik tindakan, ekstensi memasukkan skrip konten ke halaman saat ini. Skrip konten kemudian menampilkan peringatan untuk memverifikasi bahwa semuanya bekerja seperti yang diharapkan.

// manifest.json
{
  "name": "Action script injection demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to show an alert"
  },
  "permissions": ["activeTab", "scripting"],
  "background": {
    "service_worker": "background.js"
  }
}

// background.js
chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['content.js']
  });
});

// content.js
alert('Hello, world!');

Mengemulasi tindakan dengan declarativeContent

Contoh ini menunjukkan cara logika latar belakang ekstensi dapat (a) menonaktifkan tindakan secara default dan (b) gunakan declarativeContent untuk mengaktifkan tindakan di situs tertentu.

// service-worker.js

// Wrap in an onInstalled callback to avoid unnecessary work
// every time the service worker is run
chrome.runtime.onInstalled.addListener(() => {
  // Page actions are disabled by default and enabled on select tabs
  chrome.action.disable();

  // Clear all rules to ensure only our expected rules are set
  chrome.declarativeContent.onPageChanged.removeRules(undefined, () => {
    // Declare a rule to enable the action on example.com pages
    let exampleRule = {
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: {hostSuffix: '.example.com'},
        })
      ],
      actions: [new chrome.declarativeContent.ShowAction()],
    };

    // Finally, apply our new array of rules
    let rules = [exampleRule];
    chrome.declarativeContent.onPageChanged.addRules(rules);
  });
});

Jenis

OpenPopupOptions

Chrome 99 dan yang lebih baru

Properti

• windowId

  angka opsional

  ID jendela untuk membuka pop-up tindakan. Setelan defaultnya adalah jendela yang sedang aktif jika tidak ditentukan.

TabDetails

Properti

• tabId

  angka opsional

  ID tab yang akan dimintakan status. Jika tidak ada tab yang ditentukan, status non-tab tertentu akan ditampilkan.

UserSettings

Chrome 91 dan yang lebih baru

Kumpulan setelan yang ditentukan pengguna yang terkait dengan tindakan ekstensi.

Properti

• isOnToolbar

  boolean

  Apakah ikon tindakan ekstensi terlihat di jendela browser toolbar tingkat teratas (yaitu, apakah ekstensi telah 'disematkan' oleh pengguna).

UserSettingsChange

Tertunda

Properti

• isOnToolbar

  boolean opsional

  Apakah ikon tindakan ekstensi terlihat di jendela browser toolbar tingkat teratas (yaitu, apakah ekstensi telah 'disematkan' oleh pengguna).

Metode

disable()

Janji

chrome.action.disable(
  tabId?: number,
  callback?: function,
)

Menonaktifkan tindakan untuk tab.

Parameter

• tabId

  angka opsional

  ID tab yang tindakannya ingin Anda ubah.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

enable()

Janji

chrome.action.enable(
  tabId?: number,
  callback?: function,
)

Mengaktifkan tindakan untuk tab. Secara default, tindakan diaktifkan.

Parameter

• tabId

  angka opsional

  ID tab yang tindakannya ingin Anda ubah.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getBadgeBackgroundColor()

Janji

chrome.action.getBadgeBackgroundColor(
  details: TabDetails,
  callback?: function,
)

Mendapatkan warna latar belakang tindakan.

Parameter

• detail

  TabDetails

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (result: ColorArray) => void

  • hasil

    ColorArray

Hasil

• Promise&lt;browserAction.ColorArray&gt;

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getBadgeText()

Janji

chrome.action.getBadgeText(
  details: TabDetails,
  callback?: function,
)

Mendapatkan teks badge tindakan. Jika tidak ada tab yang ditentukan, teks badge yang bukan khusus tab akan ditampilkan. Jika displayActionCountAsBadgeText diaktifkan, teks placeholder akan ditampilkan kecuali jika izin declarativeNetRequestFeedback ada atau teks badge khusus tab diberikan.

Parameter

• detail

  TabDetails

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (result: string) => void

  • hasil

    string

Hasil

• Promise<string>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getBadgeTextColor()

Janji Chrome 110 dan yang lebih baru

chrome.action.getBadgeTextColor(
  details: TabDetails,
  callback?: function,
)

Mendapatkan warna teks tindakan.

Parameter

• detail

  TabDetails

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (result: ColorArray) => void

  • hasil

    ColorArray

Hasil

• Promise&lt;browserAction.ColorArray&gt;

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getPopup()

Janji

chrome.action.getPopup(
  details: TabDetails,
  callback?: function,
)

Mendapatkan set dokumen html sebagai pop-up untuk tindakan ini.

Parameter

• detail

  TabDetails

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (result: string) => void

  • hasil

    string

Hasil

• Promise<string>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getTitle()

Janji

chrome.action.getTitle(
  details: TabDetails,
  callback?: function,
)

Mendapatkan judul tindakan.

Parameter

• detail

  TabDetails

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (result: string) => void

  • hasil

    string

Hasil

• Promise<string>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getUserSettings()

Janji Chrome 91 dan yang lebih baru

chrome.action.getUserSettings(
  callback?: function,
)

Menampilkan setelan buatan pengguna yang terkait dengan tindakan ekstensi.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (userSettings: UserSettings) => void

  • userSettings

    UserSettings

Hasil

• Promise&lt;UserSettings&gt;

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

isEnabled()

Janji Chrome 110 dan yang lebih baru

chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

Menunjukkan apakah tindakan ekstensi diaktifkan untuk tab (atau secara global jika tabId tidak disediakan). Tindakan yang diaktifkan hanya menggunakan declarativeContent akan selalu menampilkan salah.

Parameter

• tabId

  angka opsional

  ID tab yang ingin Anda periksa statusnya pengaktifannya.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (isEnabled: boolean) => void

  • isEnabled

    boolean

    True jika tindakan ekstensi diaktifkan.

Hasil

• Promise&lt;boolean&gt;

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

openPopup()

Janji Chrome 127 dan yang lebih baru

chrome.action.openPopup(
  options?: OpenPopupOptions,
  callback?: function,
)

Membuka pop-up ekstensi. Antara Chrome 118 dan Chrome 126, fitur ini hanya tersedia untuk ekstensi yang diinstal kebijakan.

Parameter

• opsi

  OpenPopupOptions opsional

  Menentukan opsi untuk membuka pop-up.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setBadgeBackgroundColor()

Janji

chrome.action.setBadgeBackgroundColor(
  details: object,
  callback?: function,
)

Menetapkan warna latar belakang untuk badge.

Parameter

• detail

  objek

  • warna

    string | ColorArray

    Array berisi empat bilangan bulat dalam rentang [0,255] yang membentuk warna RGBA badge. Misalnya, merah buram adalah [255, 0, 0, 255]. Dapat juga berupa string dengan nilai CSS, dengan merah buram menjadi #FF0000 atau #F00.

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setBadgeText()

Janji

chrome.action.setBadgeText(
  details: object,
  callback?: function,
)

Menetapkan teks badge untuk tindakan. Badge ditampilkan di bagian atas ikon.

Parameter

• detail

  objek

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

  • teks

    string opsional

    Karakter dalam jumlah berapa pun dapat dimasukkan, tetapi hanya sekitar empat karakter yang dapat dimuat dalam ruang. Jika string kosong ('') diteruskan, teks badge akan dihapus. Jika tabId ditentukan dan text bernilai null, teks untuk tab yang ditentukan akan dihapus dan defaultnya adalah teks badge global.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setBadgeTextColor()

Janji Chrome 110 dan yang lebih baru

chrome.action.setBadgeTextColor(
  details: object,
  callback?: function,
)

Menetapkan warna teks untuk badge.

Parameter

• detail

  objek

  • warna

    string | ColorArray

    Array berisi empat bilangan bulat dalam rentang [0,255] yang membentuk warna RGBA badge. Misalnya, merah buram adalah [255, 0, 0, 255]. Dapat juga berupa string dengan nilai CSS, dengan merah buram menjadi #FF0000 atau #F00. Jika nilai ini tidak ditetapkan, warna yang dipilih secara otomatis akan kontras dengan warna latar belakang badge sehingga teks akan terlihat. Warna dengan nilai alfa yang setara dengan 0 tidak akan disetel dan akan menampilkan error.

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setIcon()

Janji

chrome.action.setIcon(
  details: object,
  callback?: function,
)

Menetapkan ikon untuk tindakan. Ikon dapat ditetapkan sebagai jalur ke file gambar atau sebagai data piksel dari elemen kanvas, atau sebagai kamus dari salah satu ikon tersebut. Properti path atau imageData harus ditentukan.

Parameter

• detail

  objek

  • imageData

    ImageData | objek opsional

    Objek ImageData atau kamus {size -> ImageData} yang mewakili ikon yang akan disetel. Jika ikon ditetapkan sebagai kamus, gambar sebenarnya yang akan digunakan akan dipilih bergantung pada kepadatan piksel layar. Jika jumlah piksel gambar yang sesuai dengan satu unit ruang layar sama dengan scale, gambar dengan ukuran scale * n akan dipilih, dengan n adalah ukuran ikon di UI. Minimal satu gambar harus ditentukan. Perhatikan bahwa 'details.imageData = foo' sama dengan 'details.imageData = {'16': foo}'

  • jalur

    string | objek opsional

    Baik jalur gambar relatif maupun kamus {size -> relatif image path} menunjuk ke ikon yang akan diatur. Jika ikon ditetapkan sebagai kamus, gambar sebenarnya yang akan digunakan akan dipilih bergantung pada kepadatan piksel layar. Jika jumlah piksel gambar yang sesuai dengan satu unit ruang layar sama dengan scale, gambar dengan ukuran scale * n akan dipilih, dengan n adalah ukuran ikon di UI. Minimal satu gambar harus ditentukan. Perhatikan bahwa 'details.path = foo' sama dengan 'details.path = {'16': foo}'

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setPopup()

Janji

chrome.action.setPopup(
  details: object,
  callback?: function,
)

Menyetel dokumen HTML yang akan dibuka sebagai pop-up saat pengguna mengklik ikon tindakan.

Parameter

• detail

  objek

  • pop-up

    string

    Jalur relatif ke file HTML yang akan ditampilkan di pop-up. Jika ditetapkan ke string kosong (''), pop-up tidak akan ditampilkan.

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setTitle()

Janji

chrome.action.setTitle(
  details: object,
  callback?: function,
)

Menetapkan judul tindakan. Kolom ini akan muncul di tooltip.

Parameter

• detail

  objek

  • tabId

    angka opsional

    Membatasi perubahan saat tab tertentu dipilih. Otomatis direset saat tab ditutup.

  • judul

    string

    String yang akan ditampilkan tindakan saat kursor diarahkan ke atasnya.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onClicked

chrome.action.onClicked.addListener(
  callback: function,
)

Diaktifkan jika ikon tindakan diklik. Peristiwa ini tidak akan diaktifkan jika tindakan memiliki pop-up.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (tab: tabs.Tab) => void

  • tab

    tabs.Tab

onUserSettingsChanged

Tertunda

chrome.action.onUserSettingsChanged.addListener(
  callback: function,
)

Diaktifkan saat setelan yang ditentukan pengguna yang terkait dengan perubahan tindakan ekstensi.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (change: UserSettingsChange) => void

  • ubah

    UserSettingsChange