chrome.system.storage

คำอธิบาย

ใช้ chrome.system.storage API เพื่อค้นหาข้อมูลอุปกรณ์จัดเก็บข้อมูล และรับการแจ้งเตือนเมื่อมีการแนบและถอดอุปกรณ์จัดเก็บข้อมูลแบบถอดออก

สิทธิ์

system.storage

สิทธิ์นี้เรียกให้แสดงคำเตือน

ประเภท

EjectDeviceResultCode

ค่าแจกแจง

"success"
คำสั่งดีดออกเสร็จสมบูรณ์ แอปพลิเคชันสามารถแจ้งให้ผู้ใช้นำอุปกรณ์ออก

"in_use"
แอปพลิเคชันอื่นกำลังใช้งานอยู่ การดีดออกไม่สำเร็จ ผู้ใช้ไม่ควรนำอุปกรณ์ออกจนกว่าแอปพลิเคชันอื่นจะเสร็จสิ้นกับอุปกรณ์

"no_such_device"
ไม่มีอุปกรณ์ที่รู้จัก

"failure"
คำสั่งดีดออกล้มเหลว

StorageAvailableCapacityInfo

พร็อพเพอร์ตี้

• availableCapacity

  ตัวเลข

  ความจุที่ใช้ได้ของอุปกรณ์จัดเก็บข้อมูลในหน่วยไบต์

• id

  สตริง

  id ที่คัดลอกของพารามิเตอร์ฟังก์ชัน getavailableCapacity id

StorageUnitInfo

พร็อพเพอร์ตี้

• ความจุ

  ตัวเลข

  ปริมาณพื้นที่เก็บข้อมูลทั้งหมดในหน่วยไบต์

• id

  สตริง

  รหัสชั่วคราวที่ระบุอุปกรณ์จัดเก็บข้อมูลโดยไม่ซ้ำกัน รหัสนี้จะยังคงอยู่ตลอดในการเรียกใช้แอปพลิเคชันเดียวกัน โดยจะไม่เป็นตัวระบุถาวรระหว่างการเรียกใช้แอปพลิเคชันที่ต่างกันหรือระหว่างแอปพลิเคชันที่ต่างกัน

• ชื่อ

  สตริง

  ชื่อหน่วยพื้นที่เก็บข้อมูล

• ประเภท

  StorageUnitType

  ประเภทสื่อของหน่วยพื้นที่เก็บข้อมูล

StorageUnitType

ค่าแจกแจง

"fixed"
พื้นที่เก็บข้อมูลมีสื่อแบบคงที่ เช่น ฮาร์ดดิสก์หรือดิสก์ SSD

"removable"
พื้นที่เก็บข้อมูลแบบถอดได้ เช่น แฟลชไดรฟ์ USB

"unknown"
ประเภทพื้นที่เก็บข้อมูลไม่รู้จัก

เมธอด

ejectDevice()

สัญญา

chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

ดีดอุปกรณ์เก็บข้อมูลแบบถอดออกได้

พารามิเตอร์

• id

  สตริง

• Callback

  ไม่บังคับ

  พารามิเตอร์ callback มีลักษณะดังนี้

  (result: EjectDeviceResultCode) => void

  • ผลลัพธ์

    EjectDeviceResultCode

การคืนสินค้า

• Promise<EjectDeviceResultCode>

  Chrome 91 ขึ้นไป

  Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getAvailableCapacity()

สัญญา เวอร์ชันที่กำลังพัฒนา

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

ดูความจุที่ใช้ได้ของอุปกรณ์พื้นที่เก็บข้อมูล id ที่ระบุ id คือรหัสอุปกรณ์ชั่วคราวจาก StorageUnitInfo

พารามิเตอร์

• id

  สตริง

• Callback

  ไม่บังคับ

  พารามิเตอร์ callback มีลักษณะดังนี้

  (info: StorageAvailableCapacityInfo) => void

  • ข้อมูล

    StorageAvailableCapacityInfo

การคืนสินค้า

• Promise<StorageAvailableCapacityInfo>

  Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

getInfo()

สัญญา

chrome.system.storage.getInfo(
  callback?: function,
)

รับข้อมูลพื้นที่เก็บข้อมูลจากระบบ อาร์กิวเมนต์ที่ส่งผ่านไปยัง Callback คืออาร์เรย์ของออบเจ็กต์ StorageUnitInfo

พารามิเตอร์

• Callback

  ไม่บังคับ

  พารามิเตอร์ callback มีลักษณะดังนี้

  (info: StorageUnitInfo[]) => void

  • ข้อมูล

    StorageUnitInfo[]

การคืนสินค้า

• Promise<StorageUnitInfo[]>

  Chrome 91 ขึ้นไป

  Promise รองรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้ Callback

กิจกรรม

onAttached

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

เริ่มทำงานเมื่อมีการต่อพื้นที่เก็บข้อมูลแบบถอดได้ใหม่เข้ากับระบบ

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (info: StorageUnitInfo) => void

  • ข้อมูล

    StorageUnitInfo

onDetached

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

เริ่มทำงานเมื่อมีการถอดพื้นที่เก็บข้อมูลแบบถอดออกได้ออกจากระบบ

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback มีลักษณะดังนี้

  (id: string) => void

  • id

    สตริง