browser.system.storage

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()

browser.system.storage.ejectDevice(
  id: string,
): Promise<EjectDeviceResultCode>

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

Thông số

  • id

    chuỗi

Giá trị trả về

getAvailableCapacity()

Kênh nhà phát triển 
browser.system.storage.getAvailableCapacity(
  id: string,
): 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ố

  • id

    chuỗi

Giá trị trả về

getInfo()

browser.system.storage.getInfo(): 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.

Giá trị trả về

  • Promise<StorageUnitInfo[]>

    Chrome 91 trở lên browser.* kể từ Chrome 148

Sự kiện

onAttached

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

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