chrome.notifications

ब्यौरा

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

अनुमतियां

notifications

टाइप

NotificationBitmap

NotificationButton

प्रॉपर्टी

  • iconUrl

    स्ट्रिंग ज़रूरी नहीं

    Chrome 59 के बाद से अब सेवा में नहीं है

    बटन आइकॉन, Mac OS X उपयोगकर्ताओं को नहीं दिखते.

  • title

    स्ट्रिंग

NotificationItem

प्रॉपर्टी

  • ग्राहक का मैसेज

    स्ट्रिंग

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

  • title

    स्ट्रिंग

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

NotificationOptions

प्रॉपर्टी

  • appIconMaskUrl

    स्ट्रिंग ज़रूरी नहीं

    Chrome 59 के बाद से अब सेवा में नहीं है

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

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

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

  • बटन

    NotificationButton[] ज़रूरी नहीं है

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

  • contextMessage

    स्ट्रिंग ज़रूरी नहीं

    कम वज़न वाले फ़ॉन्ट वाली वैकल्पिक सूचना कॉन्टेंट.

  • eventTime

    नंबर ज़रूरी नहीं

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

  • iconUrl

    स्ट्रिंग ज़रूरी नहीं

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

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

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

  • imageUrl

    स्ट्रिंग ज़रूरी नहीं

    Chrome 59 के बाद से अब सेवा में नहीं है

    Mac OS X उपयोगकर्ताओं को इमेज नहीं दिखती है.

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

  • isClickable

    बूलियन ज़रूरी नहीं

    Chrome 67 के बाद से अब सेवा में नहीं है

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

  • items

    NotificationItem[] ज़रूरी नहीं है

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

  • ग्राहक का मैसेज

    स्ट्रिंग ज़रूरी नहीं

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

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

  • प्राथमिकता

    नंबर ज़रूरी नहीं

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

  • प्रोग्रेस

    नंबर ज़रूरी नहीं

    फ़िलहाल, यह 0 से 100 तक है.

  • requireInteraction

    बूलियन ज़रूरी नहीं

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

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

  • साइलेंट

    बूलियन ज़रूरी नहीं

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

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

  • title

    स्ट्रिंग ज़रूरी नहीं

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

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

  • टाइप

    TemplateType ज़रूरी नहीं

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

PermissionLevel

Enum

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

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

TemplateType

Enum

"बेसिक"
इसमें आइकॉन, टाइटल, मैसेज, बड़ा मैसेज, और दो बटन शामिल होते हैं.

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

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

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

तरीके

clear()

वादा 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
)

बताई गई सूचना को हटाता है.

पैरामीटर

  • notificationId

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (wasCleared: boolean)=>void

    • wasCleared

      boolean

रिटर्न

  • Promise<boolean>

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

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

create()

वादा 
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
)

सूचना बनाता है और उसे दिखाता है.

पैरामीटर

  • notificationId

    स्ट्रिंग ज़रूरी नहीं

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

    Chrome 42 से पहले के वर्शन में notificationId पैरामीटर ज़रूरी है.

  • विकल्प

    NotificationOptions

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

  • कॉलबैक

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

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

    (notificationId: string)=>void

    • notificationId

      स्ट्रिंग

रिटर्न

  • प्रॉमिस<string>

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

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

getAll()

वादा 
chrome.notifications.getAll(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

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

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

    (notifications: object)=>void

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

      ऑब्जेक्ट

रिटर्न

  • Promise<object>

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

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

getPermissionLevel()

वादा 
chrome.notifications.getPermissionLevel(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

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

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

    (level: PermissionLevel)=>void

रिटर्न

  • Promise<PermissionLevel>

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

    प्रॉमिस, मेनिफ़ेस्ट V3 और इसके बाद के वर्शन में काम करता है. हालांकि, पुराने सिस्टम के साथ काम करने के लिए कॉलबैक दिए जाते हैं. आप एक ही फ़ंक्शन कॉल पर दोनों का इस्तेमाल नहीं कर सकते. प्रॉमिस उसी टाइप के साथ रिज़ॉल्व हो जाती है जिसे कॉलबैक को पास किया जाता है.

update()

वादा 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
)

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

पैरामीटर

  • notificationId

    स्ट्रिंग

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

  • विकल्प

    NotificationOptions

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

  • कॉलबैक

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

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

    (wasUpdated: boolean)=>void

    • wasUpdated

      boolean

रिटर्न

  • Promise<boolean>

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

    प्रॉमिस, मेनिफ़ेस्ट 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

      boolean

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