` साठी HTML तयार केले आहे. आता तुम्हाला `/src/index.js` फाइलमध्ये काम करावे लागेल आणि तुमचे एक्स्टेंशन थोडे थोडे तयार करावे लागेल. तुमचा प्रोजेक्ट सेट अप करण्यासाठी आणि बिल्ड प्रक्रियेबद्दल [मागील धडा](../1-about-browsers/README.md) पहा. `index.js` फाइलमध्ये काम करताना, विविध फील्डशी संबंधित मूल्ये ठेवण्यासाठी काही `const` व्हेरिएबल्स तयार करा: ```JavaScript // form fields const form = document.querySelector('.form-data'); const region = document.querySelector('.region-name'); const apiKey = document.querySelector('.api-key'); // results const errors = document.querySelector('.errors'); const loading = document.querySelector('.loading'); const results = document.querySelector('.result-container'); const usage = document.querySelector('.carbon-usage'); const fossilfuel = document.querySelector('.fossil-fuel'); const myregion = document.querySelector('.my-region'); const clearBtn = document.querySelector('.clear-btn'); ``` हे सर्व फील्ड त्यांच्या CSS क्लासद्वारे संदर्भित केले जातात, जे तुम्ही मागील धड्यात HTML मध्ये सेट केले आहे. ### लिसनर्स जोडा यानंतर, फॉर्म आणि क्लिअर बटणासाठी इव्हेंट लिसनर्स जोडा जे फॉर्म रीसेट करते, जेणेकरून वापरकर्ता फॉर्म सबमिट करतो किंवा रीसेट बटणावर क्लिक करतो तेव्हा काहीतरी होईल. फाइलच्या तळाशी अॅप इनिशियलाइझ करण्यासाठी कॉल जोडा: ```JavaScript form.addEventListener('submit', (e) => handleSubmit(e)); clearBtn.addEventListener('click', (e) => reset(e)); init(); ``` ✅ सबमिट किंवा क्लिक इव्हेंटसाठी वापरलेले शॉर्टहँड लक्षात घ्या आणि इव्हेंट कसे `handleSubmit` किंवा `reset` फंक्शनला पास केले जाते. तुम्ही या शॉर्टहँडचे लांब स्वरूपात समतुल्य लिहू शकता का? तुम्हाला कोणते स्वरूप अधिक आवडते? ### `init()` फंक्शन आणि `reset()` फंक्शन तयार करा: आता तुम्ही एक्स्टेंशन इनिशियलाइझ करणारे फंक्शन तयार करणार आहात, ज्याला `init()` म्हणतात: ```JavaScript function init() { //if anything is in localStorage, pick it up const storedApiKey = localStorage.getItem('apiKey'); const storedRegion = localStorage.getItem('regionName'); //set icon to be generic green //todo if (storedApiKey === null || storedRegion === null) { //if we don't have the keys, show the form form.style.display = 'block'; results.style.display = 'none'; loading.style.display = 'none'; clearBtn.style.display = 'none'; errors.textContent = ''; } else { //if we have saved keys/regions in localStorage, show results when they load displayCarbonUsage(storedApiKey, storedRegion); results.style.display = 'none'; form.style.display = 'none'; clearBtn.style.display = 'block'; } }; function reset(e) { e.preventDefault(); //clear local storage for region only localStorage.removeItem('regionName'); init(); } ``` या फंक्शनमध्ये काही मनोरंजक लॉजिक आहे. वाचताना, तुम्हाला काय घडते ते समजते का? - दोन `const` सेट केले जातात जे तपासतात की वापरकर्त्याने लोकल स्टोरेजमध्ये APIKey आणि region code साठवले आहे का. - जर त्यापैकी एक null असेल, तर फॉर्म 'block' म्हणून त्याची शैली बदलून दाखवा. - परिणाम, लोडिंग, आणि `clearBtn` लपवा आणि कोणतेही एरर टेक्स्ट रिकामे सेट करा. - जर key आणि region अस्तित्वात असेल, तर एक रूटीन सुरू करा: - API कॉल करा आणि कार्बन वापर डेटा मिळवा. - परिणाम क्षेत्र लपवा. - फॉर्म लपवा. - रीसेट बटण दाखवा. पुढे जाण्यापूर्वी, ब्राउझरमध्ये उपलब्ध असलेल्या एका महत्त्वाच्या संकल्पनेबद्दल शिकणे उपयुक्त आहे: [LocalStorage](https://developer.mozilla.org/docs/Web/API/Window/localStorage). LocalStorage ही ब्राउझरमध्ये `key-value` जोड म्हणून स्ट्रिंग्स साठवण्याचा एक उपयुक्त मार्ग आहे. जावास्क्रिप्टद्वारे वेब स्टोरेजचा हा प्रकार ब्राउझरमध्ये डेटा व्यवस्थापित करण्यासाठी हाताळला जाऊ शकतो. LocalStorage कालबाह्य होत नाही, तर SessionStorage, वेब स्टोरेजचा दुसरा प्रकार, ब्राउझर बंद झाल्यावर साफ केला जातो. स्टोरेजच्या विविध प्रकारांमध्ये त्यांच्या वापराचे फायदे आणि तोटे आहेत. > लक्षात ठेवा - तुमच्या ब्राउझर एक्स्टेंशनला स्वतःचे लोकल स्टोरेज आहे; मुख्य ब्राउझर विंडो एक वेगळी instance आहे आणि वेगळ्या प्रकारे वागते. तुम्ही तुमच्या APIKey ला स्ट्रिंग मूल्य सेट करता, उदाहरणार्थ, आणि तुम्ही Edge वर "वेब पृष्ठ तपासून" (तुम्ही ब्राउझरवर उजवे क्लिक करून तपासू शकता) आणि स्टोरेज पाहण्यासाठी Applications टॅबवर जाऊन ते सेट केले आहे.  ✅ अशा परिस्थितींबद्दल विचार करा जिथे तुम्हाला काही डेटा LocalStorage मध्ये साठवायचा नसेल. सामान्यतः, API Keys LocalStorage मध्ये ठेवणे ही वाईट कल्पना आहे! तुम्हाला का वाटते? आमच्या बाबतीत, कारण आमचे अॅप केवळ शिकण्यासाठी आहे आणि अॅप स्टोअरमध्ये तैनात केले जाणार नाही, आम्ही ही पद्धत वापरू. तुम्ही LocalStorage हाताळण्यासाठी Web API वापरता, `getItem()`, `setItem()`, किंवा `removeItem()` वापरून. हे ब्राउझरमध्ये मोठ्या प्रमाणावर समर्थित आहे. `displayCarbonUsage()` फंक्शन तयार करण्यापूर्वी जे `init()` मध्ये कॉल केले जाते, प्रारंभिक फॉर्म सबमिशन हाताळण्यासाठी कार्यक्षमता तयार करूया. ### फॉर्म सबमिशन हाताळा `handleSubmit` नावाचे फंक्शन तयार करा जे `(e)` इव्हेंट आर्ग्युमेंट स्वीकारते. इव्हेंटचा प्रसार थांबवा (या प्रकरणात, आम्हाला ब्राउझर रीफ्रेश होण्यापासून थांबवायचे आहे) आणि `setUpUser` नावाच्या नवीन फंक्शनला कॉल करा, `apiKey.value` आणि `region.value` आर्ग्युमेंट्स पास करत. अशा प्रकारे, तुम्ही प्रारंभिक फॉर्मद्वारे योग्य फील्ड भरल्यावर आणलेल्या दोन मूल्यांचा वापर करता. ```JavaScript function handleSubmit(e) { e.preventDefault(); setUpUser(apiKey.value, region.value); } ``` ✅ तुमची आठवण ताजी करा - मागील धड्यात सेट केलेल्या HTML मध्ये दोन इनपुट फील्ड आहेत ज्यांचे `values` तुम्ही फाइलच्या शीर्षस्थानी सेट केलेल्या `const` द्वारे कॅप्चर केले जातात, आणि ते दोन्ही `required` आहेत त्यामुळे ब्राउझर वापरकर्त्यांना null मूल्ये इनपुट करण्यापासून थांबवतो. ### वापरकर्ता सेट करा `setUpUser` फंक्शनकडे पुढे जाताना, येथे तुम्ही apiKey आणि regionName साठी लोकल स्टोरेज मूल्ये सेट करता. एक नवीन फंक्शन जोडा: ```JavaScript function setUpUser(apiKey, regionName) { localStorage.setItem('apiKey', apiKey); localStorage.setItem('regionName', regionName); loading.style.display = 'block'; errors.textContent = ''; clearBtn.style.display = 'block'; //make initial call displayCarbonUsage(apiKey, regionName); } ``` हे फंक्शन API कॉल करत असताना लोडिंग संदेश दाखवते. या टप्प्यावर, तुम्ही या ब्राउझर एक्स्टेंशनचे सर्वात महत्त्वाचे फंक्शन तयार करण्यासाठी पोहोचला आहात! ### कार्बन वापर दाखवा शेवटी, API क्वेरी करण्याची वेळ आली आहे! पुढे जाण्यापूर्वी, आपल्याला API बद्दल चर्चा करणे आवश्यक आहे. API, किंवा [Application Programming Interfaces](https://www.webopedia.com/TERM/A/API.html), वेब डेव्हलपरच्या टूलबॉक्सचा एक महत्त्वाचा घटक आहे. ते प्रोग्राम्सना एकमेकांशी संवाद साधण्यासाठी आणि इंटरफेस करण्यासाठी मानक मार्ग प्रदान करतात. उदाहरणार्थ, जर तुम्ही डेटाबेस क्वेरी करण्यासाठी वेबसाइट तयार करत असाल, तर कोणीतरी तुमच्यासाठी वापरण्यासाठी API तयार केले असेल. जरी API चे अनेक प्रकार आहेत, तरी सर्वात लोकप्रिय प्रकारांपैकी एक म्हणजे [REST API](https://www.smashingmagazine.com/2018/01/understanding-using-rest-api/). ✅ 'REST' म्हणजे 'Representational State Transfer' आणि डेटा मिळवण्यासाठी विविध प्रकारे कॉन्फिगर केलेल्या URLs वापरण्याची वैशिष्ट्ये आहेत. डेव्हलपर्ससाठी उपलब्ध असलेल्या विविध प्रकारच्या API बद्दल थोडे संशोधन करा. तुम्हाला कोणता फॉर्मॅट अधिक आवडतो? या फंक्शनबद्दल महत्त्वाच्या गोष्टी लक्षात घ्या. प्रथम, [`async` कीवर्ड](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/async_function) लक्षात घ्या. तुमचे फंक्शन्स असे लिहिणे की ते असिंक्रोनसपणे चालतात म्हणजे ते डेटा परत येण्यासारख्या क्रियेसाठी थांबतात आणि नंतर पुढे जातात. `async` बद्दल एक जलद व्हिडिओ येथे आहे: [](https://youtube.com/watch?v=YwmlRkrxvkk "Async आणि Await प्रॉमिसेस व्यवस्थापित करण्यासाठी") > 🎥 वरच्या प्रतिमेवर क्लिक करा `async/await` बद्दल व्हिडिओसाठी. C02Signal API क्वेरी करण्यासाठी एक नवीन फंक्शन तयार करा: ```JavaScript import axios from '../node_modules/axios'; async function displayCarbonUsage(apiKey, region) { try { await axios .get('https://api.co2signal.com/v1/latest', { params: { countryCode: region, }, headers: { 'auth-token': apiKey, }, }) .then((response) => { let CO2 = Math.floor(response.data.data.carbonIntensity); //calculateColor(CO2); loading.style.display = 'none'; form.style.display = 'none'; myregion.textContent = region; usage.textContent = Math.round(response.data.data.carbonIntensity) + ' grams (grams C02 emitted per kilowatt hour)'; fossilfuel.textContent = response.data.data.fossilFuelPercentage.toFixed(2) + '% (percentage of fossil fuels used to generate electricity)'; results.style.display = 'block'; }); } catch (error) { console.log(error); loading.style.display = 'none'; results.style.display = 'none'; errors.textContent = 'Sorry, we have no data for the region you have requested.'; } } ``` हे एक मोठे फंक्शन आहे. येथे काय चालले आहे? - सर्वोत्तम पद्धतींचे अनुसरण करत, तुम्ही `async` कीवर्ड वापरता जेणेकरून हे फंक्शन असिंक्रोनसपणे वागेल. फंक्शनमध्ये `try/catch` ब्लॉक आहे कारण API डेटा परत करताना ते प्रॉमिस परत करेल. कारण तुम्हाला API प्रतिसाद देण्याचा वेग नियंत्रित करता येत नाही (ते कदाचित प्रतिसाद देणार नाही!), तुम्हाला ही अनिश्चितता असिंक्रोनसपणे कॉल करून हाताळणे आवश्यक आहे. - तुम्ही तुमच्या region चा डेटा मिळवण्यासाठी co2signal API क्वेरी करत आहात, तुमचा API Key वापरून. त्या key चा वापर करण्यासाठी, तुम्हाला तुमच्या हेडर पॅरामीटर्समध्ये एक प्रकारचे ऑथेंटिकेशन वापरावे लागते. - एकदा API प्रतिसाद दिल्यावर, तुम्ही त्याच्या प्रतिसाद डेटाच्या विविध घटकांना तुमच्या स्क्रीनच्या त्या भागांमध्ये असाइन करता जे तुम्ही हा डेटा दाखवण्यासाठी सेट केले आहे. - जर एरर असेल किंवा कोणताही परिणाम नसेल, तर तुम्ही एरर संदेश दाखवता. ✅ असिंक्रोनस प्रोग्रामिंग पॅटर्न वापरणे तुमच्या टूलबॉक्समधील आणखी एक उपयुक्त साधन आहे. [विविध प्रकारांबद्दल वाचा](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/async_function) ज्याद्वारे तुम्ही या प्रकारचा कोड कॉन्फिगर करू शकता. अभिनंदन! जर तुम्ही तुमचे एक्स्टेंशन (`npm run build`) तयार केले आणि तुमच्या एक्स्टेंशन पॅनमध्ये ते रीफ्रेश केले, तर तुमच्याकडे एक कार्यरत एक्स्टेंशन आहे! एकमेव गोष्ट जी कार्यरत नाही ती म्हणजे आयकॉन, आणि तुम्ही ती पुढील धड्यात दुरुस्त कराल. --- ## 🚀 आव्हान आम्ही या धड्यांमध्ये आतापर्यंत अनेक प्रकारचे API चर्चा केली आहेत. एक वेब API निवडा आणि ते काय ऑफर करते याचा सखोल अभ्यास करा. उदाहरणार्थ, ब्राउझरमध्ये उपलब्ध असलेल्या [HTML Drag and Drop API](https://developer.mozilla.org/docs/Web/API/HTML_Drag_and_Drop_API) वर एक नजर टाका. तुमच्या मते एक उत्कृष्ट API कसे असावे? ## पोस्ट-लेक्चर क्विझ [पोस्ट-लेक्चर क्विझ](https://ff-quizzes.netlify.app/web/quiz/26) ## पुनरावलोकन आणि स्व-अभ्यास या धड्यात तुम्ही LocalStorage आणि API बद्दल शिकलात, जे व्यावसायिक वेब डेव्हलपरसाठी खूप उपयुक्त आहेत. तुम्ही विचार करू शकता की हे दोन गोष्टी एकत्र कशा कार्य करतात? अशा वेबसाइटची रचना कशी कराल याचा विचार करा जी API द्वारे वापरण्यासाठी आयटम साठवेल. ## असाइनमेंट [API स्वीकारा](assignment.md) --- **अस्वीकरण**: हा दस्तऐवज AI भाषांतर सेवा [Co-op Translator](https://github.com/Azure/co-op-translator) वापरून भाषांतरित करण्यात आला आहे. आम्ही अचूकतेसाठी प्रयत्नशील असलो तरी, कृपया लक्षात ठेवा की स्वयंचलित भाषांतरांमध्ये त्रुटी किंवा अचूकतेचा अभाव असू शकतो. मूळ भाषेतील दस्तऐवज हा अधिकृत स्रोत मानला जावा. महत्त्वाच्या माहितीसाठी, व्यावसायिक मानवी भाषांतराची शिफारस केली जाते. या भाषांतराचा वापर करून उद्भवलेल्या कोणत्याही गैरसमज किंवा चुकीच्या अर्थासाठी आम्ही जबाबदार राहणार नाही.