Sự kiện đẩy

Đến đây, chúng ta đã đề cập đến việc đăng ký người dùng và gửi thông báo đẩy. Bước tiếp theo là nhận thông báo đẩy này trên thiết bị của người dùng và hiển thị thông báo (cũng như thực hiện bất kỳ công việc nào khác mà chúng ta muốn làm).

Sự kiện đẩy

Khi nhận được một thông báo, một sự kiện đẩy sẽ được gửi trong trình chạy dịch vụ của bạn.

Mã để thiết lập trình nghe sự kiện đẩy phải khá giống với bất kỳ trình nghe sự kiện nào khác mà bạn viết bằng 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.');
    }
});

Phần kỳ lạ nhất của mã này đối với hầu hết các nhà phát triển mới sử dụng trình chạy dịch vụ là biến self. self thường được dùng trong Trình chạy web, tức là trình chạy dịch vụ. self đề cập đến phạm vi toàn cục, giống như window trong trang web. Nhưng đối với trình chạy web và trình chạy dịch vụ, self đề cập đến chính trình chạy đó.

Trong ví dụ trên, self.addEventListener() có thể được coi là thêm trình nghe sự kiện vào chính trình chạy dịch vụ.

Trong ví dụ về sự kiện đẩy, chúng ta kiểm tra xem có dữ liệu nào không và in nội dung nào đó vào bảng điều khiển.

Có nhiều cách khác để phân tích cú pháp dữ liệu từ một sự kiện đẩy:

// 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()

Hầu hết mọi người đều sử dụng json() hoặc text() tuỳ thuộc vào những gì họ mong đợi từ ứng dụng của mình.

Ví dụ này minh hoạ cách thêm trình nghe sự kiện đẩy và cách truy cập dữ liệu, nhưng thiếu hai chức năng rất quan trọng. Nó không hiển thị thông báo và không sử dụng event.waitUntil().

Chờ đến

Một trong những điều cần hiểu về trình chạy dịch vụ là bạn có rất ít quyền kiểm soát đối với thời điểm mã trình chạy dịch vụ sẽ chạy. Trình duyệt quyết định thời điểm kích hoạt và thời điểm chấm dứt trình chạy dịch vụ. Cách duy nhất để bạn có thể thông báo cho trình duyệt rằng "Này, tôi đang rất bận làm việc quan trọng" là truyền một lời hứa vào phương thức event.waitUntil(). Nhờ đó, trình duyệt sẽ duy trì hoạt động của trình chạy dịch vụ cho đến khi lời hứa mà bạn đã truyền vào được giải quyết.

Đối với sự kiện đẩy, có một yêu cầu bổ sung là bạn phải hiển thị thông báo trước khi lời hứa mà bạn đã chuyển vào được giải quyết.

Dưới đây là ví dụ cơ bản về cách hiển thị thông báo:

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

    event.waitUntil(promiseChain);
});

Việc gọi self.registration.showNotification() là phương thức hiển thị thông báo cho người dùng và phương thức này sẽ trả về một lời hứa sẽ được thực hiện sau khi thông báo hiển thị.

Để ví dụ này rõ ràng nhất có thể, tôi đã gán lời hứa này cho một biến có tên là promiseChain. Sau đó, giá trị này được truyền vào event.waitUntil(). Tôi biết điều này rất dài dòng, nhưng tôi đã thấy một số vấn đề xảy ra do hiểu nhầm về những gì cần được truyền vào waitUntil() hoặc do chuỗi hứa hẹn bị hỏng.

Một ví dụ phức tạp hơn với yêu cầu mạng về dữ liệu và theo dõi sự kiện đẩy bằng số liệu phân tích có thể có dạng như sau:

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);
});

Ở đây, chúng ta đang gọi một hàm trả về lời hứa pushReceivedTracking(). Để làm ví dụ, chúng ta có thể giả vờ rằng hàm này sẽ đưa ra yêu cầu mạng cho nhà cung cấp dịch vụ phân tích. Chúng ta cũng đang tạo một yêu cầu mạng, nhận phản hồi và hiện thông báo bằng cách sử dụng dữ liệu phản hồi cho tiêu đề và thông báo của thông báo.

Chúng ta có thể đảm bảo trình chạy dịch vụ luôn hoạt động trong khi cả hai tác vụ này được thực hiện bằng cách kết hợp các lời hứa này với Promise.all(). Lời hứa kết quả được chuyển vào event.waitUntil(), nghĩa là trình duyệt sẽ đợi cho đến khi cả hai lời hứa đều hoàn tất trước khi kiểm tra xem thông báo đã được hiển thị hay chưa và chấm dứt trình chạy dịch vụ.

Lý do chúng ta nên quan tâm đến waitUntil() và cách sử dụng là một trong những vấn đề phổ biến nhất mà nhà phát triển gặp phải là khi chuỗi lời hứa không chính xác/bị hỏng, Chrome sẽ hiển thị thông báo "mặc định" sau:

Hình ảnh về thông báo mặc định trong Chrome

Chrome sẽ chỉ hiển thị thông báo "Trang web này đã được cập nhật ở chế độ nền" khi nhận được thông báo đẩy và sự kiện đẩy trong trình chạy dịch vụ không hiển thị thông báo sau khi lời hứa được chuyển đến event.waitUntil() đã hoàn tất.

Lý do chính khiến nhà phát triển gặp phải vấn đề này là mã của họ thường gọi self.registration.showNotification() nhưng họ không làm gì với lời hứa mà mã này trả về. Điều này đôi khi khiến thông báo mặc định xuất hiện. Ví dụ: chúng ta có thể xoá giá trị trả về cho self.registration.showNotification() trong ví dụ trên và có nguy cơ thấy thông báo này.

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);
});

Bạn có thể thấy đây là một điều dễ bị bỏ qua.

Hãy nhớ rằng nếu bạn thấy thông báo đó, hãy kiểm tra chuỗi hứa hẹn và event.waitUntil().

Trong phần tiếp theo, chúng ta sẽ tìm hiểu những việc có thể làm để tạo kiểu cho thông báo và nội dung có thể hiển thị.

Điểm đến tiếp theo

Lớp học lập trình