StorageArea

میانای StorageArea توسط میانای برنامه‌سازی کاربردی browser.storage استفاده می‌شود.

روش‌ها

clear()

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

همه موارد را از فضای ذخیره‌سازی برمی‌دارد.

بازگشتی‌ها

• Promise<void>

  Chrome نسخه ۹۵ و بالاتر browser.* از Chrome نسخه ۱۴۸

  Promise که درصورت موفقیت حل می‌شود یا درصورت شکست رد می‌شود.

get()

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

یک یا چند مورد را از فضای ذخیره‌سازی دریافت می‌کند.

پارامترها

• کلید

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

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

بازگشتی‌ها

• Promise<object>

  Chrome نسخه ۹۵ و بالاتر browser.* از Chrome نسخه ۱۴۸

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

getBytesInUse()

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

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

پارامترها

• کلید

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

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

بازگشتی‌ها

• Promise<number>

  Chrome نسخه ۹۵ و بالاتر browser.* از Chrome نسخه ۱۴۸

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

getKeys()

Chrome نسخه ۱۳۰ و بالاتر browser.* از Chrome نسخه ۱۴۸

browser.storage.StorageArea.getKeys(): Promise<string[]>

همه کلیدها را از فضای ذخیره‌سازی دریافت می‌کند.

بازگشتی‌ها

• Promise<string[]>

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

remove()

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

یک یا چند مورد را از فضای ذخیره‌سازی برمی‌دارد.

پارامترها

• کلید

  رشته | رشته[]

  یک کلید یا فهرستی از کلیدها برای مواردی که باید برداشته شوند.

بازگشتی‌ها

• Promise<void>

  Chrome نسخه ۹۵ و بالاتر browser.* از Chrome نسخه ۱۴۸

  Promise که درصورت موفقیت حل می‌شود یا درصورت شکست رد می‌شود.

set()

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

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

پارامترها

• موارد

  شیء

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

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

بازگشتی‌ها

• Promise<void>

  Chrome نسخه ۹۵ و بالاتر browser.* از Chrome نسخه ۱۴۸

  Promise که درصورت موفقیت حل می‌شود یا درصورت شکست رد می‌شود.

setAccessLevel()

Chrome نسخه ۱۰۲ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

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

پارامترها

• accessOptions

  شیء

  • accessLevel

    AccessLevel

    سطح دسترسی به محوطه انبار.

بازگشتی‌ها

• Promise<void>

  Promise که درصورت موفقیت حل می‌شود یا درصورت شکست رد می‌شود.

رویدادها

onChanged

Chrome 73+ browser.* از Chrome 148

browser.storage.StorageArea.onChanged.addListener(
  callback: function,
)

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

پارامترها

• تماس برگشتی

  عملکرد

  پارامتر callback به‌صورت زیر است:

  (changes: object) => void

  • تغییرات

    شیء