푸시 이벤트

지금까지 사용자를 구독하고 푸시 메시지를 전송하는 방법을 살펴보았습니다. 다음 단계는 사용자의 기기에서 이 푸시 메시지를 수신하고 알림을 표시하는 것입니다 (원하는 다른 작업도 수행할 수 있음).

푸시 이벤트

메시지가 수신되면 서비스 워커에서 푸시 이벤트가 전달됩니다.

푸시 이벤트 리스너를 설정하는 코드는 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()에 전달해야 하는 항목을 오해하거나 프로미스 체인이 끊어져서 발생하는 여러 문제를 보았습니다.

데이터에 대한 네트워크 요청과 분석을 통한 푸시 이벤트 추적이 포함된 더 복잡한 예는 다음과 같습니다.

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()를 확인하세요.

다음 섹션에서는 알림의 스타일을 지정하는 방법과 표시할 수 있는 콘텐츠를 살펴보겠습니다.

다음에 수행할 작업

코드 실습