chrome.notifications

refresh date: 2026-09-25 robots: noindex

ब्यौरा

टेंप्लेट का इस्तेमाल करके बेहतर सूचनाएं बनाने के लिए, chrome.notifications एपीआई का इस्तेमाल करें. साथ ही, इन सूचनाओं को सिस्टम ट्रे में उपयोगकर्ताओं को दिखाएं.

अनुमतियां

notifications

टाइप

NotificationBitmap

NotificationButton

प्रॉपर्टी

  • iconUrl

    string ज़रूरी नहीं है

    Chrome 59 से बंद कर दिया गया है

    Mac OS X का इस्तेमाल करने वाले लोगों को बटन के आइकॉन नहीं दिखते.

  • title

    स्ट्रिंग

NotificationItem

प्रॉपर्टी

  • मैसेज

    स्ट्रिंग

    इस आइटम के बारे में ज़्यादा जानकारी.

  • title

    स्ट्रिंग

    सूची वाली सूचना के किसी आइटम का टाइटल.

NotificationOptions

प्रॉपर्टी

  • appIconMaskUrl

    string ज़रूरी नहीं है

    Chrome 59 से बंद कर दिया गया है

    Mac OS X का इस्तेमाल करने वाले लोगों को ऐप्लिकेशन का आइकॉन मास्क नहीं दिखता.

    ऐप्लिकेशन के आइकॉन के मास्क का यूआरएल. यूआरएल पर वही पाबंदियां लागू होती हैं जो iconUrl पर लागू होती हैं.

    ऐप्लिकेशन के आइकॉन का मास्क, ऐल्फ़ा चैनल में होना चाहिए. ऐसा इसलिए, क्योंकि इमेज के सिर्फ़ ऐल्फ़ा चैनल को ही माना जाएगा.

  • बटन

    NotificationButton[] optional

    सूचना पर कार्रवाई करने वाले ज़्यादा से ज़्यादा दो बटन के लिए टेक्स्ट और आइकॉन.

  • contextMessage

    string ज़रूरी नहीं है

    सूचना के कॉन्टेंट को कम वेट वाले फ़ॉन्ट में दिखाया गया है.

  • eventTime

    number optional

    सूचना से जुड़ा टाइमस्टैंप.यह टाइमस्टैंप, epoch के बाद के मिलीसेकंड में होता है. उदाहरण के लिए, Date.now() + n.

  • iconUrl

    string ज़रूरी नहीं है

    भेजने वाले के अवतार, ऐप्लिकेशन के आइकॉन या इमेज सूचनाओं के थंबनेल का यूआरएल.

    यूआरएल, डेटा यूआरएल, ब्लोब यूआरएल या इस एक्सटेंशन की .crx फ़ाइल में मौजूद किसी संसाधन से जुड़ा यूआरएल हो सकता है

    **ध्यान दें:**notifications.create() तरीके के लिए, यह वैल्यू डालना ज़रूरी है.

  • imageUrl

    string ज़रूरी नहीं है

    Chrome 59 से बंद कर दिया गया है

    Mac OS X का इस्तेमाल करने वाले लोगों को इमेज नहीं दिखती.

    इमेज टाइप की सूचनाओं के लिए, इमेज थंबनेल का यूआरएल. यूआरएल पर वही पाबंदियां लागू होती हैं जो iconUrl पर लागू होती हैं.

  • isClickable

    boolean ज़रूरी नहीं है

    Chrome 67 से बंद कर दिया गया है

    Chrome 67 से इस यूज़र इंटरफ़ेस (यूआई) के हिंट को अनदेखा कर दिया जाता है

  • आइटम

    NotificationItem[] optional

    एक से ज़्यादा आइटम के लिए सूचनाएं. Mac OS X का इस्तेमाल करने वाले लोगों को सिर्फ़ पहला आइटम दिखता है.

  • मैसेज

    string ज़रूरी नहीं है

    सूचना का मुख्य कॉन्टेंट.

    **ध्यान दें:**notifications.create() तरीके के लिए, यह वैल्यू डालना ज़रूरी है.

  • प्राथमिकता

    number optional

    प्राथमिकता की वैल्यू -2 से 2 तक होती है. -2 सबसे कम प्राथमिकता है. 2 सबसे ज़्यादा है. डिफ़ॉल्ट वैल्यू शून्य होती है. जिन प्लैटफ़ॉर्म पर सूचना केंद्र की सुविधा उपलब्ध नहीं है (Windows, Linux, और Mac), वहां -2 और -1 की प्राथमिकता वाली सूचनाएं नहीं दिखेंगी. इसलिए, इन प्लैटफ़ॉर्म पर -2 और -1 की प्राथमिकता वाली सूचनाएं भेजने पर गड़बड़ी का मैसेज दिखेगा.

  • प्रोग्रेस

    number optional

    मौजूदा प्रोग्रेस 0 से 100 तक होती है.

  • requireInteraction

    boolean ज़रूरी नहीं है

    Chrome 50+

    इससे पता चलता है कि सूचना को तब तक स्क्रीन पर दिखना चाहिए, जब तक उपयोगकर्ता उसे चालू या खारिज नहीं कर देता. डिफ़ॉल्ट रूप से, इसकी वैल्यू false पर सेट होती है.

  • साइलेंट

    boolean ज़रूरी नहीं है

    Chrome 70 या इसके बाद का वर्शन

    इससे पता चलता है कि सूचना दिखाए जाने पर, कोई आवाज़ या वाइब्रेशन नहीं होना चाहिए. डिफ़ॉल्ट रूप से, इसकी वैल्यू false पर सेट होती है.

  • title

    string ज़रूरी नहीं है

    सूचना का टाइटल (जैसे, ईमेल भेजने वाले का नाम).

    **ध्यान दें:**notifications.create() तरीके के लिए, यह वैल्यू डालना ज़रूरी है.

  • टाइप

    TemplateType ज़रूरी नहीं है

    किस तरह की सूचना दिखानी है. notifications.create तरीके के लिए ज़रूरी है.

