StorageArea

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

Phương thức

clear()

chrome.storage.StorageArea.clear(): Promise<void>

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

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

get()

chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
): 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ớ.

Giá trị trả về

  • Promise<object>

    Chrome 95 trở lên

getBytesInUse()

chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
): 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ớ.

Giá trị trả về

  • Promise<number>

    Chrome 95 trở lên

getKeys()

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

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

Giá trị trả về

  • Promise<string[]>

remove()

chrome.storage.StorageArea.remove(
  keys: string | string[],
): 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á.

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

set()

chrome.storage.StorageArea.set(
  items: object,
): 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).

Giá trị trả về

  • Promise<void>

    Chrome 95 trở lên

setAccessLevel()

Chrome 102 trở lên 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): 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ữ.

Giá trị trả về

  • Promise<void>

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