StorageArea

refresh date: 2026-09-25 robots: noindex

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

Yöntemler

clear()

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

Tüm öğeler depolamadan kaldırılır.

Parametreler

  • callback

    işlev 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ı durumunda çözümlenen, başarısızlık durumunda ise reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

get()

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

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

Parametreler

  • anahtarlar

    dize | dize[] | nesne isteğe bağlı

    Alınacak tek bir anahtar, alınacak anahtar 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

    işlev isteğe bağlı

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

    (items: object) => void

    • items

      nesne

      Anahtar/değer çifti eşlemelerinde öğeler bulunan 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 söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getBytesInUse()

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

Bir veya daha fazla öğenin kullandığı alan miktarını (bayt cinsinden) alır.

Parametreler

  • anahtarlar

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

    Toplam kullanımını almak için 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ı almak için null değerini iletin.

  • callback

    işlev isteğe bağlı

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

    (bytesInUse: number) => void

    • bytesInUse

      sayı

      Depolamada 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ülen veya başarısızlık durumunda reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getKeys()

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

Depolamadaki tüm anahtarları alır.

Parametreler

  • callback

    işlev isteğe bağlı

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

    (keys: string[]) => void

    • anahtarlar

      string[]

      Depolamadan okunan anahtarlara sahip dizi.

İadeler

  • Promise<string[]>

    Depolama anahtarlarıyla çözülen veya başarısızlık durumunda reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

remove()

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

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

Parametreler

  • anahtarlar

    dize | dize[]

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

  • callback

    işlev 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ı durumunda çözülen veya başarısızlık durumunda reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

set()

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

Birden fazla öğeyi ayarlar.

Parametreler

  • items

    nesne

    Depolama alanını güncellemek için her anahtar/değer çiftini veren bir 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 gösterimleriyle serileştirilir) bu kuralın dışındadır.

  • callback

    işlev 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ı durumunda çözülen veya başarısızlık durumunda reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setAccessLevel()

Promise Chrome 102 ve sonraki sürümler 
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ıtlanırken managed, local ve sync depolama alanı 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Başarı durumunda çözülen veya başarısızlık durumunda reddedilen söz.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onChanged

Chrome 73 veya daha yeni bir sürüm 
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