StorageArea

Giao diện StorageArea được API browser.storage sử dụng.

Phương thức

clear()

browser.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 trình duyệt.* kể từ Chrome 148

    Lời hứa sẽ giải quyết khi thành công hoặc từ chối khi không thành công.

get()

browser.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á cần lấy, danh sách khoá cần lấy hoặc từ điển chỉ định giá trị mặc định (xem nội dung mô tả về đối tượng). 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 vào null để lấy toàn bộ nội dung của bộ nhớ.

Giá trị trả về

  • <object> hứa hẹn

    Chrome 95 trở lên trình duyệt.* kể từ Chrome 148

    Lời hứa sẽ phân giải bằng một đối tượng chứa bản đồ khoá-giá trị cho các mục được yêu cầu hoặc từ chối nếu không thành công.

getBytesInUse()

browser.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á để lấy tổng mức sử dụng. Danh sách trống sẽ trả về 0. Truyền null để nhận 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 trình duyệt.* kể từ Chrome 148

    Lời hứa sẽ giải quyết bằng dung lượng mà bộ nhớ đang sử dụng hoặc từ chối khi không thành công.

getKeys()

Chrome 130 trở lên browser.* kể từ Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

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

Giá trị trả về

  • Promise<string[]>

    Lời hứa sẽ phân giải bằng khoá bộ nhớ hoặc từ chối khi không thành công.

remove()

browser.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á

    string | string[]

    Một khoá 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 trình duyệt.* kể từ Chrome 148

    Lời hứa sẽ giải quyết khi thành công hoặc từ chối khi không thành công.

set()

browser.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 như số sẽ 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 trình duyệt.* kể từ Chrome 148

    Lời hứa sẽ giải quyết khi thành công hoặc từ chối khi không thành công.

setAccessLevel()

Chrome 102 trở lên browser.* kể từ Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

Đặt cấp truy cập mong muốn cho khu vực lưu trữ. Theo mặc định, bộ nhớ session bị hạn chế đối với các bối 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ả bối 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 khu vực lưu trữ.

Giá trị trả về

  • Promise<void>

    Lời hứa sẽ giải quyết khi thành công hoặc từ chối khi không thành công.

Sự kiện

onChanged

Chrome 73 trở lên browser.* kể từ Chrome 148 
browser.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Được 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