पुश इवेंट

इस पॉइंट तक, हमने उपयोगकर्ता को सदस्यता देने और पुश मैसेज भेजने के बारे में बताया. अगला चरण, उपयोगकर्ता के डिवाइस पर इस पुश मैसेज को पाना और सूचना दिखाना है. इसके अलावा, कोई अन्य काम भी किया जा सकता है.

पुश इवेंट

मैसेज मिलने पर, आपके सर्विस वर्कर को पुश इवेंट भेजा जाएगा.

पुश इवेंट लिसनर को सेट अप करने का कोड, JavaScript में लिखे जाने वाले किसी भी अन्य इवेंट लिसनर के कोड से काफ़ी मिलता-जुलता होना चाहिए:

self.addEventListener('push', function(event) {
    if (event.data) {
    console.log('This push event has data: ', event.data.text());
    } else {
    console.log('This push event has no data.');
    }
});

सर्विस वर्कर का इस्तेमाल करने वाले ज़्यादातर नए डेवलपर को इस कोड का सबसे अजीब हिस्सा self वैरिएबल लगता है. self का इस्तेमाल आम तौर पर वेब वर्कर में किया जाता है. सर्विस वर्कर भी एक वेब वर्कर है. self का मतलब ग्लोबल स्कोप से है. यह वेब पेज में window की तरह होता है. हालांकि, वेब वर्कर और सर्विस वर्कर के लिए, self का मतलब वर्कर से ही होता है.

ऊपर दिए गए उदाहरण में, self.addEventListener() को सर्विस वर्कर में ही इवेंट लिसनर जोड़ने के तौर पर देखा जा सकता है.

पुश इवेंट के उदाहरण में, हम देखते हैं कि कोई डेटा है या नहीं. इसके बाद, कंसोल पर कुछ प्रिंट करते हैं.

पुश इवेंट से डेटा पार्स करने के अन्य तरीके भी हैं:

// Returns string
event.data.text()

// Parses data as JSON string and returns an Object
event.data.json()

// Returns blob of data
event.data.blob()

// Returns an arrayBuffer
event.data.arrayBuffer()

ज़्यादातर लोग अपने ऐप्लिकेशन से मिलने वाली उम्मीदों के आधार पर, json() या text() का इस्तेमाल करते हैं.

इस उदाहरण में, पुश इवेंट लिसनर को जोड़ने और डेटा को ऐक्सेस करने का तरीका बताया गया है. हालांकि, इसमें दो बहुत ज़रूरी फ़ंक्शन मौजूद नहीं हैं. यह कोई सूचना नहीं दिखा रहा है और event.waitUntil() का इस्तेमाल नहीं कर रहा है.

इस समय तक इंतज़ार करें

सर्विस वर्कर के बारे में समझने वाली एक बात यह है कि सर्विस वर्कर कोड कब चलेगा, इस पर आपका ज़्यादा कंट्रोल नहीं होता. ब्राउज़र यह तय करता है कि इसे कब चालू करना है और कब बंद करना है. ब्राउज़र को यह बताने का एकमात्र तरीका है कि "मैं ज़रूरी काम करने में बहुत व्यस्त हूं", event.waitUntil() तरीके में प्रॉमिस पास करना. इससे ब्राउज़र, सर्विस वर्कर को तब तक चलाता रहेगा, जब तक कि आपने जो प्रॉमिस पास किया है वह सेटल नहीं हो जाता.

पुश इवेंट के लिए, एक और ज़रूरी शर्त है. आपको सूचना तब दिखानी होगी, जब तक कि आपने जो प्रॉमिस पास किया है वह सेटल न हो जाए.

यहां सूचना दिखाने का एक बुनियादी उदाहरण दिया गया है:

self.addEventListener('push', function(event) {
    const promiseChain = self.registration.showNotification('Hello, World.');

    event.waitUntil(promiseChain);
});

self.registration.showNotification() को कॉल करने से, उपयोगकर्ता को सूचना दिखती है. साथ ही, इस कॉल के रिस्पॉन्स में एक प्रॉमिस मिलता है. सूचना दिखने के बाद, इस प्रॉमिस को रिज़ॉल्व कर दिया जाएगा.

इस उदाहरण को ज़्यादा से ज़्यादा साफ़ तौर पर समझाने के लिए, मैंने इस प्रॉमिस को promiseChain नाम के वैरिएबल को असाइन किया है. इसके बाद, इसे event.waitUntil() में पास किया जाता है. मुझे पता है कि यह बहुत ज़्यादा शब्दों में है, लेकिन मैंने कई ऐसी समस्याएं देखी हैं जो waitUntil() में क्या पास किया जाना चाहिए, इसे गलत समझने या प्रॉमिस चेन के टूटने की वजह से हुई हैं.