PermissionLevel

Enum

"granted"
इससे पता चलता है कि उपयोगकर्ता ने ऐप्लिकेशन या एक्सटेंशन से सूचनाएं पाने का विकल्प चुना है. यह इंस्टॉल करने के समय डिफ़ॉल्ट रूप से चालू होता है.

"denied"
इससे पता चलता है कि उपयोगकर्ता ने ऐप्लिकेशन या एक्सटेंशन से सूचनाएं न दिखाने का विकल्प चुना है.

TemplateType

Enum

"basic"
इसमें एक आइकॉन, टाइटल, मैसेज, expandedMessage, और ज़्यादा से ज़्यादा दो बटन होते हैं.

"image"
इसमें आइकॉन, टाइटल, मैसेज, expandedMessage, इमेज, और ज़्यादा से ज़्यादा दो बटन होते हैं.

"सूची"
इसमें एक आइकॉन, टाइटल, मैसेज, आइटम, और ज़्यादा से ज़्यादा दो बटन होते हैं. Mac OS X का इस्तेमाल करने वाले लोगों को सिर्फ़ पहला आइटम दिखता है.

"progress"
इसमें आइकॉन, टाइटल, मैसेज, प्रोग्रेस, और ज़्यादा से ज़्यादा दो बटन होते हैं.

तरीके

clear()

Promise 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
): Promise<boolean>

इससे चुनी गई सूचना को खारिज किया जा सकता है.

पैरामीटर

  • notificationId

    स्ट्रिंग

    जिस सूचना को हटाना है उसका आईडी. यह notifications.create तरीके से मिलता है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    callback पैरामीटर ऐसा दिखता है: 

    (wasCleared: boolean) => void

    • wasCleared

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 116 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है. इससे यह पता चलता है कि मिलती-जुलती सूचना मौजूद थी या नहीं.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

create()

Promise 
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
): Promise<string>

यह कुकी, सूचना बनाती है और उसे दिखाती है.

पैरामीटर

  • notificationId

    string ज़रूरी नहीं है

    सूचना का आइडेंटिफ़ायर. अगर इसे सेट नहीं किया गया है या यह खाली है, तो आईडी अपने-आप जनरेट हो जाएगा. अगर यह किसी मौजूदा सूचना से मेल खाती है, तो यह तरीका सूचना बनाने की प्रोसेस शुरू करने से पहले, उस सूचना को मिटा देता है. पहचानकर्ता में 500 से ज़्यादा वर्ण नहीं हो सकते.

    Chrome 42 से पहले, notificationId पैरामीटर ज़रूरी है.

  • विकल्प

    NotificationOptions

    सूचना का कॉन्टेंट.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    callback पैरामीटर ऐसा दिखता है: 

    (notificationId: string) => void

    • notificationId

      स्ट्रिंग

