Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

Pour commencer avec FCM, créez 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 répertorie toutes les étapes pour y parvenir, de la configuration à la vérification - il peut couvrir les étapes que vous avez terminé déjà si vous avez mis en place une application client JavaScript pour la FCM.

Configurer le SDK

Si vous avez pas déjà, ajoutez Firebase à votre projet JavaScript .

Accéder au jeton d'inscription

Lorsque vous devez récupérer l'enregistrement en cours jeton pour une instance d'application, appelez getToken . Si l'autorisation de notification n'a pas été accordée, cette méthode demandera à l'utilisateur des autorisations de notification. Sinon, il renvoie un jeton ou rejette la promesse en raison d'une erreur.

La FCM a besoin d' un firebase-messaging-sw.js fichier. Sauf si vous avez déjà un firebase-messaging-sw.js fichier, créez un fichier vide avec ce nom et le placer dans la racine de votre domaine avant de récupérer un jeton. Vous pouvez ajouter un contenu significatif au fichier ultérieurement au cours du processus de configuration du client.

Pour récupérer le jeton actuel :

Web version 9

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

Web version 8

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

Une fois que vous avez obtenu le jeton, envoyez-le à votre serveur d'applications et stockez-le en utilisant votre méthode préférée.

Envoyer un message de notification de test

  1. Installez et exécutez l'application sur l'appareil cible.

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

  3. Ouvrez le Notifications compositeur et sélectionnez Nouvelle notification.

  4. Saisissez le texte du message.

  5. Sélectionnez un message de test Envoyer.

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

  7. Cliquez sur test

Après avoir cliqué sur Test, le dispositif client ciblé (avec l'application en arrière - plan) doit recevoir la notification dans le navigateur.

Prochaines étapes

Envoyer des messages aux applications au premier plan

Une fois que vous avez envoyé avec succès des messages de notification pendant que votre application est en arrière - plan, voir recevoir des messages dans un client JavaScript pour commencer à envoyer des applications à 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 :