# Proyek Ekstensi Browser Bagian 1: Semua Tentang Browser ```mermaid journey title Your Browser Extension Development Journey section Foundation Understand browsers: 3: Student Learn extension types: 4: Student Setup development: 4: Student section Development Build interface: 4: Student Add functionality: 5: Student Handle data: 5: Student section Integration Test in browser: 5: Student Debug issues: 4: Student Polish experience: 5: Student ```  > Sketchnote oleh [Wassim Chegham](https://dev.to/wassimchegham/ever-wondered-what-happens-when-you-type-in-a-url-in-an-address-bar-in-a-browser-3dob) ## Kuis Pra-Pelajaran [Kuis pra-pelajaran](https://ff-quizzes.netlify.app/web/quiz/23) ### Pengantar Ekstensi browser adalah aplikasi mini yang meningkatkan pengalaman menjelajah web Anda. Seperti visi asli Tim Berners-Lee tentang web interaktif, ekstensi memperluas kemampuan browser melampaui sekadar melihat dokumen. Dari pengelola kata sandi yang menjaga keamanan akun Anda hingga pemilih warna yang membantu desainer mendapatkan warna yang sempurna, ekstensi menyelesaikan tantangan sehari-hari dalam menjelajah web. Sebelum kita membangun ekstensi pertama Anda, mari kita pahami cara kerja browser. Sama seperti Alexander Graham Bell yang perlu memahami transmisi suara sebelum menciptakan telepon, mengetahui dasar-dasar browser akan membantu Anda membuat ekstensi yang terintegrasi dengan sistem browser yang ada. Pada akhir pelajaran ini, Anda akan memahami arsitektur browser dan mulai membangun ekstensi pertama Anda. ```mermaid mindmap root((Browser Architecture)) Core Components Rendering Engine JavaScript Engine Network Stack Storage APIs User Interface Address Bar Tab Management Bookmarks Extension Icons Extension System Manifest Files Content Scripts Background Pages Popup Windows Security Model Same-Origin Policy Permissions API Content Security Isolated Worlds Development Tools DevTools Integration Debug Console Performance Monitor Extension Inspector ``` ## Memahami Browser Web Browser web pada dasarnya adalah penerjemah dokumen yang canggih. Ketika Anda mengetik "google.com" di bilah alamat, browser melakukan serangkaian operasi kompleks - meminta konten dari server di seluruh dunia, lalu memparsing dan merender kode tersebut menjadi halaman web interaktif yang Anda lihat. Proses ini mencerminkan bagaimana browser web pertama, WorldWideWeb, dirancang oleh Tim Berners-Lee pada tahun 1990 untuk membuat dokumen berhiperlink dapat diakses oleh semua orang. ✅ **Sedikit sejarah**: Browser pertama disebut 'WorldWideWeb' dan dibuat oleh Sir Timothy Berners-Lee pada tahun 1990.  > Beberapa browser awal, via [Karen McGrane](https://www.slideshare.net/KMcGrane/week-4-ixd-history-personal-computing) ### Bagaimana Browser Memproses Konten Web Proses antara memasukkan URL dan melihat halaman web melibatkan beberapa langkah terkoordinasi yang terjadi dalam hitungan detik: ```mermaid sequenceDiagram participant User participant Browser participant Extension participant DNS participant Server User->>Browser: Types URL and presses Enter Browser->>Extension: Trigger beforeRequest event Extension->>Extension: Check if URL needs modification Browser->>DNS: Looks up server IP address DNS->>Browser: Returns IP address Browser->>Server: Requests web page content Server->>Browser: Sends HTML, CSS, and JavaScript Browser->>Extension: Trigger beforeResponse event Extension->>Extension: Modify content if needed Browser->>User: Renders complete web page Extension->>User: Show extension UI updates ``` **Inilah yang dicapai oleh proses ini:** - **Menerjemahkan** URL yang dapat dibaca manusia menjadi alamat IP server melalui pencarian DNS - **Membangun** koneksi aman dengan server web menggunakan protokol HTTP atau HTTPS - **Meminta** konten halaman web tertentu dari server - **Menerima** markup HTML, gaya CSS, dan kode JavaScript dari server - **Merender** semua konten menjadi halaman web interaktif yang Anda lihat ### Fitur Inti Browser Browser modern menyediakan banyak fitur yang dapat dimanfaatkan oleh pengembang ekstensi: | Fitur | Tujuan | Peluang Ekstensi | |-------|--------|------------------| | **Rendering Engine** | Menampilkan HTML, CSS, dan JavaScript | Modifikasi konten, injeksi gaya | | **JavaScript Engine** | Menjalankan kode JavaScript | Skrip khusus, interaksi API | | **Local Storage** | Menyimpan data secara lokal | Preferensi pengguna, data cache | | **Network Stack** | Menangani permintaan web | Pemantauan permintaan, analisis data | | **Security Model** | Melindungi pengguna dari konten berbahaya | Penyaringan konten, peningkatan keamanan | **Memahami fitur-fitur ini membantu Anda:** - **Mengidentifikasi** di mana ekstensi Anda dapat memberikan nilai tambah terbesar - **Memilih** API browser yang tepat untuk fungsi ekstensi Anda - **Merancang** ekstensi yang bekerja secara efisien dengan sistem browser - **Memastikan** ekstensi Anda mengikuti praktik terbaik keamanan browser ### Pertimbangan Pengembangan Lintas-Browser Browser yang berbeda menerapkan standar dengan variasi kecil, mirip dengan bagaimana bahasa pemrograman yang berbeda mungkin menangani algoritma yang sama secara berbeda. Chrome, Firefox, dan Safari masing-masing memiliki karakteristik unik yang harus dipertimbangkan pengembang selama pengembangan ekstensi. > 💡 **Tip Pro**: Gunakan [caniuse.com](https://www.caniuse.com) untuk memeriksa teknologi web mana yang didukung di berbagai browser. Ini sangat berharga saat merencanakan fitur ekstensi Anda! **Pertimbangan utama untuk pengembangan ekstensi:** - **Uji** ekstensi Anda di browser Chrome, Firefox, dan Edge - **Sesuaikan** dengan API ekstensi browser dan format manifest yang berbeda - **Tangani** karakteristik kinerja dan batasan yang bervariasi - **Sediakan** alternatif untuk fitur spesifik browser yang mungkin tidak tersedia ✅ **Wawasan Analitik**: Anda dapat menentukan browser mana yang lebih disukai pengguna Anda dengan memasang paket analitik dalam proyek pengembangan web Anda. Data ini membantu Anda memprioritaskan browser mana yang harus didukung terlebih dahulu. ## Memahami Ekstensi Browser Ekstensi browser menyelesaikan tantangan umum dalam menjelajah web dengan menambahkan fungsionalitas langsung ke antarmuka browser. Alih-alih memerlukan aplikasi terpisah atau alur kerja yang rumit, ekstensi memberikan akses langsung ke alat dan fitur. Konsep ini mencerminkan bagaimana para pionir komputer awal seperti Douglas Engelbart membayangkan meningkatkan kemampuan manusia dengan teknologi - ekstensi meningkatkan fungsionalitas dasar browser Anda. ```mermaid quadrantChart title Browser Extension Categories x-axis Simple --> Complex y-axis Personal Use --> Professional Tools quadrant-1 Developer Tools quadrant-2 Enterprise Solutions quadrant-3 Personal Utilities quadrant-4 Productivity Apps Ad Blockers: [0.3, 0.2] Password Managers: [0.7, 0.3] Color Pickers: [0.4, 0.8] Code Formatters: [0.8, 0.9] Note Taking: [0.6, 0.5] Video Downloaders: [0.5, 0.2] Time Trackers: [0.7, 0.6] Screenshot Tools: [0.4, 0.4] ``` **Kategori ekstensi populer dan manfaatnya:** - **Alat Produktivitas**: Pengelola tugas, aplikasi pencatat, dan pelacak waktu yang membantu Anda tetap terorganisir - **Peningkatan Keamanan**: Pengelola kata sandi, pemblokir iklan, dan alat privasi yang melindungi data Anda - **Alat Pengembang**: Pemformat kode, pemilih warna, dan utilitas debugging yang menyederhanakan pengembangan - **Peningkatan Konten**: Mode membaca, pengunduh video, dan alat tangkapan layar yang meningkatkan pengalaman web Anda ✅ **Pertanyaan Refleksi**: Apa ekstensi browser favorit Anda? Tugas spesifik apa yang mereka lakukan, dan bagaimana mereka meningkatkan pengalaman menjelajah Anda? ### 🔄 **Pemeriksaan Pedagogis** **Pemahaman Arsitektur Browser**: Sebelum beralih ke pengembangan ekstensi, pastikan Anda dapat: - ✅ Menjelaskan bagaimana browser memproses permintaan web dan merender konten - ✅ Mengidentifikasi komponen utama arsitektur browser - ✅ Memahami bagaimana ekstensi terintegrasi dengan fungsionalitas browser - ✅ Mengenali model keamanan yang melindungi pengguna **Tes Diri Cepat**: Bisakah Anda melacak jalur dari mengetik URL hingga melihat halaman web? 1. **Pencarian DNS** mengonversi URL ke alamat IP 2. **Permintaan HTTP** mengambil konten dari server 3. **Parsing** memproses HTML, CSS, dan JavaScript 4. **Rendering** menampilkan halaman web akhir 5. **Ekstensi** dapat memodifikasi konten di beberapa langkah ## Memasang dan Mengelola Ekstensi Memahami proses pemasangan ekstensi membantu Anda mengantisipasi pengalaman pengguna saat mereka memasang ekstensi Anda. Proses pemasangan distandarisasi di browser modern, dengan variasi kecil dalam desain antarmuka.  > **Penting**: Pastikan untuk mengaktifkan mode pengembang dan izinkan ekstensi dari toko lain saat menguji ekstensi Anda sendiri. ### Proses Pemasangan Ekstensi Pengembangan Saat Anda mengembangkan dan menguji ekstensi Anda sendiri, ikuti alur kerja ini: ```mermaid flowchart TD A[Write Code] --> B[Build Extension] B --> C{First Install?} C -->|Yes| D[Load Unpacked] C -->|No| E[Reload Extension] D --> F[Test Functionality] E --> F F --> G{Working Correctly?} G -->|No| H[Debug Issues] G -->|Yes| I[Ready for Users] H --> A I --> J[Publish to Store] style A fill:#e1f5fe style F fill:#e8f5e8 style I fill:#f3e5f5 style J fill:#fff3e0 ``` ```bash # Step 1: Build your extension npm run build ``` **Apa yang dicapai oleh perintah ini:** - **Mengompilasi** kode sumber Anda menjadi file siap browser - **Menggabungkan** modul JavaScript menjadi paket yang dioptimalkan - **Menghasilkan** file ekstensi akhir di folder `/dist` - **Mempersiapkan** ekstensi Anda untuk pemasangan dan pengujian **Langkah 2: Navigasi ke Ekstensi Browser** 1. **Buka** halaman manajemen ekstensi browser Anda 2. **Klik** tombol "Pengaturan dan lainnya" (ikon `...`) di kanan atas 3. **Pilih** "Ekstensi" dari menu dropdown **Langkah 3: Muat Ekstensi Anda** - **Untuk pemasangan baru**: Pilih `load unpacked` dan pilih folder `/dist` Anda - **Untuk pembaruan**: Klik `reload` di sebelah ekstensi yang sudah terpasang - **Untuk pengujian**: Aktifkan "Mode Pengembang" untuk mengakses fitur debugging tambahan ### Pemasangan Ekstensi Produksi > ✅ **Catatan**: Instruksi pengembangan ini khusus untuk ekstensi yang Anda buat sendiri. Untuk memasang ekstensi yang sudah diterbitkan, kunjungi toko ekstensi browser resmi seperti [Microsoft Edge Add-ons store](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home). **Memahami perbedaannya:** - **Pemasangan pengembangan** memungkinkan Anda menguji ekstensi yang belum diterbitkan selama pengembangan - **Pemasangan dari toko** menyediakan ekstensi yang telah diverifikasi dan diterbitkan dengan pembaruan otomatis - **Sideloading** memungkinkan pemasangan ekstensi dari luar toko resmi (memerlukan mode pengembang) ## Membangun Ekstensi Jejak Karbon Anda Kita akan membuat ekstensi browser yang menampilkan jejak karbon dari penggunaan energi di wilayah Anda. Proyek ini menunjukkan konsep pengembangan ekstensi penting sambil menciptakan alat praktis untuk kesadaran lingkungan. Pendekatan ini mengikuti prinsip "belajar dengan melakukan" yang telah terbukti efektif sejak teori pendidikan John Dewey - menggabungkan keterampilan teknis dengan aplikasi dunia nyata yang bermakna. ### Persyaratan Proyek Sebelum memulai pengembangan, mari kita kumpulkan sumber daya dan dependensi yang diperlukan: **Akses API yang Diperlukan:** - **[Kunci API CO2 Signal](https://www.co2signal.com/)**: Masukkan alamat email Anda untuk menerima kunci API gratis Anda - **[Kode wilayah](http://api.electricitymap.org/v3/zones)**: Temukan kode wilayah Anda menggunakan [Electricity Map](https://www.electricitymap.org/map) (misalnya, Boston menggunakan 'US-NEISO') **Alat Pengembangan:** - **[Node.js dan NPM](https://www.npmjs.com)**: Alat manajemen paket untuk memasang dependensi proyek - **[Kode awal](../../../../5-browser-extension/start)**: Unduh folder `start` untuk memulai pengembangan ✅ **Pelajari Lebih Lanjut**: Tingkatkan keterampilan manajemen paket Anda dengan [modul pembelajaran komprehensif ini](https://docs.microsoft.com/learn/modules/create-nodejs-project-dependencies/?WT.mc_id=academic-77807-sagibbon) ### Memahami Struktur Proyek Memahami struktur proyek membantu mengatur pekerjaan pengembangan secara efisien. Seperti bagaimana Perpustakaan Alexandria diorganisasi untuk pengambilan pengetahuan yang mudah, basis kode yang terstruktur dengan baik membuat pengembangan lebih efisien: ``` project-root/ ├── dist/ # Built extension files │ ├── manifest.json # Extension configuration │ ├── index.html # User interface markup │ ├── background.js # Background script functionality │ └── main.js # Compiled JavaScript bundle ├── src/ # Source development files │ └── index.js # Your main JavaScript code ├── package.json # Project dependencies and scripts └── webpack.config.js # Build configuration ``` **Memecah apa yang dicapai oleh setiap file:** - **`manifest.json`**: **Mendefinisikan** metadata ekstensi, izin, dan titik masuk - **`index.html`**: **Membuat** antarmuka pengguna yang muncul saat pengguna mengklik ekstensi Anda - **`background.js`**: **Menangani** tugas latar belakang dan pendengar acara browser - **`main.js`**: **Berisi** JavaScript yang telah digabungkan setelah proses build - **`src/index.js`**: **Menampung** kode pengembangan utama Anda yang dikompilasi menjadi `main.js` > 💡 **Tip Organisasi**: Simpan kunci API dan kode wilayah Anda dalam catatan aman untuk referensi mudah selama pengembangan. Anda akan membutuhkan nilai-nilai ini untuk menguji fungsionalitas ekstensi Anda. ✅ **Catatan Keamanan**: Jangan pernah menyimpan kunci API atau kredensial sensitif ke dalam repositori kode Anda. Kami akan menunjukkan cara menangani ini dengan aman di langkah berikutnya. ## Membuat Antarmuka Ekstensi Sekarang kita akan membangun komponen antarmuka pengguna. Ekstensi menggunakan pendekatan dua layar: layar konfigurasi untuk pengaturan awal dan layar hasil untuk menampilkan data. Ini mengikuti prinsip pengungkapan progresif yang digunakan dalam desain antarmuka sejak awal komputasi - mengungkapkan informasi dan opsi dalam urutan logis untuk menghindari membebani pengguna. ### Ikhtisar Tampilan Ekstensi **Tampilan Pengaturan** - Konfigurasi pengguna pertama kali:  **Tampilan Hasil** - Tampilan data jejak karbon:  ### Membuat Formulir Konfigurasi Formulir pengaturan mengumpulkan data konfigurasi pengguna selama penggunaan awal. Setelah dikonfigurasi, informasi ini akan disimpan di penyimpanan browser untuk sesi mendatang. Di file `/dist/index.html`, tambahkan struktur formulir ini: ```html
``` **Inilah yang dicapai oleh formulir ini:** - **Membuat** struktur formulir semantik dengan label yang tepat dan asosiasi input - **Mengaktifkan** fungsi pengisian otomatis browser untuk pengalaman pengguna yang lebih baik - **Memerlukan** kedua bidang diisi sebelum pengiriman menggunakan atribut `required` - **Mengorganisasi** input dengan nama kelas deskriptif untuk penargetan styling dan JavaScript yang mudah - **Memberikan** instruksi yang jelas untuk pengguna yang mengatur ekstensi untuk pertama kalinya ### Membuat Tampilan Hasil Selanjutnya, buat area hasil yang akan menampilkan data jejak karbon. Tambahkan HTML ini di bawah formulir: ```htmlRegion:
Carbon Usage:
Fossil Fuel Percentage: