Bu noktaya kadar, bir kullanıcıya abone olma ve push mesajı gönderme konularını ele aldık. Bir sonraki adım, bu push mesajını kullanıcının cihazında almak ve bir bildirim göstermektir (ayrıca yapmak isteyebileceğimiz diğer tüm işlemleri de yapabiliriz).
Push etkinliği
Bir mesaj alındığında, hizmet çalışanınızda bir push etkinliği gönderilir.
Push etkinlik işleyicisi oluşturma kodu, JavaScript'te yazacağınız diğer etkinlik işleyicilere oldukça benzer:
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.');
}
});
Hizmet çalışanlarını yeni kullanmaya başlayan çoğu geliştirici için bu kodun en tuhaf kısmı self değişkenidir. self, hizmet çalışanlarının da dahil olduğu Web Çalışanları'nda yaygın olarak kullanılır. self, web sayfasındaki window gibi global kapsamı ifade eder. Ancak web çalışanları ve hizmet çalışanları için self, çalışanın kendisini ifade eder.
Yukarıdaki örnekte self.addEventListener(), hizmet çalışanına bir etkinlik işleyici eklemek olarak düşünülebilir.
Push etkinliği örneğinde, veri olup olmadığını kontrol eder ve konsola bir şey yazdırırız.
Push etkinliğindeki verileri ayrıştırmanın başka yolları da vardır:
// 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()
Çoğu kullanıcı, uygulamadan beklentilerine bağlı olarak json() veya text() kullanır.
Bu örnekte, push etkinlik işleyicinin nasıl ekleneceği ve verilere nasıl erişileceği gösterilmektedir ancak iki çok önemli işlev eksiktir. Bildirim göstermiyor ve event.waitUntil() kullanmıyor.
Şu zamana kadar bekle:
Hizmet çalışanları hakkında bilinmesi gerekenlerden biri, hizmet çalışanı kodunun ne zaman çalıştırılacağı konusunda çok az kontrolünüz olduğudur. Tarayıcı, hizmet çalışanını ne zaman uyandıracağına ve ne zaman sonlandıracağına karar verir. Tarayıcıya "Önemli işlerle çok meşgulüm" demenin tek yolu, event.waitUntil() yöntemine bir promise iletmektir. Bu sayede tarayıcı, ilettiğiniz promise çözümlenene kadar hizmet çalışanını çalışır durumda tutar.
Push etkinliklerinde, ilettiğiniz promise çözümlenmeden önce bir bildirim göstermeniz gerekir.
Bildirim göstermeyle ilgili basit bir örneği aşağıda bulabilirsiniz:
self.addEventListener('push', function(event) {
const promiseChain = self.registration.showNotification('Hello, World.');
event.waitUntil(promiseChain);
});
self.registration.showNotification() çağrısı, kullanıcıya bildirim gösteren yöntemdir ve bildirim gösterildikten sonra çözümlenecek bir promise döndürür.
Bu örneği olabildiğince anlaşılır tutmak için bu promise'i promiseChain adlı bir değişkene atadım. Bu değer daha sonra event.waitUntil()'e iletilir. Bunun çok ayrıntılı bir açıklama olduğunun farkındayım ancak waitUntil() işlevine neyin iletilmesi gerektiğinin yanlış anlaşılması veya bozuk promise zincirleri nedeniyle ortaya çıkan birçok sorun gördüm.
Veri için ağ isteği içeren ve push etkinliğini Analytics ile izleyen daha karmaşık bir örnek şöyle görünebilir:
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);
});
Burada, bir promise pushReceivedTracking() döndüren bir işlev çağırıyoruz.
Örnek olması açısından, bu işlevin analiz sağlayıcımıza bir ağ isteği göndereceğini varsayabiliriz. Ayrıca bir ağ isteği gönderiyor, yanıtı alıyor ve yanıt verilerini kullanarak bildirimin başlığı ve mesajı için bir bildirim gösteriyoruz.
Bu vaatleri Promise.all() ile birleştirerek her iki görev de tamamlanırken hizmet çalışanının etkin kalmasını sağlayabiliriz. Elde edilen promise event.waitUntil() öğesine iletilir.
Bu, tarayıcının bir bildirimin gösterildiğini kontrol etmeden ve hizmet çalışanını sonlandırmadan önce her iki promise'in de tamamlanmasını bekleyeceği anlamına gelir.
waitUntil() ve nasıl kullanılacağı konusunda endişelenmemizin nedeni, geliştiricilerin en sık karşılaştığı sorunlardan birinin, promise zinciri yanlış/bozuk olduğunda Chrome'un şu "varsayılan" bildirimi göstermesidir:
Chrome, yalnızca bir push mesajı alındığında ve hizmet çalışanındaki push etkinliği, event.waitUntil() öğesine iletilen vaat tamamlandıktan sonra bildirim göstermediğinde "Bu site arka planda güncellendi." bildirimini gösterir.
Geliştiricilerin bu sorunu yaşamasının temel nedeni, kodlarının genellikle self.registration.showNotification() yöntemini çağırması ancak döndürdüğü Promise ile ilgili herhangi bir işlem yapmamasıdır. Bu durum, zaman zaman varsayılan bildirimin gösterilmesine neden olur. Örneğin, yukarıdaki örnekte self.registration.showNotification() için return ifadesini kaldırabiliriz ve bu bildirimi görme riskiyle karşı karşıya kalırız.
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);
});
Bunun gözden kaçmasının ne kadar kolay olduğunu görebilirsiniz.
Bu bildirimi görürseniz promise zincirlerinizi ve event.waitUntil() öğesini kontrol etmeyi unutmayın.
Bir sonraki bölümde, bildirimleri biçimlendirmek için neler yapabileceğimize ve hangi içerikleri gösterebileceğimize bakacağız.
Sonraki adımlar
- Web Push Bildirimlerine Genel Bakış
- Push'un İşleyiş Şekli
- Kullanıcı abone etme
- İzin kullanıcı deneyimi
- Web Push kitaplıklarıyla mesaj gönderme
- Web Push Protokolü
- Push Etkinliklerini İşleme
- Bildirim gösterme
- Bildirim Davranışı
- Yaygın Bildirim Kalıpları
- Push bildirimleri ile ilgili SSS
- Sık Karşılaşılan Sorunlar ve Hata Bildirme