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ào và tháo ra.

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. Không thể ngắt kết nối; 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 thao tác với thiết bị.

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

"failure"
Lệnh đẩy ra 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

    Một bản sao id 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ã tạm thời giúp xác định riêng biệt thiết bị lưu trữ. Mã nhận dạng này sẽ được duy trì trong cùng một lần chạy của một ứng dụng. Giá trị nhận dạng này sẽ không cố định giữa các lần chạy khác nhau của một ứng dụng hoặc giữa các ứng dụng khác nhau.

  • 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, ví dụ: đĩa cứng hoặc ổ SSD.

"removable"
Bộ nhớ có thể tháo rời, ví dụ: ổ flash USB.

"unknown"
Loại bộ nhớ không xác đị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

    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.

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 chỉ định. id là mã thiết bị tạm thời từ StorageUnitInfo.

Thông số

Giá trị trả về

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

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 các đối tượng StorageUnitInfo.

Thông số

Giá trị trả về

  • Promise<StorageUnitInfo[]>

    Chrome 91 trở lên

    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

onAttached

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

Được kích hoạt khi một bộ nhớ rời 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 một bộ nhớ rời 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