# Browser Extension Project Part 1: Lahat Tungkol sa Mga 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 ni [Wassim Chegham](https://dev.to/wassimchegham/ever-wondered-what-happens-when-you-type-in-a-url-in-an-address-bar-in-a-browser-3dob) ## Pre-Lecture Quiz [Pre-lecture quiz](https://ff-quizzes.netlify.app/web/quiz/23) ### Panimula Ang mga browser extension ay mga mini-application na nagpapahusay sa iyong karanasan sa pag-browse sa web. Tulad ng orihinal na pananaw ni Tim Berners-Lee para sa isang interactive na web, ang mga extension ay nagpapalawak ng kakayahan ng browser lampas sa simpleng pagtingin ng mga dokumento. Mula sa mga password manager na nagpapanatili ng seguridad ng iyong mga account hanggang sa mga color picker na tumutulong sa mga designer na makuha ang perpektong kulay, ang mga extension ay nag-aayos ng mga pang-araw-araw na hamon sa pag-browse. Bago natin simulan ang paggawa ng iyong unang extension, unawain muna natin kung paano gumagana ang mga browser. Tulad ng kailangang maunawaan ni Alexander Graham Bell ang transmisyon ng tunog bago maimbento ang telepono, ang kaalaman sa mga pangunahing kaalaman ng browser ay makakatulong sa iyo na lumikha ng mga extension na seamless na nag-iintegrate sa mga umiiral na sistema ng browser. Sa pagtatapos ng araling ito, mauunawaan mo ang arkitektura ng browser at makakapagsimula ka nang bumuo ng iyong unang extension. ```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 ``` ## Pag-unawa sa Mga Web Browser Ang web browser ay mahalagang isang sopistikadong tagasalin ng dokumento. Kapag nag-type ka ng "google.com" sa address bar, ang browser ay nagsasagawa ng isang kumplikadong serye ng mga operasyon - humihiling ng nilalaman mula sa mga server sa buong mundo, pagkatapos ay ini-parse at ini-render ang code sa mga interactive na web page na nakikita mo. Ang prosesong ito ay sumasalamin sa disenyo ng unang web browser, ang WorldWideWeb, na ginawa ni Tim Berners-Lee noong 1990 upang gawing accessible sa lahat ang mga hyperlinked na dokumento. ✅ **Kaunting Kasaysayan**: Ang unang browser ay tinawag na 'WorldWideWeb' at nilikha ni Sir Timothy Berners-Lee noong 1990.  > Ilang maagang browser, mula kay [Karen McGrane](https://www.slideshare.net/KMcGrane/week-4-ixd-history-personal-computing) ### Paano Pinoproseso ng Mga Browser ang Web Content Ang proseso sa pagitan ng pag-type ng URL at pagtingin sa isang webpage ay may kasamang ilang magkakaugnay na hakbang na nangyayari sa loob ng ilang segundo: ```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 ``` **Narito ang nagagawa ng prosesong ito:** - **Isinasalin** ang URL na nababasa ng tao sa isang IP address ng server sa pamamagitan ng DNS lookup - **Nag-eestablish** ng secure na koneksyon sa web server gamit ang HTTP o HTTPS protocols - **Humihiling** ng partikular na nilalaman ng web page mula sa server - **Tumatanggap** ng HTML markup, CSS styling, at JavaScript code mula sa server - **Ini-render** ang lahat ng nilalaman sa interactive na web page na nakikita mo ### Mga Pangunahing Tampok ng Browser Ang mga modernong browser ay nagbibigay ng maraming tampok na maaaring magamit ng mga developer ng extension: | Tampok | Layunin | Mga Oportunidad sa Extension | |---------|---------|------------------------| | **Rendering Engine** | Nagpapakita ng HTML, CSS, at JavaScript | Pagbabago ng nilalaman, pag-inject ng estilo | | **JavaScript Engine** | Nagpapatupad ng JavaScript code | Mga custom na script, API interactions | | **Local Storage** | Nag-iimbak ng data nang lokal | Mga user preference, cached data | | **Network Stack** | Humahawak ng mga web request | Pag-monitor ng request, pagsusuri ng data | | **Security Model** | Pinoprotektahan ang mga user mula sa malisyosong nilalaman | Pag-filter ng nilalaman, mga pagpapahusay sa seguridad | **Ang pag-unawa sa mga tampok na ito ay tumutulong sa iyo:** - **Tukuyin** kung saan maaaring magdagdag ng pinakamalaking halaga ang iyong extension - **Pumili** ng tamang browser APIs para sa functionality ng iyong extension - **Magdisenyo** ng mga extension na mahusay na gumagana sa mga sistema ng browser - **Siguraduhin** na ang iyong extension ay sumusunod sa mga pinakamahusay na kasanayan sa seguridad ng browser ### Mga Pagsasaalang-alang sa Cross-Browser Development Iba't ibang browser ang nagpapatupad ng mga pamantayan na may bahagyang pagkakaiba, katulad ng kung paano maaaring hawakan ng iba't ibang programming language ang parehong algorithm nang magkakaiba. Ang Chrome, Firefox, at Safari ay may kani-kaniyang natatanging katangian na dapat isaalang-alang ng mga developer sa panahon ng pagbuo ng extension. > 💡 **Pro Tip**: Gamitin ang [caniuse.com](https://www.caniuse.com) upang suriin kung aling mga teknolohiya sa web ang sinusuportahan sa iba't ibang browser. Napakahalaga nito kapag nagpaplano ng mga tampok ng iyong extension! **Mga pangunahing pagsasaalang-alang para sa pagbuo ng extension:** - **Subukan** ang iyong extension sa Chrome, Firefox, at Edge browsers - **Iangkop** sa iba't ibang browser extension APIs at manifest formats - **Hawakan** ang iba't ibang performance characteristics at limitasyon - **Magbigay** ng mga fallback para sa mga tampok na partikular sa browser na maaaring hindi magagamit ✅ **Analytics Insight**: Maaari mong matukoy kung aling mga browser ang mas gusto ng iyong mga user sa pamamagitan ng pag-install ng mga analytics package sa iyong mga proyekto sa web development. Ang data na ito ay tumutulong sa iyo na unahin kung aling mga browser ang dapat suportahan muna. ## Pag-unawa sa Mga Browser Extension Ang mga browser extension ay nag-aayos ng mga karaniwang hamon sa pag-browse sa web sa pamamagitan ng pagdaragdag ng functionality nang direkta sa interface ng browser. Sa halip na mangailangan ng hiwalay na mga application o kumplikadong mga workflow, ang mga extension ay nagbibigay ng agarang access sa mga tool at tampok. Ang konseptong ito ay sumasalamin sa kung paano naisip ng mga maagang pioneer ng computer tulad ni Douglas Engelbart ang pagpapahusay ng kakayahan ng tao gamit ang teknolohiya - ang mga extension ay nagpapahusay sa pangunahing functionality ng iyong browser. ```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] ``` **Mga sikat na kategorya ng extension at kanilang mga benepisyo:** - **Mga Productivity Tool**: Mga task manager, note-taking apps, at time trackers na tumutulong sa iyo na maging organisado - **Mga Pagpapahusay sa Seguridad**: Mga password manager, ad blocker, at mga tool sa privacy na nagpoprotekta sa iyong data - **Mga Developer Tool**: Mga code formatter, color picker, at debugging utilities na nagpapadali sa pag-develop - **Pagpapahusay ng Nilalaman**: Mga reading mode, video downloader, at screenshot tools na nagpapabuti sa iyong karanasan sa web ✅ **Reflection Question**: Ano ang iyong mga paboritong browser extension? Anong partikular na gawain ang kanilang ginagawa, at paano nila pinapabuti ang iyong karanasan sa pag-browse? ### 🔄 **Pedagogical Check-in** **Pag-unawa sa Arkitektura ng Browser**: Bago lumipat sa pagbuo ng extension, tiyaking kaya mong: - ✅ Ipaliwanag kung paano pinoproseso ng mga browser ang mga web request at ini-render ang nilalaman - ✅ Tukuyin ang mga pangunahing bahagi ng arkitektura ng browser - ✅ Unawain kung paano nag-iintegrate ang mga extension sa functionality ng browser - ✅ Kilalanin ang security model na nagpoprotekta sa mga user **Quick Self-Test**: Kaya mo bang i-trace ang landas mula sa pag-type ng URL hanggang sa pagtingin sa isang webpage? 1. **DNS lookup** nagko-convert ng URL sa IP address 2. **HTTP request** kumukuha ng nilalaman mula sa server 3. **Parsing** nagpoproseso ng HTML, CSS, at JavaScript 4. **Rendering** nagpapakita ng final webpage 5. **Extensions** maaaring magbago ng nilalaman sa maraming hakbang ## Pag-install at Pamamahala ng Mga Extension Ang pag-unawa sa proseso ng pag-install ng extension ay tumutulong sa iyo na ma-anticipate ang karanasan ng user kapag ini-install nila ang iyong extension. Ang proseso ng pag-install ay standardized sa mga modernong browser, na may kaunting pagkakaiba sa disenyo ng interface.  > **Mahalaga**: Siguraduhing i-toggle ang developer mode at payagan ang mga extension mula sa ibang mga tindahan kapag sinusubukan ang iyong sariling mga extension. ### Proseso ng Pag-install ng Development Extension Kapag ikaw ay nagde-develop at nagte-test ng iyong sariling mga extension, sundin ang workflow na ito: ```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 ``` **Ano ang nagagawa ng command na ito:** - **Kinokompyla** ang iyong source code sa mga browser-ready files - **Binubuo** ang mga JavaScript module sa mga optimized na package - **Nagge-generate** ng final extension files sa `/dist` folder - **Ipinaprepara** ang iyong extension para sa pag-install at testing **Hakbang 2: Pumunta sa Browser Extensions** 1. **Buksan** ang extensions management page ng iyong browser 2. **I-click** ang "Settings and more" button (ang `...` icon) sa kanang itaas 3. **Piliin** ang "Extensions" mula sa dropdown menu **Hakbang 3: I-load ang Iyong Extension** - **Para sa bagong pag-install**: Piliin ang `load unpacked` at piliin ang iyong `/dist` folder - **Para sa mga update**: I-click ang `reload` sa tabi ng iyong naka-install na extension - **Para sa testing**: I-enable ang "Developer mode" upang ma-access ang mga karagdagang debugging features ### Proseso ng Pag-install ng Production Extension > ✅ **Tandaan**: Ang mga development instructions na ito ay partikular para sa mga extension na ikaw mismo ang bumuo. Para mag-install ng mga published extension, bisitahin ang mga opisyal na browser extension store tulad ng [Microsoft Edge Add-ons store](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home). **Pag-unawa sa pagkakaiba:** - **Development installations** nagbibigay-daan sa iyo na i-test ang mga unpublished extension sa panahon ng development - **Store installations** nagbibigay ng vetted, published extensions na may automatic updates - **Sideloading** nagbibigay-daan sa pag-install ng mga extension mula sa labas ng mga opisyal na tindahan (nangangailangan ng developer mode) ## Pagbuo ng Iyong Carbon Footprint Extension Gagawa tayo ng browser extension na nagpapakita ng carbon footprint ng energy use sa iyong rehiyon. Ang proyektong ito ay nagpapakita ng mahahalagang konsepto sa pagbuo ng extension habang gumagawa ng praktikal na tool para sa kamalayan sa kapaligiran. Ang approach na ito ay sumusunod sa prinsipyo ng "learning by doing" na napatunayang epektibo mula pa sa mga teorya sa edukasyon ni John Dewey - pinagsasama ang teknikal na kasanayan sa makabuluhang aplikasyon sa totoong mundo. ### Mga Kinakailangan sa Proyekto Bago simulan ang development, magtipon tayo ng mga kinakailangang resources at dependencies: **Kinakailangang API Access:** - **[CO2 Signal API key](https://www.co2signal.com/)**: Ipasok ang iyong email address upang makuha ang iyong libreng API key - **[Region code](http://api.electricitymap.org/v3/zones)**: Hanapin ang iyong region code gamit ang [Electricity Map](https://www.electricitymap.org/map) (halimbawa, ang Boston ay gumagamit ng 'US-NEISO') **Mga Development Tools:** - **[Node.js and NPM](https://www.npmjs.com)**: Tool sa pamamahala ng package para sa pag-install ng mga dependencies ng proyekto - **[Starter code](../../../../5-browser-extension/start)**: I-download ang `start` folder upang simulan ang development ✅ **Matuto Pa**: Palawakin ang iyong mga kasanayan sa pamamahala ng package gamit ang [komprehensibong Learn module](https://docs.microsoft.com/learn/modules/create-nodejs-project-dependencies/?WT.mc_id=academic-77807-sagibbon) ### Pag-unawa sa Estruktura ng Proyekto Ang pag-unawa sa estruktura ng proyekto ay tumutulong sa maayos na pag-organisa ng trabaho sa development. Tulad ng kung paano inayos ang Library of Alexandria para sa madaling retrieval ng kaalaman, ang maayos na codebase ay nagpapabilis sa development: ``` 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 ``` **Paghiwa-hiwalay kung ano ang nagagawa ng bawat file:** - **`manifest.json`**: **Tinutukoy** ang metadata ng extension, mga permission, at mga entry point - **`index.html`**: **Lumilikha** ng user interface na lumalabas kapag na-click ng mga user ang iyong extension - **`background.js`**: **Humahawak** ng mga background task at browser event listeners - **`main.js`**: **Naglalaman** ng final bundled JavaScript pagkatapos ng build process - **`src/index.js`**: **Naglalaman** ng iyong pangunahing development code na kino-compile sa `main.js` > 💡 **Tip sa Organisasyon**: Itago ang iyong API key at region code sa isang secure na note para sa madaling reference sa panahon ng development. Kakailanganin mo ang mga value na ito upang i-test ang functionality ng iyong extension. ✅ **Tandaan sa Seguridad**: Huwag kailanman i-commit ang mga API key o sensitibong credentials sa iyong code repository. Ipapakita namin sa iyo kung paano ito ligtas na hawakan sa mga susunod na hakbang. ## Paglikha ng Interface ng Extension Ngayon ay gagawa tayo ng mga component ng user interface. Ang extension ay gumagamit ng two-screen approach: isang configuration screen para sa paunang setup at isang results screen para sa pagpapakita ng data. Ito ay sumusunod sa prinsipyo ng progressive disclosure na ginagamit sa disenyo ng interface mula pa noong unang panahon ng computing - unti-unting ipinapakita ang impormasyon at mga opsyon sa lohikal na pagkakasunod-sunod upang maiwasan ang pag-overwhelm sa mga user. ### Overview ng Extension Views **Setup View** - Paunang configuration ng user:  **Results View** - Pagpapakita ng data ng carbon footprint:  ### Pagbuo ng Configuration Form Ang setup form ay nangongolekta ng data ng user configuration sa unang paggamit. Kapag na-configure na, ang impormasyong ito ay mananatili sa browser storage para sa mga susunod na session. Sa file na `/dist/index.html`, idagdag ang istruktura ng form na ito: ```html
``` **Narito ang nagagawa ng form na ito:** - **Lumilikha** ng semantic na istruktura ng form na may tamang labels at input associations - **Nagpapagana** ng browser autocomplete functionality para sa mas mahusay na karanasan ng user - **Nangangailangan** ng parehong field na mapunan bago isumite gamit ang `required` attribute - **Inaayos** ang mga input gamit ang mga deskriptibong class name para sa madaling pag-style at pag-target ng JavaScript - **Nagbibigay** ng malinaw na instruksyon para sa mga user na nagse-setup ng extension sa unang pagkakataon ### Pagbuo ng Results Display Susunod, gumawa ng results area na magpapakita ng data ng carbon footprint. Idagdag ang HTML na ito sa ibaba ng form: ```htmlRegion:
Carbon Usage:
Fossil Fuel Percentage: