Lớp học lập trình này hướng dẫn bạn từng bước cách tạo ứng dụng thông báo đẩy. Khi kết thúc lớp học lập trình này, bạn sẽ có một ứng dụng khách:
- Đăng ký cho người dùng nhận thông báo đẩy.
- Nhận tin nhắn đẩy và hiển thị dưới dạng thông báo.
- Huỷ đăng ký nhận thông báo đẩy cho người dùng.
Lớp học lập trình này tập trung vào việc giúp bạn học thông qua thực hành và không nói nhiều về các khái niệm. Đọc bài viết Cách hoạt động của thông báo đẩy để tìm hiểu về các khái niệm liên quan đến thông báo đẩy.
Mã máy chủ của lớp học lập trình này đã hoàn tất. Bạn sẽ chỉ triển khai ứng dụng trong lớp học lập trình này. Để tìm hiểu cách triển khai máy chủ thông báo đẩy, hãy xem Lớp học lập trình: Tạo máy chủ thông báo đẩy.
Khả năng tương thích với trình duyệt
Lớp học lập trình này hoạt động với các tổ hợp hệ điều hành và trình duyệt sau:
- Windows: Chrome, Edge
- macOS: Chrome, Firefox
- Android: Chrome, Firefox
Lớp học lập trình này được biết là không hoạt động với các hệ điều hành sau đây (hoặc tổ hợp hệ điều hành và trình duyệt):
- macOS: Brave, Edge, Safari
- iOS
Thiết lập
Thiết lập phương thức xác thực
Trước khi có thể sử dụng thông báo đẩy, bạn cần thiết lập
máy chủ và ứng dụng bằng khoá xác thực.
Hãy xem bài viết Ký yêu cầu giao thức thông báo đẩy trên web để tìm hiểu lý do. Thông thường, bạn lưu trữ khoá bí mật trong tệp .env, tương tự như sau.
VAPID_PUBLIC_KEY="BKiwTvD9HA…"
VAPID_PRIVATE_KEY="4mXG9jBUaU…"
VAPID_SUBJECT="mailto:test@test.test"
- Mở
public/index.js. - Thay thế
VAPID_PUBLIC_KEY_VALUE_HEREbằng giá trị khoá công khai của bạn.
Đăng ký trình chạy dịch vụ
Ứng dụng khách của bạn cần có một trình chạy dịch vụ để nhận và hiển thị thông báo. Tốt nhất là bạn nên đăng ký trình chạy dịch vụ càng sớm càng tốt. Hãy xem phần Nhận và hiển thị thông báo đẩy dưới dạng thông báo để biết thêm thông tin.
Thay thế nhận xét
// TODO add startup logic herebằng mã sau:if ('serviceWorker' in navigator && 'PushManager' in window) { navigator.serviceWorker.register('./service-worker.js').then(serviceWorkerRegistration => { console.info('Service worker was registered.'); console.info({serviceWorkerRegistration}); }).catch(error => { console.error('An error occurred while registering the service worker.'); console.error(error); }); subscribeButton.disabled = false; } else { console.error('Browser does not support service workers or push messages.'); } subscribeButton.addEventListener('click', subscribeButtonHandler); unsubscribeButton.addEventListener('click', unsubscribeButtonHandler);Trong Chrome, hãy mở Bảng điều khiển Công cụ cho nhà phát triển.
Bạn sẽ thấy thông báo
Service worker was registered.được ghi vào Bảng điều khiển.
Yêu cầu cấp quyền gửi thông báo đẩy
Bạn không bao giờ được yêu cầu cấp quyền gửi thông báo đẩy khi tải trang. Thay vào đó, giao diện người dùng của bạn nên hỏi người dùng xem họ có muốn nhận thông báo đẩy hay không. Sau khi người dùng xác nhận rõ ràng (ví dụ: bằng cách nhấp vào nút), bạn có thể bắt đầu quy trình chính thức để nhận quyền gửi thông báo đẩy từ trình duyệt.
Trong
public/index.js, hãy thay thế nhận xét// TODOtrongsubscribeButtonHandler()bằng mã sau:// Prevent the user from clicking the subscribe button multiple times. subscribeButton.disabled = true; const result = await Notification.requestPermission(); if (result === 'denied') { console.error('The user explicitly denied the permission request.'); return; } if (result === 'granted') { console.info('The user accepted the permission request.'); }Quay lại thẻ ứng dụng rồi nhấp vào Subscribe to push (Đăng ký nhận thông báo đẩy). Trình duyệt hoặc hệ điều hành của bạn sẽ hỏi xem bạn có muốn cho phép trang web gửi thông báo đẩy cho bạn hay không.
Chọn Cho phép (hoặc cụm từ tương đương mà trình duyệt hoặc hệ điều hành của bạn sử dụng). Trong Bảng điều khiển, bạn sẽ thấy một thông báo cho biết yêu cầu đã được chấp nhận hay bị từ chối.
Đăng ký nhận thông báo đẩy
Quá trình đăng ký bao gồm việc tương tác với một dịch vụ web do nhà cung cấp trình duyệt kiểm soát, được gọi là dịch vụ đẩy. Sau khi nhận được thông tin đăng ký thông báo đẩy, bạn cần gửi thông tin đó đến một máy chủ và yêu cầu máy chủ lưu trữ thông tin đó trong cơ sở dữ liệu lâu dài.
Thêm mã được đánh dấu sau đây vào
subscribeButtonHandler():subscribeButton.disabled = true; const result = await Notification.requestPermission(); if (result === 'denied') { console.error('The user explicitly denied the permission request.'); return; } if (result === 'granted') { console.info('The user accepted the permission request.'); } const registration = await navigator.serviceWorker.getRegistration(); const subscribed = await registration.pushManager.getSubscription(); if (subscribed) { console.info('User is already subscribed.'); notifyMeButton.disabled = false; unsubscribeButton.disabled = false; return; } const subscription = await registration.pushManager.subscribe({ userVisibleOnly: true, applicationServerKey: urlB64ToUint8Array(VAPID_PUBLIC_KEY) }); notifyMeButton.disabled = false; fetch('/add-subscription', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(subscription) });
Tuỳ chọn userVisibleOnly phải là true. Một ngày nào đó, có thể đẩy thông báo mà không hiển thị thông báo cho người dùng (đẩy thông báo im lặng) nhưng trình duyệt không cho phép tính năng đó vì lo ngại về quyền riêng tư.
Giá trị applicationServerKey dựa vào một hàm hiệu dụng giúp chuyển đổi chuỗi base64 thành Uint8Array. Giá trị này được dùng để xác thực giữa máy chủ của bạn và dịch vụ thông báo đẩy.
Huỷ đăng ký nhận thông báo đẩy
Sau khi người dùng đăng ký nhận thông báo đẩy, giao diện người dùng của bạn cần cung cấp cách huỷ đăng ký trong trường hợp người dùng thay đổi ý định và không muốn nhận thông báo đẩy nữa.
- Thay thế nhận xét
// TODOtrongunsubscribeButtonHandler()bằng mã sau:
const registration = await navigator.serviceWorker.getRegistration();
const subscription = await registration.pushManager.getSubscription();
fetch('/remove-subscription', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({endpoint: subscription.endpoint})
});
const unsubscribed = await subscription.unsubscribe();
if (unsubscribed) {
console.info('Successfully unsubscribed from push notifications.');
unsubscribeButton.disabled = true;
subscribeButton.disabled = false;
notifyMeButton.disabled = true;
}
Nhận thông báo đẩy và hiển thị thông báo đó dưới dạng thông báo
Như đã đề cập trước đó, bạn cần có một trình chạy dịch vụ để xử lý việc nhận và hiển thị thông báo được đẩy đến ứng dụng từ máy chủ của bạn. Hãy xem phần Nhận và hiển thị thông báo đẩy dưới dạng thông báo để biết thêm chi tiết.
Mở
public/service-worker.jsvà thay thế nhận xét// TODOtrong trình xử lý sự kiệnpushcủa trình chạy dịch vụ bằng mã sau:let data = event.data.json(); const image = 'logo.png'; const options = { body: data.options.body, icon: image } self.registration.showNotification( data.title, options );Quay lại thẻ ứng dụng.
Nhấp vào Thông báo cho tôi. Bạn sẽ nhận được một thông báo đẩy.
Mở URL của thẻ ứng dụng trong các trình duyệt được hỗ trợ khác. Xem qua quy trình đăng ký rồi nhấp vào Thông báo cho tất cả. Bạn sẽ nhận được cùng một thông báo đẩy trong mỗi ứng dụng.
Bạn có thể tuỳ chỉnh thông báo theo nhiều cách. Hãy xem các tham số của ServiceWorkerRegistration.showNotification() để tìm hiểu thêm.
Mở một URL khi người dùng nhấp vào thông báo
Trong thực tế, có thể bạn sẽ sử dụng thông báo này như một cách để thu hút lại người dùng và nhắc họ truy cập vào trang web của bạn. Để làm được điều đó, bạn cần định cấu hình trình chạy dịch vụ thêm một chút.
Thay thế nhận xét
// TODOtrong trình xử lý sự kiệnnotificationclickcủa trình chạy dịch vụ bằng mã sau:event.notification.close(); event.waitUntil(self.clients.openWindow('https://web.dev'));Quay lại thẻ ứng dụng, gửi cho chính bạn một thông báo khác rồi nhấp vào thông báo đó. Trình duyệt của bạn sẽ mở một thẻ mới và tải
https://web.dev.
Các bước tiếp theo
- Hãy xem
ServiceWorkerRegistration.showNotification()để khám phá tất cả các cách tuỳ chỉnh thông báo. - Đọc bài viết Tổng quan về thông báo đẩy để hiểu sâu hơn về cách hoạt động của thông báo đẩy.
- Hãy xem Lớp học lập trình: Tạo máy chủ thông báo đẩy để tìm hiểu cách tạo máy chủ quản lý gói thuê bao và gửi yêu cầu giao thức đẩy web.
- Hãy dùng thử Trình tạo thông báo để thử nghiệm tất cả các cách tuỳ chỉnh thông báo.