chrome.system.storage

Mô tả

Dùng API chrome.system.storage để truy vấn thông tin về 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

"thành công"
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 ứng dụng khác dùng. Quá trình đẩy ra không thành công; người dùng không được tháo thiết bị cho đến khi ứng dụng khác được hoàn tất với thiết bị.

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

"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

    string

    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

    string

    Mã tạm thời xác định duy nhất thiết bị lưu trữ. Mã nhận dạng này sẽ cố định trong cùng một lần chạy ứng dụng. Đó 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

    string

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

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

StorageUnitType

Enum

"cố định"
Bộ nhớ có nội dung nghe nhìn cố định, ví dụ: ổ đĩa cứng hoặc SSD.

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

Lời hứa 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

Ngắt kết nối một thiết bị lưu trữ di động.

Tham số

Giá trị trả về

  • Promise<EjectDeviceResultCode>

    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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getAvailableCapacity()

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

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

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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

getInfo()

Lời hứa 
chrome.system.storage.getInfo(
  callback?: function,
)

Lấy thông tin về bộ nhớ từ hệ thống. Đối số được chuyển tới 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 cho 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. Chiến lược phát hành đĩa đơn Promise phân giải cùng 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