StorageArea

refresh date: 2026-09-25 robots: noindex

تستخدم واجهة برمجة التطبيقات chrome.storage واجهة StorageArea.

الطُرق

clear()

Promise 
chrome.storage.StorageArea.clear(
  callback?: function,
): Promise<void>

تؤدي هذه الطريقة إلى إزالة جميع العناصر من مساحة التخزين.

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 95 من Chrome أو الإصدارات الأحدث

    وعد يتم الوفاء به في حال النجاح، أو رفضه في حال الفشل.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

get()

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

للحصول على عنصر واحد أو أكثر من مساحة التخزين

المعلمات

  • مفاتيح

    string | string[] | object اختيارية

    مفتاح واحد للحصول على قائمة بالمفاتيح أو قاموس يحدّد القيم التلقائية (راجِع وصف العنصر). ستؤدي القائمة أو العنصر الفارغ إلى عرض عنصر نتيجة فارغ. مرِّر null للحصول على محتوى مساحة التخزين بالكامل.

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (items: object) => void

    • items

      عنصر

      عنصر يتضمّن عناصر في عمليات ربط المفتاح بالقيمة

المرتجعات

  • وعد<كائن>

    الإصدار 95 من Chrome أو الإصدارات الأحدث

    وعد يتم حله باستخدام كائن يحتوي على خريطة مفتاح-قيمة للعناصر المطلوبة، أو يتم رفضه في حال تعذّر ذلك.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getBytesInUse()

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

للحصول على مقدار المساحة (بالبايت) التي يستخدمها عنصر واحد أو أكثر

المعلمات

  • مفاتيح

    string | string[] اختيارية

    مفتاح واحد أو قائمة مفاتيح للحصول على إجمالي الاستخدام. وستعرض القائمة الفارغة القيمة 0. مرِّر null للحصول على إجمالي استخدام مساحة التخزين بالكامل.

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (bytesInUse: number) => void

    • bytesInUse

      الرقم

      مقدار المساحة المستخدَمة في التخزين، بالبايت

المرتجعات

  • <number>

    الإصدار 95 من Chrome أو الإصدارات الأحدث

    وعد يتم حله باستخدام مقدار المساحة التي تستخدمها مساحة التخزين، أو يتم رفضه في حال تعذّر ذلك.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getKeys()

Promise الإصدار 130 من Chrome والإصدارات الأحدث 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

للحصول على جميع المفاتيح من مساحة التخزين

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (keys: string[]) => void

    • مفاتيح

      string[]

      مصفوفة تحتوي على مفاتيح تمت قراءتها من مساحة التخزين

المرتجعات

  • وعد<سلسلة نصية[]>

    وعد يتم حله باستخدام مفاتيح التخزين أو رفضه في حال تعذّر ذلك

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

remove()

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

لإزالة عنصر واحد أو أكثر من مساحة التخزين

المعلمات

  • مفاتيح

    string | string[]

    مفتاح واحد أو قائمة مفاتيح للعناصر المطلوب إزالتها

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 95 من Chrome أو الإصدارات الأحدث

    وعد يتم الوفاء به في حال النجاح، أو رفضه في حال الفشل.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

set()

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

لضبط عناصر متعددة

المعلمات

  • items

    عنصر

    عنصر يوفّر كل زوج من المفاتيح والقيم لتعديل مساحة التخزين به ولن تتأثر أي أزواج مفاتيح/قيم أخرى في مساحة التخزين.

    سيتم تسلسل القيم الأساسية، مثل الأرقام، على النحو المتوقّع. typeof "object" and "function" values will typically serialize to {}, with the exception of Array (serializes as expected), Date, and Regex (serialize using their String representation).

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 95 من Chrome أو الإصدارات الأحدث

    وعد يتم الوفاء به في حال النجاح، أو رفضه في حال الفشل.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

setAccessLevel()

Promise الإصدار 102 من Chrome والإصدارات الأحدث 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

يحدّد مستوى الوصول المطلوب إلى مساحة التخزين. بشكل تلقائي، تقتصر مساحة التخزين session على السياقات الموثوق بها (صفحات الإضافات ومشغّلي الخدمات)، بينما تتيح مساحات التخزين managed وlocal وsync الوصول من السياقات الموثوق بها وغير الموثوق بها.

المعلمات

  • accessOptions

    عنصر

    • accessLevel

      AccessLevel

      مستوى الوصول إلى مساحة التخزين

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    وعد يتم الوفاء به في حال النجاح، أو رفضه في حال الفشل.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الفعاليات

onChanged

الإصدار 73 من Chrome والإصدارات الأحدث 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

يتم تنشيطه عند تغيير عنصر واحد أو أكثر.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (changes: object) => void

    • التغييرات

      عنصر