chrome.readingList

ब्यौरा

रीडिंग लिस्ट में मौजूद आइटम को पढ़ने और उनमें बदलाव करने के लिए, chrome.readingList API का इस्तेमाल करें.

अनुमतियां

readingList

Reading List API का इस्तेमाल करने के लिए, एक्सटेंशन मेनिफ़ेस्ट फ़ाइल में "readingList" की अनुमति जोड़ें:

manifest.json:

{
  "name": "My reading list extension",
  ...
  "permissions": [
    "readingList"
  ]
}

उपलब्धता

Chrome 120 और उसके बाद वाले वर्शन संगीत वीडियो 3+

Chrome के साइड पैनल में एक रीडिंग लिस्ट दी जाती है. यह उपयोगकर्ताओं को वेब पेजों को सेव करने देता है, ताकि वे बाद में या ऑफ़लाइन होने पर भी उन्हें पढ़ सकें. मौजूदा आइटम वापस पाने और सूची में आइटम जोड़ने या हटाने के लिए, Reading List API का इस्तेमाल करें.

कई लेखों की रीडिंग लिस्ट
कई लेखों की रीडिंग लिस्ट

सिद्धांत और उनका इस्तेमाल

सामान ऑर्डर करना

रीडिंग लिस्ट में मौजूद आइटम, गारंटी के साथ किसी भी क्रम में नहीं हैं.

आइटम की खासियत

आइटम को यूआरएल की मदद से सेट किया जाता है. इसमें हैश और क्वेरी स्ट्रिंग शामिल हैं.

उपयोग के उदाहरण

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

आइटम जोड़ें

रीडिंग लिस्ट में किसी आइटम को जोड़ने के लिए, chrome.readingList.addEntry() का इस्तेमाल करें:

chrome.readingList.addEntry({
  title: "New to the web platform in September | web.dev",
  url: "https://developer.chrome.com/",
  hasBeenRead: false
});

आइटम दिखाएं

रीडिंग लिस्ट में मौजूद आइटम दिखाने के लिए, chrome.readingList.query() तरीके का इस्तेमाल करके उन्हें वापस लाएं. तरीका.

const items = await chrome.readingList.query({});

for (const item of items) {
  // Do something do display the item
}

किसी आइटम पर 'पढ़ा गया' का निशान लगाना

टाइटल, यूआरएल, और रीड स्टेटस को अपडेट करने के लिए, chrome.readingList.updateEntry() का इस्तेमाल किया जा सकता है. यह कोड, किसी आइटम को 'पढ़ा गया' के तौर पर मार्क करता है:

chrome.readingList.updateEntry({
  url: "https://developer.chrome.com/",
  hasBeenRead: true
});

कोई आइटम हटाना

किसी आइटम को हटाने के लिए, chrome.readingList.removeEntry() का इस्तेमाल करें:

chrome.readingList.removeEntry({
  url: "https://developer.chrome.com/"
});

एक्सटेंशन के सैंपल

Reading List API एक्सटेंशन के ज़्यादा डेमो देखने के लिए, Reading List API का सैंपल देखें.

टाइप

AddEntryOptions

प्रॉपर्टी

  • hasBeenRead

    बूलियन

    अगर एंट्री पढ़ ली गई है, तो true होगा.

  • title

    स्ट्रिंग

    एंट्री का टाइटल.

  • url

    स्ट्रिंग

    एंट्री का यूआरएल.

QueryInfo

प्रॉपर्टी

  • hasBeenRead

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

    यह बताता है कि पढ़े गए (true) या नहीं पढ़े गए (false) आइटम खोजने हैं या नहीं.

  • title

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

    खोजा जाने वाला टाइटल.

  • url

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

    खोजने के लिए यूआरएल.

ReadingListEntry

प्रॉपर्टी

  • creationTime

    संख्या

    एंट्री बनाने का समय. 1 जनवरी, 1970 से मिलीसेकंड में रिकॉर्ड किया गया.

  • hasBeenRead

    बूलियन

    अगर एंट्री पढ़ ली गई है, तो true होगा.

  • lastUpdateTime

    संख्या

    वह तारीख जब एंट्री को पिछली बार अपडेट किया गया था. यह वैल्यू 1 जनवरी, 1970 से मिलीसेकंड में है.

  • title

    स्ट्रिंग

    एंट्री का टाइटल.

  • url

    स्ट्रिंग

    एंट्री का यूआरएल.

RemoveOptions

प्रॉपर्टी

  • url

    स्ट्रिंग

    हटाया जाने वाला यूआरएल.

UpdateEntryOptions

प्रॉपर्टी

  • hasBeenRead

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

    रीड स्टेटस अपडेट किया गया. अगर कोई वैल्यू नहीं दी जाती है, तो मौजूदा स्थिति बनी रहती है.

  • title

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

    नया टाइटल. वैल्यू न दिए जाने पर, मौजूदा टाइल दिखती है.

  • url

    स्ट्रिंग

    अपडेट किया जाने वाला यूआरएल.

तरीके

addEntry()

प्रॉमिस 
chrome.readingList.addEntry(
  entry: AddEntryOptions,
  callback?: function,
)

रीडिंग लिस्ट में कोई एंट्री मौजूद न होने पर, उसमें एंट्री जोड़ दी जाती है.

पैरामीटर

  • एंट्री

    AddEntryOptions

    रीडिंग लिस्ट में जोड़ने के लिए एंट्री.

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

query()

प्रॉमिस 
chrome.readingList.query(
  info: QueryInfo,
  callback?: function,
)

QueryInfo प्रॉपर्टी से मेल खाने वाली सभी एंट्री हासिल करता है. आपने जो प्रॉपर्टी नहीं दी हैं उनका मिलान नहीं किया जाएगा.

पैरामीटर

  • जानकारी

    QueryInfo

    खोजी जाने वाली प्रॉपर्टी.

  • कॉलबैक

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

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

    (entries: ReadingListEntry[]) => void

रिटर्न

  • Promise&lt;ReadingListEntry[]&gt;

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

removeEntry()

प्रॉमिस 
chrome.readingList.removeEntry(
  info: RemoveOptions,
  callback?: function,
)

रीडिंग लिस्ट से कोई एंट्री मौजूद होने पर, उसे हटा देता है.

पैरामीटर

  • जानकारी

    RemoveOptions

    रीडिंग लिस्ट से हटाई जाने वाली एंट्री.

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

updateEntry()

प्रॉमिस 
chrome.readingList.updateEntry(
  info: UpdateEntryOptions,
  callback?: function,
)

रीडिंग लिस्ट के मौजूद होने पर, उसे अपडेट करता है.

पैरामीटर

  • जानकारी

    UpdateEntryOptions

    अपडेट की जाने वाली एंट्री.

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

इवेंट

onEntryAdded

chrome.readingList.onEntryAdded.addListener(
  callback: function,
)

तब ट्रिगर होता है, जब ReadingListEntry को रीडिंग लिस्ट में जोड़ा जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (entry: ReadingListEntry) => void

onEntryRemoved

chrome.readingList.onEntryRemoved.addListener(
  callback: function,
)

यह तब ट्रिगर होता है, जब ReadingListEntry को रीडिंग लिस्ट से हटा दिया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (entry: ReadingListEntry) => void

onEntryUpdated

chrome.readingList.onEntryUpdated.addListener(
  callback: function,
)

यह तब ट्रिगर होता है, जब रीडिंग लिस्ट में ReadingListEntry अपडेट किया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (entry: ReadingListEntry) => void