chrome.notifications

ब्यौरा

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

अनुमतियां

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

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

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

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

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

  • imageUrl

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

    Chrome 59 के बाद से अब तक काम नहीं करता

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

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

  • isClickable

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

    Chrome 67 के बाद से अब तक काम नहीं करता

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

  • आइटम

    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

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

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

TemplateType

Enum

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

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

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

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

तरीके

clear()

प्रॉमिस 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
)

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

पैरामीटर

  • notificationId

    स्ट्रिंग

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

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (wasCleared: boolean) => void

    • wasCleared

      बूलियन

रिटर्न

  • 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&lt;object&gt;

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

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

getPermissionLevel()

प्रॉमिस 
chrome.notifications.getPermissionLevel(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (level: PermissionLevel) => void

रिटर्न

  • Promise&lt;PermissionLevel&gt;

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

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

update()

प्रॉमिस 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
)

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

पैरामीटर

  • notificationId

    स्ट्रिंग

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

  • विकल्प

    NotificationOptions

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

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (wasUpdated: boolean) => void

    • wasUpdated

      बूलियन

रिटर्न

  • Promise&lt;boolean&gt;

    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

      बूलियन

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