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

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

  • Promise<EjectDeviceResultCode>

    Chrome 91 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

getAvailableCapacity()

สัญญา เวอร์ชันที่กำลังพัฒนา 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

พารามิเตอร์

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

  • รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

getInfo()

สัญญา 
chrome.system.storage.getInfo(
  callback?: function,
)

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (info: StorageUnitInfo[]) => void

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

  • Promise<StorageUnitInfo[]>

    Chrome 91 ขึ้นไป

    รองรับคำสัญญาในไฟล์ Manifest V3 ขึ้นไป แต่จะมี Callback สำหรับ ความเข้ากันได้แบบย้อนหลัง คุณไม่สามารถใช้ทั้ง 2 อย่างในการเรียกใช้ฟังก์ชันเดียวกันได้ จะมีการแก้ไขด้วยประเภทเดียวกันที่ส่งไปยัง Callback

กิจกรรม

onAttached

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (info: StorageUnitInfo) => void

onDetached

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

    (id: string) => void

    • id

      สตริง