chrome.system.storage

คำอธิบาย

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

สิทธิ์

system.storage

ประเภท

EjectDeviceResultCode

ค่าแจกแจง

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

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

"no_such_device"
ไม่พบอุปกรณ์ดังกล่าว

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

StorageAvailableCapacityInfo

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

  • availableCapacity

    ตัวเลข

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

  • id

    string

    คัดลอกidพารามิเตอร์ของฟังก์ชัน getAvailableCapacity id แล้ว

StorageUnitInfo

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

  • ความจุ

    ตัวเลข

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

  • id

    string

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

  • ชื่อ

    string

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

  • ประเภท

    StorageUnitType

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

StorageUnitType

ค่าแจกแจง

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

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

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

วิธีการ

ejectDevice()

สัญญา 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

พารามิเตอร์

  • id

    string

  • Callback

    ฟังก์ชัน ไม่บังคับ

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

    (result: EjectDeviceResultCode)=>void

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

  • Chrome 91 ขึ้นไป

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

getAvailableCapacity()

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

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

พารามิเตอร์

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

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

getInfo()

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

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

    (info: StorageUnitInfo[])=>void

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

  • Promise<StorageUnitInfo[]>

    Chrome 91 ขึ้นไป

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

กิจกรรม

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

      string