रिटर्न

  • Promise<string>

    Chrome 116 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है. यह प्रॉमिस, सूचना के आईडी (सप्लाई किया गया या जनरेट किया गया) के साथ रिज़ॉल्व होता है. यह आईडी, बनाई गई सूचना को दिखाता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

getAll()

Promise 
chrome.notifications.getAll(
  callback?: function,
): Promise<object>

यह ऐप्लिकेशन या एक्सटेंशन की सभी सूचनाएं वापस लाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    callback पैरामीटर ऐसा दिखता है: 

    (notifications: object) => void

    • नोटिफ़िकेशन

      ऑब्जेक्ट

रिटर्न

  • Promise<object>

    Chrome 116 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है. यह प्रॉमिस, सिस्टम में मौजूद notification_ids के सेट के साथ रिज़ॉल्व होता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

getPermissionLevel()

Promise 
chrome.notifications.getPermissionLevel(
  callback?: function,
): Promise<PermissionLevel>

यह कुकी इस बात की जानकारी देती है कि उपयोगकर्ता ने इस ऐप्लिकेशन या एक्सटेंशन से सूचनाएं पाने की सुविधा चालू की है या नहीं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    callback पैरामीटर ऐसा दिखता है: 

    (level: PermissionLevel) => void

रिटर्न

  • Promise<PermissionLevel>

    Chrome 116 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है, जो अनुमति के मौजूदा लेवल के साथ रिज़ॉल्व होता है.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

update()

Promise 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
): Promise<boolean>

यह मौजूदा सूचना को अपडेट करता है.

पैरामीटर

  • notificationId

    स्ट्रिंग

    अपडेट की जाने वाली सूचना का आईडी. यह notifications.create तरीके से मिलता है.

  • विकल्प

    NotificationOptions

    सूचना का वह कॉन्टेंट जिसे अपडेट करना है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं है

    callback पैरामीटर ऐसा दिखता है: 

    (wasUpdated: boolean) => void

    • wasUpdated

      बूलियन

रिटर्न

  • Promise<boolean>

    Chrome 116 और इसके बाद के वर्शन

    यह एक प्रॉमिस दिखाता है. इससे यह पता चलता है कि मिलती-जुलती सूचना मौजूद थी या नहीं.

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म को कॉलबैक का इस्तेमाल करना होगा.

इवेंट

onButtonClicked

chrome.notifications.onButtonClicked.addListener(
  callback: function,
)

उपयोगकर्ता ने सूचना में मौजूद किसी बटन को दबाया हो.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (notificationId: string, buttonIndex: number) => void

    • notificationId

      स्ट्रिंग

    • buttonIndex

      संख्या

onClicked

chrome.notifications.onClicked.addListener(
  callback: function,
)

उपयोगकर्ता ने सूचना के बटन वाले हिस्से के बाहर क्लिक किया.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (notificationId: string) => void

    • notificationId

      स्ट्रिंग

onClosed

chrome.notifications.onClosed.addListener(
  callback: function,
)

सूचना को सिस्टम या उपयोगकर्ता की कार्रवाई से बंद कर दिया गया है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (notificationId: string, byUser: boolean) => void

    • notificationId

      स्ट्रिंग

    • byUser

      बूलियन

onPermissionLevelChanged

chrome.notifications.onPermissionLevelChanged.addListener(
  callback: function,
)

उपयोगकर्ता, अनुमति का लेवल बदलता है. Chrome 47 के मुताबिक, सिर्फ़ ChromeOS में ऐसा यूज़र इंटरफ़ेस (यूआई) है जो इस इवेंट को डिसपैच करता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (level: PermissionLevel) => void

onShowSettings

Chrome 65 से बंद कर दिया गया है
chrome.notifications.onShowSettings.addListener(
  callback: function,
)

सूचना सेटिंग को पसंद के मुताबिक बनाने की सुविधा अब उपलब्ध नहीं है.

उपयोगकर्ता ने ऐप्लिकेशन की सूचना सेटिंग के लिंक पर क्लिक किया. Chrome 47 के मुताबिक, सिर्फ़ ChromeOS में ऐसा यूज़र इंटरफ़ेस (यूआई) है जो इस इवेंट को डिसपैच करता है. Chrome के वर्शन 65 से, उस यूज़र इंटरफ़ेस (यूआई) को ChromeOS से भी हटा दिया गया है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    () => void