StorageArea

Giao diện StorageArea được dùng bởi API chrome.storage.

Phương thức

clear()

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

Xoá tất cả các mục khỏi bộ nhớ.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

get()

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

Lấy một hoặc nhiều mục từ bộ nhớ.

Thông số

  • khoá

    string | string[] | object không bắt buộc

    Một khoá duy nhất để nhận, danh sách khoá để nhận hoặc một từ điển chỉ định các giá trị mặc định (xem phần mô tả về đối tượng). Một danh sách hoặc đối tượng trống sẽ trả về một đối tượng kết quả trống. Truyền null để nhận toàn bộ nội dung của bộ nhớ.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (items: object) => void

    • mục

      đối tượng

      Đối tượng có các mục trong mối liên kết khoá-giá trị.

Giá trị trả về

  • Promise<object>

    Chrome 95 trở lên

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getBytesInUse()

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

Lấy dung lượng (tính bằng byte) mà một hoặc nhiều mục đang sử dụng.

Thông số

  • khoá

    string | string[] không bắt buộc

    Một khoá hoặc danh sách khoá để nhận tổng mức sử dụng. Một danh sách trống sẽ trả về 0. Truyền null để biết tổng mức sử dụng của tất cả bộ nhớ.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (bytesInUse: number) => void

    • bytesInUse

      số

      Dung lượng đang được sử dụng trong bộ nhớ, tính bằng byte.

Giá trị trả về

  • Promise<number>

    Chrome 95 trở lên

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getKeys()

Promise Chrome 130 trở lên 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Lấy tất cả các khoá từ bộ nhớ.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (keys: string[]) => void

    • khoá

      string[]

      Mảng có các khoá được đọc từ bộ nhớ.

Giá trị trả về

  • Promise<string[]>

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

remove()

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

Xoá một hoặc nhiều mục khỏi bộ nhớ.

Thông số

  • khoá

    chuỗi | string[]

    Một khoá duy nhất hoặc danh sách khoá cho các mục cần xoá.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

set()

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

Đặt nhiều mục.

Thông số

  • mục

    đối tượng

    Một đối tượng cung cấp từng cặp khoá/giá trị để cập nhật bộ nhớ. Mọi cặp khoá/giá trị khác trong bộ nhớ sẽ không bị ảnh hưởng.

    Các giá trị gốc, chẳng hạn như số, sẽ được chuyển đổi tuần tự như dự kiến. Các giá trị có typeof "object" và "function" thường sẽ chuyển đổi tuần tự thành {}, ngoại trừ Array (chuyển đổi tuần tự như dự kiến), Date và Regex (chuyển đổi tuần tự bằng cách sử dụng biểu thị String).

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setAccessLevel()

Promise Chrome 102 trở lên 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

Đặt cấp truy cập mong muốn cho vùng lưu trữ. Theo mặc định, bộ nhớ session chỉ được phép truy cập trong các ngữ cảnh đáng tin cậy (trang tiện ích và trình chạy dịch vụ), trong khi bộ nhớ managed, local và sync cho phép truy cập từ cả ngữ cảnh đáng tin cậy và không đáng tin cậy.

Thông số

  • accessOptions

    đối tượng

    • accessLevel

      AccessLevel

      Cấp truy cập của vùng lưu trữ.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Các promise chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onChanged

Chrome 73 trở lên 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Sự kiện này sẽ kích hoạt khi một hoặc nhiều mục thay đổi.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (changes: object) => void

    • các thay đổi

      đối tượng