डेटा के लिए नेटवर्क अनुरोध और Analytics की मदद से पुश इवेंट को ट्रैक करने का एक और जटिल उदाहरण इस तरह दिख सकता है:

self.addEventListener('push', function(event) {
    const analyticsPromise = pushReceivedTracking();
    const pushInfoPromise = fetch('/api/get-more-data')
    .then(function(response) {
        return response.json();
    })
    .then(function(response) {
        const title = response.data.userName + ' says...';
        const message = response.data.message;

        return self.registration.showNotification(title, {
        body: message
        });
    });

    const promiseChain = Promise.all([
    analyticsPromise,
    pushInfoPromise
    ]);

    event.waitUntil(promiseChain);
});

यहां हम एक ऐसे फ़ंक्शन को कॉल कर रहे हैं जो प्रॉमिस pushReceivedTracking() दिखाता है. उदाहरण के लिए, हम यह मान सकते हैं कि यह फ़ंक्शन, आंकड़े उपलब्ध कराने वाली कंपनी को नेटवर्क का अनुरोध करेगा. हम नेटवर्क का अनुरोध भी कर रहे हैं, जवाब पा रहे हैं, और सूचना के टाइटल और मैसेज के लिए जवाबों के डेटा का इस्तेमाल करके सूचना दिखा रहे हैं.

हम यह पक्का कर सकते हैं कि सर्विस वर्कर तब तक चालू रहे, जब तक ये दोनों टास्क पूरे नहीं हो जाते. इसके लिए, इन प्रॉमिस को Promise.all() के साथ जोड़ना होगा. इससे मिलने वाला प्रॉमिस event.waitUntil() में पास किया जाता है. इसका मतलब है कि ब्राउज़र तब तक इंतज़ार करेगा, जब तक दोनों प्रॉमिस पूरे नहीं हो जाते. इसके बाद, वह यह जांच करेगा कि सूचना दिखाई गई है या नहीं और सर्विस वर्कर को बंद कर देगा.

हमें waitUntil() और इसके इस्तेमाल के बारे में इसलिए चिंता करनी चाहिए, क्योंकि डेवलपर को सबसे ज़्यादा होने वाली समस्याओं में से एक यह है कि जब प्रॉमिस चेन गलत / टूटी हुई होती है, तो Chrome यह "डिफ़ॉल्ट" सूचना दिखाएगा:

Chrome में डिफ़ॉल्ट सूचना की इमेज

Chrome, "इस साइट को बैकग्राउंड में अपडेट किया गया है" सूचना सिर्फ़ तब दिखाएगा, जब पुश मैसेज मिलेगा और सर्विस वर्कर में पुश इवेंट, event.waitUntil() को पास किए गए प्रॉमिस के खत्म होने के बाद सूचना नहीं दिखाएगा.

डेवलपर के इस समस्या में फंसने की मुख्य वजह यह है कि उनका कोड अक्सर self.registration.showNotification() को कॉल करता है, लेकिन वे इससे मिलने वाले प्रॉमिस का इस्तेमाल नहीं करते. इस वजह से, कभी-कभी डिफ़ॉल्ट सूचना दिखती है. उदाहरण के लिए, हम ऊपर दिए गए उदाहरण में self.registration.showNotification() के लिए रिटर्न हटा सकते हैं. ऐसा करने पर, हमें यह सूचना दिख सकती है.

self.addEventListener('push', function(event) {
    const analyticsPromise = pushReceivedTracking();
    const pushInfoPromise = fetch('/api/get-more-data')
    .then(function(response) {
        return response.json();
    })
    .then(function(response) {
        const title = response.data.userName + ' says...';
        const message = response.data.message;

        self.registration.showNotification(title, {
        body: message
        });
    });

    const promiseChain = Promise.all([
    analyticsPromise,
    pushInfoPromise
    ]);

    event.waitUntil(promiseChain);
});

इस तरह की गड़बड़ी होना आम बात है.

याद रखें - अगर आपको यह सूचना दिखती है, तो अपनी प्रॉमिस चेन और event.waitUntil() देखें.

अगले सेक्शन में, हम देखेंगे कि सूचनाओं को स्टाइल करने के लिए क्या किया जा सकता है और कौनसा कॉन्टेंट दिखाया जा सकता है.

आगे क्या करना है

कोड लैब