chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.system.storage để truy vấn thông tin thiết bị lưu trữ và nhận thông báo khi thiết bị lưu trữ di động được gắn và tháo rời.

Quyền

system.storage

Loại

EjectDeviceResultCode

Enum

"success"
Lệnh đẩy ra thành công – ứng dụng có thể nhắc người dùng tháo thiết bị.

"in_use"
Thiết bị đang được một ứng dụng khác sử dụng. Thao tác đẩy không thành công; người dùng không nên tháo thiết bị cho đến khi ứng dụng khác hoàn tất việc sử dụng thiết bị.

"no_such_device"
Không có thiết bị nào như vậy.

"failure"
Lệnh đẩy không thành công.

StorageAvailableCapacityInfo

Thuộc tính

  • availableCapacity

    số

    Dung lượng còn trống của thiết bị lưu trữ, tính bằng byte.

  • id

    chuỗi

    id đã sao chép của tham số hàm getAvailableCapacity id.

StorageUnitInfo

Thuộc tính

  • dung lượng

    số

    Tổng dung lượng lưu trữ, tính bằng byte.

  • id

    chuỗi

    Mã nhận dạng tạm thời xác định riêng biệt thiết bị lưu trữ. Mã nhận dạng này sẽ duy trì trong cùng một lần chạy của một ứng dụng duy nhất. Đây không phải là giá trị nhận dạng cố định giữa các lần chạy ứng dụng hoặc giữa các ứng dụng.

  • tên

    chuỗi

    Tên của đơn vị lưu trữ.

  • Loại nội dung nghe nhìn của đơn vị lưu trữ.

StorageUnitType

Enum

"fixed"
Bộ nhớ có phương tiện cố định, chẳng hạn như ổ đĩa cứng hoặc ổ SSD.

"có thể tháo rời"
Bộ nhớ có thể tháo rời, chẳng hạn như ổ USB flash.

"unknown"
Không xác định được loại bộ nhớ.

Phương thức

ejectDevice()

Promise 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
): Promise<EjectDeviceResultCode>

Tháo thiết bị lưu trữ di động.

Thông số

Giá trị trả về

  • Chrome 91 trở lên

    Chỉ Manifest V3 trở lên mới hỗ trợ Promise, các nền tảng khác cần sử dụng lệnh gọi lại.

getAvailableCapacity()

Promise Kênh nhà phát triển 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

Lấy dung lượng còn trống của một thiết bị lưu trữ id cụ thể. id là mã thiết bị tạm thời trong StorageUnitInfo.

Thông số

Giá trị trả về

  • Chỉ Manifest V3 trở lên mới hỗ trợ Promise, các nền tảng khác cần sử dụng lệnh gọi lại.

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

Lấy thông tin về bộ nhớ từ hệ thống. Đối số được truyền đến lệnh gọi lại là một mảng gồm các đối tượng StorageUnitInfo.

Thông số

Giá trị trả về

  • Promise<StorageUnitInfo[]>

    Chrome 91 trở lên

    Chỉ Manifest V3 trở lên mới hỗ trợ Promise, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onAttached

chrome.system.storage.onAttached.addListener(
  callback: function,
)

Kích hoạt khi một thiết bị lưu trữ di động mới được gắn vào hệ thống.

Thông số

onDetached

chrome.system.storage.onDetached.addListener(
  callback: function,
)

Được kích hoạt khi bộ nhớ di động bị tách khỏi hệ thống.

Thông số

  • callback

    hàm

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

    (id: string) => void

    • id

      chuỗi