Storage Area

رابط StorageArea توسط API chrome.storage استفاده می‌شود.

روش‌ها

clear()

chrome.storage.StorageArea.clear(): Promise<void>

همه موارد را از انبار خارج می‌کند.

بازگشت‌ها

  • قول<void>

    کروم ۹۵+

    وعده‌ای که با موفقیت قطعی می‌شود، یا با شکست رد می‌شود.

get()

chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
)
: Promise<object>

یک یا چند مورد را از انبار دریافت می‌کند.

پارامترها

  • کلیدها

    رشته | رشته[] | شیء اختیاری

    یک کلید واحد برای دریافت، لیستی از کلیدها برای دریافت، یا یک دیکشنری که مقادیر پیش‌فرض را مشخص می‌کند (به توضیحات شیء مراجعه کنید). یک لیست یا شیء خالی، یک شیء نتیجه خالی را برمی‌گرداند. برای دریافت کل محتوای ذخیره‌سازی، مقدار null را وارد کنید.

بازگشت‌ها

  • قول دادن<object>

    کروم ۹۵+

    وعده‌ای که با یک شیء حاوی نگاشت کلید-مقدار برای موارد درخواستی حل می‌شود، یا در صورت عدم موفقیت رد می‌شود.

getBytesInUse()

chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
)
: Promise<number>

مقدار فضایی (بر حسب بایت) که توسط یک یا چند آیتم استفاده می‌شود را برمی‌گرداند.

پارامترها

  • کلیدها

    رشته | رشته[] اختیاری

    یک کلید یا لیستی از کلیدها برای دریافت کل استفاده. یک لیست خالی 0 را برمی‌گرداند. برای دریافت کل استفاده از کل فضای ذخیره‌سازی، null را وارد کنید.

بازگشت‌ها

  • قول<number>

    کروم ۹۵+

    وعده‌ای که با میزان فضای استفاده شده توسط ذخیره‌سازی حل می‌شود، یا در صورت عدم موفقیت رد می‌شود.

getKeys()

کروم ۱۳۰+
chrome.storage.StorageArea.getKeys(): Promise<string[]>

تمام کلیدها را از حافظه می‌گیرد.

بازگشت‌ها

  • قول <string[]>

    وعده‌ای که با کلیدهای ذخیره‌سازی حل می‌شود، یا در صورت عدم موفقیت رد می‌شود.

remove()

chrome.storage.StorageArea.remove(
  keys: string | string[],
)
: Promise<void>

یک یا چند مورد را از انبار حذف می‌کند.

پارامترها

  • کلیدها

    رشته | رشته[]

    یک کلید یا فهرستی از کلیدها برای حذف موارد.

بازگشت‌ها

  • قول<void>

    کروم ۹۵+

    وعده‌ای که با موفقیت قطعی می‌شود، یا با شکست رد می‌شود.

set()

chrome.storage.StorageArea.set(
  items: object,
)
: Promise<void>

چندین مورد را تنظیم می‌کند.

پارامترها

  • اقلام

    شیء

    شیء‌ای که هر جفت کلید/مقدار را برای به‌روزرسانی فضای ذخیره‌سازی ارائه می‌دهد. سایر جفت‌های کلید/مقدار موجود در فضای ذخیره‌سازی تحت تأثیر قرار نخواهند گرفت.

    مقادیر اولیه مانند اعداد طبق انتظار سریالی می‌شوند. مقادیری که typeof "object" و "function" دارند معمولاً به {} سریالی می‌شوند، به استثنای Array (طبق انتظار سریالی می‌شود)، Date و Regex (با استفاده از نمایش String خود سریالی می‌شوند).

بازگشت‌ها

  • قول<void>

    کروم ۹۵+

    وعده‌ای که با موفقیت قطعی می‌شود، یا با شکست رد می‌شود.

setAccessLevel()

کروم ۱۰۲+
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
)
: Promise<void>

سطح دسترسی مورد نظر را برای ناحیه ذخیره‌سازی تنظیم می‌کند. به طور پیش‌فرض، ذخیره‌سازی session به زمینه‌های قابل اعتماد (صفحات افزونه و سرویس ورکرها) محدود می‌شود، در حالی که ذخیره‌سازی managed ، local و sync امکان دسترسی از هر دو زمینه قابل اعتماد و غیر قابل اعتماد را فراهم می‌کند.

پارامترها

  • گزینه‌های دسترسی

    شیء

    • سطح دسترسی

      سطح دسترسی به فضای ذخیره‌سازی

بازگشت‌ها

  • قول<void>

    وعده‌ای که با موفقیت قطعی می‌شود، یا با شکست رد می‌شود.

رویدادها

onChanged

کروم ۷۳+
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

وقتی یک یا چند مورد تغییر کنند، اجرا می‌شود.

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است:

    (changes: object) => void

    • تغییرات

      شیء