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

जावास्क्रिप्ट क्लाइंट में संदेश प्राप्त करें

संदेशों का व्यवहार इस बात पर निर्भर करता है कि पृष्ठ अग्रभूमि में है (फ़ोकस है), या पृष्ठभूमि में, अन्य टैब के पीछे छिपा हुआ है, या पूरी तरह से बंद है। सभी मामलों में पेज संभाल चाहिए onMessage कॉलबैक, लेकिन पृष्ठभूमि मामलों में आप भी संभाल करने के लिए आवश्यकता हो सकती है onBackgroundMessage या अग्रभूमि में अपने वेब एप्लिकेशन को लाने के लिए उपयोगकर्ता की अनुमति के लिए प्रदर्शन अधिसूचना कॉन्फ़िगर करें।

ऐप स्थिति अधिसूचना आंकड़े दोनों
अग्रभूमि onMessage onMessage onMessage
पृष्ठभूमि (सेवा कार्यकर्ता) onBackgroundMessage (प्रदर्शन अधिसूचना स्वचालित रूप से दिखाया गया है) onBackgroundMessage onBackgroundMessage (प्रदर्शन अधिसूचना स्वचालित रूप से दिखाया गया है)

जावास्क्रिप्ट त्वरित प्रारंभ नमूना संदेश प्राप्त करने के लिए आवश्यक सभी कोड को दर्शाता है।

जब आपका वेब ऐप अग्रभूमि में हो तो संदेशों को संभालें

आदेश प्राप्त करने के लिए onMessage घटना में अपने ऐप्लिकेशन में Firebase संदेश सेवा कार्यकर्ता को परिभाषित करना होगा firebase-messaging-sw.js । वैकल्पिक रूप से, आप के माध्यम से एसडीके के लिए एक मौजूदा सेवा कार्यकर्ता प्रदान कर सकते हैं getToken(): Promise<string>

वेब संस्करण 9

import { initializeApp } from "firebase/app";
import { getMessaging } from "firebase/messaging/sw";

// Initialize the Firebase app in the service worker by passing in
// your app's Firebase config object.
// https://firebase.google.com/docs/web/setup#config-object
const firebaseApp = initializeApp({
  apiKey: 'api-key',
  authDomain: 'project-id.firebaseapp.com',
  databaseURL: 'https://project-id.firebaseio.com',
  projectId: 'project-id',
  storageBucket: 'project-id.appspot.com',
  messagingSenderId: 'sender-id',
  appId: 'app-id',
  measurementId: 'G-measurement-id',
});

// Retrieve an instance of Firebase Messaging so that it can handle background
// messages.
const messaging = getMessaging(firebaseApp);

वेब संस्करण 8

// Give the service worker access to Firebase Messaging.
// Note that you can only use Firebase Messaging here. Other Firebase libraries
// are not available in the service worker.
importScripts('https://www.gstatic.com/firebasejs/8.10.0/firebase-app.js');
importScripts('https://www.gstatic.com/firebasejs/8.10.0/firebase-messaging.js');

// Initialize the Firebase app in the service worker by passing in
// your app's Firebase config object.
// https://firebase.google.com/docs/web/setup#config-object
firebase.initializeApp({
  apiKey: 'api-key',
  authDomain: 'project-id.firebaseapp.com',
  databaseURL: 'https://project-id.firebaseio.com',
  projectId: 'project-id',
  storageBucket: 'project-id.appspot.com',
  messagingSenderId: 'sender-id',
  appId: 'app-id',
  measurementId: 'G-measurement-id',
});

// Retrieve an instance of Firebase Messaging so that it can handle background
// messages.
const messaging = firebase.messaging();

जब आपका ऐप अग्रभूमि में होता है (उपयोगकर्ता वर्तमान में आपका वेब पेज देख रहा है), तो आप सीधे पेज में डेटा और अधिसूचना पेलोड प्राप्त कर सकते हैं।

वेब संस्करण 9

// Handle incoming messages. Called when:
// - a message is received while the app has focus
// - the user clicks on an app notification created by a service worker
//   `messaging.onBackgroundMessage` handler.
import { getMessaging, onMessage } from "firebase/messaging";

