chrome.system.storage

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

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

สิทธิ์

system.storage

สิทธิ์นี้จะทริกเกอร์คำเตือน

ประเภท

EjectDeviceResultCode

ค่าแจกแจง

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

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

"no_such_device"
ไม่รู้จักอุปกรณ์ดังกล่าว

"failure"
คำสั่งนำออกไม่สำเร็จ

StorageAvailableCapacityInfo

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

• availableCapacity

  ตัวเลข

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

• id

  สตริง

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

StorageUnitInfo

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

• ความจุ

  ตัวเลข

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

• id

  สตริง

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

• name

  สตริง

  ชื่อของหน่วยเก็บของ

• ประเภท

  StorageUnitType

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

StorageUnitType

ค่าแจกแจง

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

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

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

เมธอด

ejectDevice()

Promise

chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
): Promise<EjectDeviceResultCode>

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

พารามิเตอร์

• id

  สตริง

• callback

  function ไม่บังคับ

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

  (result: EjectDeviceResultCode) => void

  • ผลลัพธ์

    EjectDeviceResultCode

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

• Promise<EjectDeviceResultCode>

  Chrome 91 ขึ้นไป

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

getAvailableCapacity()

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

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

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

พารามิเตอร์

• id

  สตริง

• callback

  function ไม่บังคับ

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

  (info: StorageAvailableCapacityInfo) => void

  • ข้อมูล

    StorageAvailableCapacityInfo

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

• Promise<StorageAvailableCapacityInfo>

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

getInfo()

Promise

chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

พารามิเตอร์

• callback

  function ไม่บังคับ

  พารามิเตอร์ 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

    สตริง