StorageArea

refresh date: 2026-09-25 robots: noindex

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

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

    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.

    Lời hứa 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á 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ớ.

  • 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ề

  • <object> hứa hẹn

    Chrome 95 trở lên

    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.

    Lời hứa 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á để 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ớ.

  • 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

    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.

    Lời hứa 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ả 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[]>

    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.

    Lời hứa 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á

    string | string[]

    Một khoá 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

    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.

    Lời hứa 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 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).

  • 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

    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.

    Lời hứa 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 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ữ.

  • callback

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

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

    () => void

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.

    Lời hứa 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,
)

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