StorageArea

Antarmuka StorageArea digunakan oleh chrome.storage API.

Metode

clear()

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

Menghapus semua item dari penyimpanan.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 95+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

get()

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

Mendapatkan satu atau beberapa item dari penyimpanan.

Parameter

  • kunci

    string | string[] | object opsional

    Satu kunci yang akan diambil, daftar kunci yang akan diambil, atau kamus yang menentukan nilai default (lihat deskripsi objek). Daftar atau objek kosong akan menampilkan objek hasil kosong. Teruskan null untuk mendapatkan seluruh konten penyimpanan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (items: object) => void

    • item

      objek

      Objek dengan item dalam pemetaan nilai kuncinya.

Hasil

  • Promise<object>

    Chrome 95+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getBytesInUse()

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

Mendapatkan jumlah ruang (dalam byte) yang digunakan oleh satu atau beberapa item.

Parameter

  • kunci

    string | string[] opsional

    Satu kunci atau daftar kunci untuk mendapatkan total penggunaan. Daftar kosong akan menampilkan 0. Teruskan null untuk mendapatkan total penggunaan semua penyimpanan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (bytesInUse: number) => void

    • bytesInUse

      angka

      Jumlah ruang yang digunakan dalam penyimpanan, dalam byte.

Hasil

  • Promise<number>

    Chrome 95+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

getKeys()

Promise Chrome 130+ 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Mendapatkan semua kunci dari penyimpanan.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (keys: string[]) => void

    • kunci

      string[]

      Array dengan kunci yang dibaca dari penyimpanan.

Hasil

  • Promise<string[]>

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

remove()

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

Menghapus satu atau beberapa item dari penyimpanan.

Parameter

  • kunci

    string | string[]

    Satu kunci atau daftar kunci untuk item yang akan dihapus.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 95+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

set()

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

Menetapkan beberapa item.

Parameter

  • item

    objek

    Objek yang memberikan setiap pasangan nilai kunci untuk memperbarui penyimpanan. Pasangan nilai/kunci lainnya dalam penyimpanan tidak akan terpengaruh.

    Nilai primitif seperti angka akan diserialisasi seperti yang diharapkan. Nilai dengan typeof "object" dan "function" biasanya akan diserialisasi menjadi {}, kecuali Array (diserialisasi seperti yang diharapkan), Date, dan Regex (diserialisasi menggunakan representasi String-nya).

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 95+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

setAccessLevel()

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

Menetapkan tingkat akses yang diinginkan untuk area penyimpanan. Secara default, penyimpanan session dibatasi untuk konteks tepercaya (halaman ekstensi dan pekerja layanan), sementara penyimpanan managed, local, dan sync mengizinkan akses dari konteks tepercaya dan tidak tepercaya.

Parameter

  • accessOptions

    objek

    • accessLevel

      AccessLevel

      Tingkat akses area penyimpanan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onChanged

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

Diaktifkan saat satu atau beberapa item berubah.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (changes: object) => void

    • perubahan

      objek