const messaging = getMessaging();
onMessage(messaging, (payload) => {
  console.log('Message received. ', payload);
  // ...
});

वेब संस्करण 8

// Handle incoming messages. Called when:
// - a message is received while the app has focus
// - the user clicks on an app notification created by a service worker
//   `messaging.onBackgroundMessage` handler.
messaging.onMessage((payload) => {
  console.log('Message received. ', payload);
  // ...
});

जब आपका वेब ऐप बैकग्राउंड में हो तो संदेशों को हैंडल करें

ऐप के बैकग्राउंड में होने पर प्राप्त सभी संदेश ब्राउज़र में एक डिस्प्ले नोटिफिकेशन को ट्रिगर करते हैं। आप इस अधिसूचना के लिए विकल्प निर्दिष्ट कर सकते हैं, जैसे शीर्षक या क्लिक क्रिया, या तो अपने ऐप सर्वर से भेजें अनुरोध में, या क्लाइंट पर सेवा कार्यकर्ता तर्क का उपयोग करके।

भेजें अनुरोध में अधिसूचना विकल्प सेट करना

अनुप्रयोग सर्वर से भेजा सूचना संदेश के लिए, FCM जावास्क्रिप्ट एपीआई का समर्थन करता है fcm_options.link कुंजी। आमतौर पर यह आपके वेब ऐप के एक पेज पर सेट होता है:

https://fcm.googleapis.com//v1/projects/<YOUR-PROJECT-ID>/messages:send
Content-Type: application/json
Authorization: bearer <YOUR-ACCESS-TOKEN>

{
  "message": {
    "token": "eEz-Q2sG8nQ:APA91bHJQRT0JJ...",
    "notification": {
      "title": "Background Message Title",
      "body": "Background message body"
    },
    "webpush": {
      "fcm_options": {
        "link": "https://dummypage.com"
      }
    }
  }
}

यदि लिंक मान किसी ऐसे पृष्ठ की ओर इंगित करता है जो पहले से ब्राउज़र टैब में खुला है, तो अधिसूचना पर एक क्लिक उस टैब को अग्रभूमि में लाता है। यदि पृष्ठ पहले से खुला नहीं है, तो एक अधिसूचना क्लिक पृष्ठ को एक नए टैब में खोलता है।

क्योंकि डेटा संदेशों का समर्थन नहीं करते fcm_options.link , आप सभी डेटा संदेशों को एक अधिसूचना पेलोड को जोड़ने के लिए सिफारिश की है। वैकल्पिक रूप से, आप सेवा कार्यकर्ता का उपयोग करके सूचनाओं को संभाल सकते हैं।

अधिसूचना और डेटा संदेशों के बीच अंतर का एक विवरण के लिए, देखें संदेश प्रकार

सेवा कार्यकर्ता में अधिसूचना विकल्प सेट करना

डेटा संदेशों के लिए, आप सेवा कार्यकर्ता में सूचना विकल्प सेट कर सकते हैं। सबसे पहले, सर्विस वर्कर में अपना ऐप इनिशियलाइज़ करें:

वेब संस्करण 9

import { initializeApp } from "firebase/app";
import { getMessaging } from "firebase/messaging/sw";

// Initialize the Firebase app in the service worker by passing in
// your app's Firebase config object.
// https://firebase.google.com/docs/web/setup#config-object
const firebaseApp = initializeApp({
  apiKey: 'api-key',
  authDomain: 'project-id.firebaseapp.com',
  databaseURL: 'https://project-id.firebaseio.com',
  projectId: 'project-id',
  storageBucket: 'project-id.appspot.com',
  messagingSenderId: 'sender-id',
  appId: 'app-id',
  measurementId: 'G-measurement-id',
});

// Retrieve an instance of Firebase Messaging so that it can handle background
// messages.
const messaging = getMessaging(firebaseApp);

वेब संस्करण 8

// Give the service worker access to Firebase Messaging.
// Note that you can only use Firebase Messaging here. Other Firebase libraries
// are not available in the service worker.
importScripts('https://www.gstatic.com/firebasejs/8.10.0/firebase-app.js');
importScripts('https://www.gstatic.com/firebasejs/8.10.0/firebase-messaging.js');

