chrome.system.storage

Nội dung mô tả

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 đính kèm và tháo rời.

Quyền

system.storage

Loại

EjectDeviceResultCode

Liệt kê

"success"
Lệnh đẩy đã 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 dùng. Việc đẩy ra không thành công; người dùng không được rút thiết bị ra cho đến khi ứng dụng khác hoàn tất với thiết bị.

"no_such_device"
Không xác định đượ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

    number

    Dung lượng khả dụng của thiết bị lưu trữ, tính bằng byte.

  • id

    string

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

StorageUnitInfo

Thuộc tính

  • dung lượng

    number

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

  • id

    string

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

  • tên

    string

    Tên của thiết bị lưu trữ.

  • Loại phương tiện của thiết bị lưu trữ.

StorageUnitType

Liệt kê

"fixed"
Bộ nhớ đã được lắp đặt cố định phương tiện, ví dụ: ổ đĩa cứng hoặc SSD.

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

"không xác định"
Loại bộ nhớ không xác định.

Phương thức

ejectDevice()

Cam kết 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

Ngắt kết nối thiết bị lưu trữ có thể tháo rời.

Tham số

Giá trị trả về

  • Chrome 91 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getAvailableCapacity()

Hứa hẹn Kênh nhà phát triển 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

Tải dung lượng có sẵn 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.

Tham số

Giá trị trả về

  • Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.

getInfo()

Cam kết 
chrome.system.storage.getInfo(
  callback?: function,
)

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.

Tham số

Giá trị trả về

  • Promise<StorageUnitInfo[]>

    Chrome 91 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến 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ớ di động mới được gắn vào hệ thống.

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

Tham số

  • số gọi lại

    hàm

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

    (id: string)=>void

    • id

      string