webextensions examples

WebExtensions-contoh

https://github.com/mdn/webextensions-examples

Dikelola oleh tim add-on Mozilla.

WebExtensions adalah cara untuk menulis ekstensi browser: yaitu, program yang diinstal di dalam browser web yang memodifikasi perilaku browser atau halaman web yang dimuat oleh browser. WebExtensions dibangun di atas serangkaian API lintas-browser, sehingga webextensions yang ditulis untuk Google Chrome, Opera, atau Edge, dalam banyak kasus, akan dijalankan di Firefox juga.

Repositori "WebExtensions-Exhamples" adalah kumpulan WebExtensions yang sederhana, lengkap, dan dapat diinstal. Contohnya menunjukkan cara menggunakan API WebExtensions, dan Anda dapat menggunakannya sebagai titik awal untuk WebExtensions Anda.

Untuk indeks semua contoh, lihat halaman "Contoh Ekstensi" di MDN.

Contohnya tersedia di bawah Lisensi Publik Mozilla 2.0.

Cara menggunakan "WebExtensions-contoh"

Untuk menggunakan repositori, pertama -tama klon.

Setiap contoh ada dalam folder tingkat atas dan termasuk readme pendek yang menjelaskan apa yang dilakukannya. Untuk melihat cara kerja contoh, instal di Firefox dengan mengikuti instruksi instalasi.

Untuk menemukan jalan Anda di sekitar struktur internal webextension, lihat anatomi halaman webextension di MDN.

Untuk menggunakan contoh -contoh ini di Firefox, gunakan rilis Firefox terbaru. Namun, sebagian besar contoh bekerja dengan rilis sebelumnya.

Beberapa contoh bergantung pada API yang hanya tersedia dalam versi pra-rilis Firefox. Di mana hal ini terjadi, contoh tersebut menyatakan versi minimum yang dibutuhkan dalam atribut strict_min_version dari browser_specific_settings key dalam file manifest.json ekstensi.

Menginstal contoh

Beberapa contoh hanya berfungsi pada domain atau halaman tertentu. Rincian pembatasan apa pun disediakan dalam file readme setiap contoh. Tak satu pun dari contoh yang berfungsi di jendela penjelajahan pribadi secara default, lihat ekstensi dalam penjelajahan pribadi untuk detailnya.

Untuk menjalankan ekstensi contoh:

1. Buka Firefox dan muat Halaman about:debugging :. Klik Muat Add-On sementara dan pilih file manifest.json di dalam folder ekstensi contoh. Berikut adalah video yang menunjukkan cara melakukan ini.
2. Instal alat web-ext. Pada baris perintah, buka folder ekstensi contoh dan ketik web-ext run . Ini meluncurkan Firefox dan memasang ekstensi secara otomatis. Alat ini menyediakan beberapa fitur pengembangan tambahan, seperti pemuatan ulang otomatis.

Dukungan untuk browser lain

Contoh -contoh ini diuji di Firefox. Mereka dapat bekerja di browser lain, jika browser mendukung API yang digunakan. Perhatikan bahwa semua contoh ini menggunakan namespace browser dan berjanji untuk bekerja dengan fungsi asinkron. Ini berarti contoh tidak akan berfungsi di Chrome kecuali Anda menggunakan polyfill yang disediakan oleh Mozilla. Lihat ikhtisar API WebExtension untuk informasi lebih lanjut.

Pelajari lebih lanjut

Untuk mempelajari lebih lanjut tentang pengembangan WebExtensions, lihat dokumentasi WebExtensions tentang MDN untuk memulai panduan, tutorial, dan dokumen referensi API lengkap.

Masalah?

Jika Anda menghadapi masalah:

• Posting kueri di Forum Wacana Add-On
• Email milis Dev-Addons
• Hubungi Tim Add-On di Ruang Add-Ons di Matrix

Jika Anda tidak dapat menyelesaikan masalah ini, ajukan bug.

Berkontribusi

Kami menyambut kontribusi, apakah itu contoh baru, fitur baru, perbaikan bug, atau terjemahan string yang dapat dilokalkan. Silakan lihat file contributing.md untuk lebih jelasnya.