// Initialize the Firebase app in the service worker by passing in
// your app's Firebase config object.
// https://firebase.google.com/docs/web/setup#config-object
firebase.initializeApp({
  apiKey: 'api-key',
  authDomain: 'project-id.firebaseapp.com',
  databaseURL: 'https://project-id.firebaseio.com',
  projectId: 'project-id',
  storageBucket: 'project-id.appspot.com',
  messagingSenderId: 'sender-id',
  appId: 'app-id',
  measurementId: 'G-measurement-id',
});

// Retrieve an instance of Firebase Messaging so that it can handle background
// messages.
const messaging = firebase.messaging();

सेट विकल्प, कॉल करने के लिए onBackgroundMessage में firebase-messaging-sw.js । इस उदाहरण में, हम शीर्षक, मुख्य भाग और आइकन फ़ील्ड के साथ एक सूचना बनाते हैं।

वेब संस्करण 9

import { getMessaging } from "firebase/messaging";
import { onBackgroundMessage } from "firebase/messaging/sw";

const messaging = getMessaging();
onBackgroundMessage(messaging, (payload) => {
  console.log('[firebase-messaging-sw.js] Received background message ', payload);
  // Customize notification here
  const notificationTitle = 'Background Message Title';
  const notificationOptions = {
    body: 'Background Message body.',
    icon: '/firebase-logo.png'
  };

  self.registration.showNotification(notificationTitle,
    notificationOptions);
});

वेब संस्करण 8

messaging.onBackgroundMessage((payload) => {
  console.log('[firebase-messaging-sw.js] Received background message ', payload);
  // Customize notification here
  const notificationTitle = 'Background Message Title';
  const notificationOptions = {
    body: 'Background Message body.',
    icon: '/firebase-logo.png'
  };

  self.registration.showNotification(notificationTitle,
    notificationOptions);
});

सूचनाओं के लिए सर्वोत्तम अभ्यास

आप वेब के लिए पुश संदेश के साथ परिचित हैं, तो आप पहले से ही हो सकता है के लिए व्यापक दिशा निर्देश पढ़ें क्या एक अच्छा अधिसूचना बनाता है । वेब के लिए FCM के माध्यम से सूचनाएं भेजने वाले डेवलपर्स के लिए, सबसे महत्वपूर्ण विचार सटीकता और प्रासंगिकता हैं। आपकी सूचनाओं को सटीक और प्रासंगिक बनाए रखने के लिए यहां कुछ विशिष्ट अनुशंसाएं दी गई हैं:

  • अर्थपूर्ण छवि भेजने के लिए आइकन फ़ील्ड का उपयोग करें। कई उपयोग मामलों के लिए, यह एक कंपनी या ऐप लोगो होना चाहिए जिसे आपके उपयोगकर्ता तुरंत पहचान लें। या, चैट एप्लिकेशन के लिए, यह भेजने वाले उपयोगकर्ता की प्रोफ़ाइल छवि हो सकती है।
  • संदेश की सटीक प्रकृति को व्यक्त करने के लिए शीर्षक फ़ील्ड का उपयोग करें। उदाहरण के लिए, "जिमी ने उत्तर दिया" "नए संदेश" की तुलना में अधिक सटीक जानकारी देता है। अपनी कंपनी या ऐप के नाम के लिए इस मूल्यवान स्थान का उपयोग न करें — उस उद्देश्य के लिए आइकन का उपयोग करें।
  • अपनी वेबसाइट का नाम या डोमेन प्रदर्शित करने के लिए अधिसूचना शीर्षक या मुख्य भाग का उपयोग न करें; सूचनाओं में पहले से ही आपका डोमेन नाम है।
  • जोड़े fcm_options.link , आम तौर पर अपने वेब ऐप्लिकेशन पर उपयोगकर्ता वापस लिंक और ब्राउज़र में ध्यान में लाने के लिए। दुर्लभ मामलों में जहां आपको जो भी जानकारी देने की आवश्यकता है वह अधिसूचना में फिट हो सकती है, आपको लिंक की आवश्यकता नहीं हो सकती है।