Envoyer un message de test à une application en arrière-plan

Pour commencer à utiliser FCM, développez le cas d'utilisation le plus simple : envoyer un message de notification à un utilisateur spécifique lorsque l'application est en arrière-plan sur l'appareil. Cette page liste toutes les étapes à suivre pour y parvenir, de la configuration à la validation. Elle peut inclure des étapes que vous avez déjà effectuées si vous avez configuré une application cliente JavaScript pour FCM.

Configurez le SDK

Si ce n'est pas déjà fait, ajoutez Firebase à votre projet JavaScript.

Accéder au jeton d'enregistrement

Lorsque vous devez récupérer le jeton d'enregistrement actuel pour une instance d'application, demandez d'abord à l'utilisateur les autorisations de notification avec Notification.requestPermission(). Lorsqu'elle est appelée comme indiqué, elle renvoie un jeton si l'autorisation est accordée ou rejette la promesse si elle est refusée : 

function requestPermission() {
  console.log('Requesting permission...');
  Notification.requestPermission().then((permission) => {
    if (permission === 'granted') {
      console.log('Notification permission granted.');

FCM nécessite un fichier firebase-messaging-sw.js. Sauf si vous disposez déjà d'un fichier firebase-messaging-sw.js, créez un fichier vide portant ce nom et placez-le à la racine de votre domaine avant de récupérer un jeton. Vous pourrez ajouter du contenu pertinent au fichier plus tard, lors de la configuration du client.

Pour récupérer le jeton actuel :

Web

import { getMessaging, getToken } from "firebase/messaging";

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
const messaging = getMessaging();
getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});
messaging_get_token.js

Web

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});
index.js

Une fois le jeton obtenu, envoyez-le au serveur de votre application et stockez-le à l'aide de la méthode de votre choix.

Envoyer un message de notification test

  1. Installez et exécutez l'application sur l'appareil cible. Sur les appareils Apple, vous devez accepter la demande d'autorisation pour recevoir des notifications à distance.

  2. Assurez-vous que l'application est en arrière-plan sur l'appareil.

  3. Dans la console Firebase, ouvrez la page Messagerie.

  4. S'il s'agit de votre premier message, sélectionnez Créer votre première campagne.

    1. Sélectionnez Messages de notification Firebase, puis Créer.

  5. Sinon, dans l'onglet Campagnes, sélectionnez Nouvelle campagne, puis Notifications.

  6. Saisissez le texte du message. Tous les autres sont facultatifs.

  7. Dans le volet de droite, sélectionnez Envoyer un message test.

  8. Dans le champ Ajouter un jeton d'enregistrement FCM, saisissez le jeton d'enregistrement que vous avez obtenu dans une section précédente de ce guide.

  9. Sélectionnez Tester.

Après avoir sélectionné Tester, l'appareil client ciblé (avec l'application en arrière-plan) devrait recevoir la notification.

Étapes suivantes

Envoyer des messages aux applications mises au premier plan

Une fois que vous avez réussi à envoyer des messages de notification lorsque votre application est en arrière-plan, consultez Recevoir des messages dans un client JavaScript pour commencer à envoyer des messages aux applications mises au premier plan.

Aller au-delà des messages de notification

Pour aller au-delà des messages de notification et ajouter d'autres comportements plus avancés à votre application, consultez :