StorageArea

refresh date: 2026-09-25 robots: noindex

StorageArea arayüzü, chrome.storage API tarafından kullanılır.

Yöntemler

clear()

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

Depolama alanındaki tüm öğeleri kaldırır.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 95 ve sonraki sürümler

    Başarılı olduğunda çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

get()

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

Depolama alanından bir veya daha fazla öğe alır.

Parametreler

  • anahtarlar

    string | string[] | object isteğe bağlı

    Alınacak tek bir anahtar, alınacak anahtarların listesi veya varsayılan değerleri belirten bir sözlük (nesnenin açıklamasına bakın). Boş bir liste veya nesne, boş bir sonuç nesnesi döndürür. Depolama alanının tüm içeriğini almak için null değerini iletin.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (items: object) => void

    • items

      nesne

      Anahtar-değer eşlemelerinde öğeler içeren nesne.

İadeler

  • Promise<object>

    Chrome 95 ve sonraki sürümler

    İstenen öğeler için anahtar/değer eşlemesi içeren bir nesneyle çözümlenen veya başarısızlık durumunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getBytesInUse()

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

Bir veya daha fazla öğe tarafından kullanılan alan miktarını (bayt cinsinden) alır.

Parametreler

  • anahtarlar

    string | string[] isteğe bağlı

    Toplam kullanımını almak istediğiniz tek bir anahtar veya anahtar listesi. Boş bir liste 0 değerini döndürür. Tüm depolama alanının toplam kullanımını öğrenmek için null değerini iletin.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (bytesInUse: number) => void

    • bytesInUse

      sayı

      Depolama alanında kullanılan alan miktarı (bayt cinsinden).

İadeler

  • Promise<number>

    Chrome 95 ve sonraki sürümler

    Depolama alanı tarafından kullanılan alan miktarıyla çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getKeys()

Promise Chrome 130 ve sonraki sürümler 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Depolama alanındaki tüm anahtarları alır.

Parametreler

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (keys: string[]) => void

    • anahtarlar

      string[]

      Depolama alanından okunan anahtarları içeren dizi.

İadeler

  • Promise<string[]>

    Depolama anahtarlarıyla çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

remove()

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

Depolama alanından bir veya daha fazla öğeyi kaldırır.

Parametreler

  • anahtarlar

    string | string[]

    Kaldırılacak öğeler için tek bir anahtar veya anahtar listesi.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 95 ve sonraki sürümler

    Başarılı olduğunda çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

set()

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

Birden çok öğe ayarlar.

Parametreler

  • items

    nesne

    Depolama alanını güncellemek için her bir anahtar/değer çiftini veren nesne. Depolama alanındaki diğer anahtar/değer çiftleri etkilenmez.

    Sayılar gibi temel değerler beklendiği gibi serileştirilir. typeof "object" ve "function" içeren değerler genellikle {} olarak serileştirilir. Array (beklendiği gibi serileştirilir), Date ve Regex (String temsilleri kullanılarak serileştirilir) bu kuralın istisnalarıdır.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 95 ve sonraki sürümler

    Başarılı olduğunda çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setAccessLevel()

Promise Chrome 102+ 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

Depolama alanı için istenen erişim düzeyini ayarlar. Varsayılan olarak session depolama alanı güvenilir bağlamlarla (uzantı sayfaları ve hizmet çalışanları) kısıtlanmıştır. managed, local ve sync depolama alanları ise hem güvenilir hem de güvenilmeyen bağlamlardan erişime izin verir.

Parametreler

  • accessOptions

    nesne

    • accessLevel

      AccessLevel

      Depolama alanının erişim düzeyi.

  • callback

    function isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Başarılı olduğunda çözümlenen veya başarısız olduğunda reddedilen Promise.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onChanged

Chrome 73+ 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Bir veya daha fazla öğe değiştiğinde tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    (changes: object) => void

    • değişiklikler

      nesne