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

ค่าแจกแจง

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

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

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

เมธอด

ejectDevice()

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

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

พารามิเตอร์

  • id

    สตริง

  • Callback

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

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

    (result: EjectDeviceResultCode) => void

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

  • Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getAvailableCapacity()

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

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

พารามิเตอร์

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

  • ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getInfo()

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

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

พารามิเตอร์

  • Callback

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

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

    (info: StorageUnitInfo[]) => void

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

  • Promise<StorageUnitInfo[]>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

กิจกรรม

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

      สตริง