chrome.fileSystemProvider

คำอธิบาย

ใช้ chrome.fileSystemProvider API เพื่อสร้างระบบไฟล์ที่เข้าถึงได้จากตัวจัดการไฟล์ใน ChromeOS

สิทธิ์

fileSystemProvider

ความพร้อมใช้งาน

ChromeOS เท่านั้น

ไฟล์ Manifest

คุณต้องประกาศสิทธิ์และส่วน "fileSystemProvider" ใน Manifest ของส่วนขยายเพื่อใช้ File System Provider API เช่น

{   "name": "My extension",   ...   "permissions": [     "fileSystemProvider"   ],   ...   "file_system_provider_capabilities": {     "configurable": true,     "watchable": false,     "multiple_mounts": true,     "source": "network"   },   ... }

ส่วน file_system_provider ต้องได้รับการประกาศดังนี้

configurable (บูลีน) - ไม่บังคับ
รองรับการกำหนดค่าผ่าน onConfigureRequested หรือไม่ ค่าเริ่มต้นคือ False
multiple_mounts (บูลีน) - ไม่บังคับ
รองรับระบบไฟล์ที่ต่อเชื่อมหลายรายการ (มากกว่า 1 รายการ) หรือไม่ ค่าเริ่มต้นคือ False
watchable (บูลีน) - ไม่บังคับ
รองรับการตั้งค่าผู้ดูและการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงหรือไม่ ค่าเริ่มต้นคือ False
source (enum ของ "file", "device" หรือ "network") - ต้องระบุ
แหล่งที่มาของข้อมูลสำหรับระบบไฟล์ที่ติดตั้ง

แอปไฟล์ใช้ข้อมูลข้างต้นเพื่อแสดงผลองค์ประกอบ UI ที่เกี่ยวข้องอย่างเหมาะสม เช่น หากตั้งค่า configurable เป็นจริง ระบบจะแสดงรายการเมนูสำหรับการกำหนดค่าระดับเสียง ในทำนองเดียวกัน หากตั้งค่า multiple_mounts เป็น true แอป Files จะอนุญาตให้เพิ่มจุดเชื่อมต่อมากกว่า 1 จุดจาก UI หาก watchable เป็น false ระบบจะแสดงปุ่มรีเฟรช โปรดทราบว่าหากเป็นไปได้ คุณควรเพิ่มการรองรับสำหรับโปรแกรมตรวจสอบ เพื่อให้การเปลี่ยนแปลงในระบบไฟล์แสดงผลได้ทันทีและโดยอัตโนมัติ

ภาพรวม

File System Provider API ช่วยให้ส่วนขยายรองรับระบบไฟล์เสมือนซึ่งมีอยู่ในโปรแกรมจัดการไฟล์ใน ChromeOS กรณีการใช้งาน ได้แก่ การคลายการบีบอัดไฟล์เก็บถาวรและการเข้าถึงไฟล์ในบริการระบบคลาวด์อื่นที่ไม่ใช่ไดรฟ์

การติดตั้งระบบไฟล์

การระบุส่วนขยายสามารถระบุเนื้อหาระบบไฟล์จากแหล่งที่มาภายนอก (เช่น เซิร์ฟเวอร์ระยะไกลหรืออุปกรณ์ USB) หรือใช้ไฟล์ในเครื่อง (เช่น ไฟล์เก็บถาวร) เป็นอินพุต

หากต้องการเขียนระบบไฟล์ซึ่งเป็นตัวแฮนเดิลไฟล์ (แหล่งที่มาคือ "file") ผู้ให้บริการต้องเป็นแอปที่แพ็กเกจไว้ เนื่องจากส่วนขยายไม่สามารถใช้เหตุการณ์ onLaunched ได้

หากแหล่งที่มาเป็นเครือข่ายหรืออุปกรณ์ คุณควรติดตั้งระบบไฟล์เมื่อมีการเรียกเหตุการณ์ onMountRequested

แหล่งที่มาของข้อมูลระบบไฟล์ จุดแรกเข้า
"file" ใช้ได้กับแอปที่แพ็กเกจเท่านั้น
"device" หรือ "network" onMountRequested

การกำหนดค่าระบบไฟล์

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

วงจร

Chrome จะจดจำระบบไฟล์ที่ระบุเมื่อติดตั้งแล้วและติดตั้งใหม่โดยอัตโนมัติหลังจากรีบูตหรือรีสตาร์ท ดังนั้นเมื่อส่วนขยายที่ให้บริการเมานต์ระบบไฟล์แล้ว ระบบไฟล์จะยังคงอยู่จนกว่าจะมีการเลิกโหลดส่วนขยาย หรือส่วนขยายเรียกใช้เมธอด unmount

ประเภท

AbortRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • operationRequestId

    ตัวเลข

    รหัสของคำขอที่จะยกเลิก

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

Action

Chrome 45 ขึ้นไป

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

  • id

    สตริง

    ตัวระบุของการกระทำ สตริงหรือ CommonActionId สำหรับการดำเนินการทั่วไป

  • title

    สตริง ไม่บังคับ

    ชื่อของการดำเนินการ ระบบอาจละเว้นการดำเนินการทั่วไป

AddWatcherRequestedOptions

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

  • entryPath

    สตริง

    เส้นทางของรายการที่จะสังเกต

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • แบบเรียกซ้ำ

    บูลีน

    ไม่ว่าจะรวมรายการย่อยทั้งหมดแบบเรียกซ้ำหรือไม่ โดยจะใช้ได้กับไดเรกทอรีเท่านั้น

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

Change

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

  • changeType

    ChangeType

    ประเภทของการเปลี่ยนแปลงที่เกิดขึ้นกับรายการ

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    Chrome 125 ขึ้นไป

    ข้อมูลที่เกี่ยวข้องกับไฟล์หากได้รับการสำรองข้อมูลโดยระบบไฟล์ในระบบคลาวด์

  • entryPath

    สตริง

    เส้นทางของรายการที่เปลี่ยนแปลง

ChangeType

ประเภทของการเปลี่ยนแปลงที่ตรวจพบในไดเรกทอรีที่สังเกต

ค่าแจกแจง

"CHANGED"

"DELETED"

CloseFileRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • openRequestId

    ตัวเลข

    รหัสคำขอที่ใช้เปิดไฟล์

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

CloudFileInfo

Chrome 125 ขึ้นไป

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

  • versionTag

    สตริง ไม่บังคับ

    แท็กที่แสดงถึงเวอร์ชันของไฟล์

CloudIdentifier

Chrome 117 ขึ้นไป

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

  • id

    สตริง

    ตัวระบุของผู้ให้บริการสำหรับไฟล์/ไดเรกทอรีที่ระบุ

  • providerName

    สตริง

    ตัวระบุสำหรับผู้ให้บริการพื้นที่เก็บข้อมูลระบบคลาวด์ (เช่น "drive.google.com")

CommonActionId

Chrome 45 ขึ้นไป

รายการการดำเนินการทั่วไป "SHARE" ใช้สำหรับแชร์ไฟล์กับผู้อื่น "SAVE_FOR_OFFLINE" สำหรับปักหมุด (บันทึกเพื่อเข้าถึงแบบออฟไลน์) "OFFLINE_NOT_NECESSARY" เพื่อแจ้งว่าไม่จำเป็นต้องจัดเก็บไฟล์เพื่อเข้าถึงแบบออฟไลน์อีกต่อไป ใช้โดย onGetActionsRequested และ onExecuteActionRequested

ค่าแจกแจง

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"แชร์"

ConfigureRequestedOptions

Chrome 44 ขึ้นไป

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่จะกำหนดค่า

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

CopyEntryRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

  • sourcePath

    สตริง

    เส้นทางต้นทางของรายการที่จะคัดลอก

  • targetPath

    สตริง

    เส้นทางปลายทางสำหรับการดำเนินการคัดลอก

CreateDirectoryRequestedOptions

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

  • directoryPath

    สตริง

    เส้นทางของไดเรกทอรีที่จะสร้าง

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • แบบเรียกซ้ำ

    บูลีน

    การดำเนินการเป็นแบบเรียกซ้ำหรือไม่ (สำหรับไดเรกทอรีเท่านั้น)

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

CreateFileRequestedOptions

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

  • filePath

    สตริง

    เส้นทางของไฟล์ที่จะสร้าง

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

DeleteEntryRequestedOptions

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

  • entryPath

    สตริง

    เส้นทางของรายการที่จะลบ

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • แบบเรียกซ้ำ

    บูลีน

    การดำเนินการเป็นแบบเรียกซ้ำหรือไม่ (สำหรับไดเรกทอรีเท่านั้น)

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

EntryMetadata

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

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    Chrome 125 ขึ้นไป

    ข้อมูลที่ระบุไฟล์ที่เฉพาะเจาะจงในระบบไฟล์แบบคลาวด์พื้นฐาน ต้องระบุหากมีการขอใน options และไฟล์ได้รับการสำรองข้อมูลโดยที่เก็บข้อมูลบนระบบคลาวด์

  • cloudIdentifier

    CloudIdentifier ไม่บังคับ

    Chrome 117 ขึ้นไป

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

  • isDirectory

    บูลีน ไม่บังคับ

    เป็นจริงหากเป็นไดเรกทอรี ต้องระบุหากมีการขอใน options

  • mimeType

    สตริง ไม่บังคับ

    ประเภท MIME สำหรับรายการ ไม่บังคับเสมอ แต่ควรระบุหากมีการขอใน options

  • modificationTime

    วันที่ ไม่บังคับ

    เวลาที่แก้ไขรายการนี้ล่าสุด ต้องระบุหากมีการขอใน options

  • ชื่อ

    สตริง ไม่บังคับ

    ชื่อของรายการนี้ (ไม่ใช่ชื่อเส้นทางแบบเต็ม) ต้องไม่มี "/" สำหรับรูท ต้องเว้นว่าง ต้องระบุหากมีการขอใน options

  • ขนาด

    หมายเลข ไม่บังคับ

    ขนาดไฟล์ในหน่วยไบต์ ต้องระบุหากมีการขอใน options

  • ภาพปก

    สตริง ไม่บังคับ

    รูปภาพขนาดย่อเป็น URI ข้อมูลในรูปแบบ PNG, JPEG หรือ WEBP โดยมีขนาดไม่เกิน 32 KB ไม่บังคับ แต่จะระบุได้ก็ต่อเมื่อเหตุการณ์ onGetMetadataRequested ร้องขออย่างชัดเจนเท่านั้น

ExecuteActionRequestedOptions

Chrome 45 ขึ้นไป

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

  • actionId

    สตริง

    ตัวระบุของการดำเนินการที่จะดำเนินการ

  • entryPaths

    string[]

    Chrome 47 ขึ้นไป

    ชุดเส้นทางของรายการที่จะใช้สำหรับการดำเนินการ

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

FileSystemInfo

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

  • displayName

    สตริง

    ชื่อที่มนุษย์อ่านได้สำหรับระบบไฟล์

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์

  • openedFiles

    OpenedFile[]

    รายการไฟล์ที่เปิดอยู่ในปัจจุบัน

  • openedFilesLimit

    ตัวเลข

    จำนวนไฟล์สูงสุดที่เปิดได้พร้อมกัน หากเป็น 0 แสดงว่าไม่มีการจำกัด

  • supportsNotifyTag

    บูลีน ไม่บังคับ

    Chrome 45 ขึ้นไป

    ระบบไฟล์รองรับฟิลด์ tag สำหรับการสังเกตการณ์ไดเรกทอรีหรือไม่

  • ผู้ดู

    Watcher[]

    Chrome 45 ขึ้นไป

    รายชื่อผู้ดู

  • เขียนได้

    บูลีน

    ไม่ว่าระบบไฟล์จะรองรับการดำเนินการที่อาจเปลี่ยนแปลงเนื้อหาของระบบไฟล์หรือไม่ (เช่น การสร้าง การลบ หรือการเขียนไปยังไฟล์)

GetActionsRequestedOptions

Chrome 45 ขึ้นไป

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

  • entryPaths

    string[]

    Chrome 47 ขึ้นไป

    รายการเส้นทางของรายการสำหรับรายการการดำเนินการ

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

GetMetadataRequestedOptions

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

  • cloudFileInfo

    บูลีน

    Chrome 125 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า cloudFileInfo

  • cloudIdentifier

    บูลีน

    Chrome 117 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า cloudIdentifier

  • entryPath

    สตริง

    เส้นทางของรายการที่จะดึงข้อมูลเมตา

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • isDirectory

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า is_directory

  • mimeType

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า mimeType

  • modificationTime

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า modificationTime

  • ชื่อ

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า name

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

  • ขนาด

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า size

  • ภาพปก

    บูลีน

    ตั้งค่าเป็น true หากมีการขอค่า thumbnail

MountOptions

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

  • displayName

    สตริง

    ชื่อที่มนุษย์อ่านได้สำหรับระบบไฟล์

  • fileSystemId

    สตริง

    ตัวระบุสตริงของระบบไฟล์ ต้องไม่ซ้ำกันในแต่ละส่วนขยาย

  • openedFilesLimit

    หมายเลข ไม่บังคับ

    จำนวนไฟล์สูงสุดที่เปิดได้พร้อมกัน หากไม่ได้ระบุหรือเป็น 0 จะไม่มีการจำกัด

  • ต่อเนื่อง

    บูลีน ไม่บังคับ

    Chrome 64 ขึ้นไป

    ควรกู้คืนระบบไฟล์ในเซสชันการลงชื่อเข้าใช้ครั้งถัดไปหรือไม่ ค่าเริ่มต้นเป็น True

  • supportsNotifyTag

    บูลีน ไม่บังคับ

    Chrome 45 ขึ้นไป

    ระบบไฟล์รองรับฟิลด์ tag สำหรับไดเรกทอรีที่สังเกตการณ์หรือไม่

  • เขียนได้

    บูลีน ไม่บังคับ

    ไม่ว่าระบบไฟล์จะรองรับการดำเนินการที่อาจเปลี่ยนแปลงเนื้อหาของระบบไฟล์หรือไม่ (เช่น การสร้าง การลบ หรือการเขียนไปยังไฟล์)

MoveEntryRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

  • sourcePath

    สตริง

    เส้นทางต้นทางของรายการที่จะย้ายไปยังตำแหน่งใหม่

  • targetPath

    สตริง

    เส้นทางปลายทางสำหรับการดำเนินการคัดลอก

NotifyOptions

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

  • changeType

    ChangeType

    ประเภทของการเปลี่ยนแปลงที่เกิดขึ้นกับรายการที่สังเกต หากมีการลบรายการดังกล่าว ระบบจะนำรายการที่สังเกตการณ์ออกจากรายการรายการที่สังเกตการณ์โดยอัตโนมัติ

  • การเปลี่ยนแปลง

    เปลี่ยน[] ไม่บังคับ

    รายการการเปลี่ยนแปลงรายการภายในไดเรกทอรีที่สังเกตการณ์ (รวมถึงรายการนั้นๆ)

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการเปลี่ยนแปลงนี้

  • observedPath

    สตริง

    เส้นทางของรายการที่สังเกต

  • แบบเรียกซ้ำ

    บูลีน

    โหมดของรายการที่สังเกต

  • แท็ก

    สตริง ไม่บังคับ

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

OpenedFile

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

  • filePath

    สตริง

    เส้นทางของไฟล์ที่เปิด

  • โหมด

    OpenFileMode

    เปิดไฟล์เพื่ออ่านหรือเขียน

  • openRequestId

    ตัวเลข

    รหัสคำขอที่จะใช้โดยคำขออ่าน/เขียนและปิดที่ต่อเนื่องกัน

OpenFileMode

โหมดการเปิดไฟล์ ใช้โดย onOpenFileRequested

ค่าแจกแจง

"อ่าน"

"เขียน"

OpenFileRequestedOptions

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

  • filePath

    สตริง

    เส้นทางของไฟล์ที่จะเปิด

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • โหมด

    OpenFileMode

    จะใช้ไฟล์สำหรับการอ่านหรือเขียน

  • requestId

    ตัวเลข

    รหัสคำขอที่จะใช้โดยคำขออ่าน/เขียนและปิดที่ต่อเนื่องกัน

ProviderError

รหัสข้อผิดพลาดที่ใช้โดยการระบุส่วนขยายในการตอบกลับคำขอ รวมถึงในกรณีที่เกิดข้อผิดพลาดเมื่อเรียกใช้เมธอดของ API คุณต้องใช้ "OK" เพื่อให้ประสบความสำเร็จ

ค่าแจกแจง

"ตกลง"

"ไม่สำเร็จ"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"ความปลอดภัย"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

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

  • directoryPath

    สตริง

    เส้นทางของไดเรกทอรีที่มีการขอเนื้อหา

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • isDirectory

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า is_directory

  • mimeType

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า mimeType

  • modificationTime

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า modificationTime

  • ชื่อ

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า name

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

  • ขนาด

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า size

  • ภาพปก

    บูลีน

    Chrome 49 ขึ้นไป

    ตั้งค่าเป็น true หากมีการขอค่า thumbnail

ReadFileRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • ความยาว

    ตัวเลข

    จำนวนไบต์ที่จะแสดงผล

  • ออฟเซ็ต

    ตัวเลข

    ตำแหน่งในไฟล์ (เป็นไบต์) ที่จะเริ่มอ่าน

  • openRequestId

    ตัวเลข

    รหัสคำขอที่ใช้เปิดไฟล์

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

RemoveWatcherRequestedOptions

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

  • entryPath

    สตริง

    เส้นทางของรายการที่ดู

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • แบบเรียกซ้ำ

    บูลีน

    โหมดของอุปกรณ์ที่ใช้ดู

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

TruncateRequestedOptions

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

  • filePath

    สตริง

    เส้นทางของไฟล์ที่จะตัดทอน

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • ความยาว

    ตัวเลข

    จำนวนไบต์ที่จะเก็บไว้หลังจากดำเนินการเสร็จสมบูรณ์

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

UnmountOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่จะเลิกเมานต์

UnmountRequestedOptions

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

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่จะเลิกเมานต์

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

Watcher

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

  • entryPath

    สตริง

    เส้นทางของรายการที่สังเกต

  • lastTag

    สตริง ไม่บังคับ

    แท็กที่ใช้โดยการแจ้งเตือนล่าสุดสำหรับผู้ดู

  • แบบเรียกซ้ำ

    บูลีน

    ไม่ว่าจะดูรายการย่อยทั้งหมดแบบเรียกซ้ำหรือไม่ โดยจะใช้ได้กับไดเรกทอรีเท่านั้น

WriteFileRequestedOptions

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

  • เพิ่มเติม

    ArrayBuffer

    บัฟเฟอร์ของไบต์ที่จะเขียนลงในไฟล์

  • fileSystemId

    สตริง

    ตัวระบุของระบบไฟล์ที่เกี่ยวข้องกับการดำเนินการนี้

  • ออฟเซ็ต

    ตัวเลข

    ตำแหน่งในไฟล์ (เป็นไบต์) ที่จะเริ่มเขียนไบต์

  • openRequestId

    ตัวเลข

    รหัสคำขอที่ใช้เปิดไฟล์

  • requestId

    ตัวเลข

    ตัวระบุที่ไม่ซ้ำกันของคำขอนี้

เมธอด

get()

Promise 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
): Promise<FileSystemInfo>

แสดงข้อมูลเกี่ยวกับระบบไฟล์ที่มี fileSystemId ที่ส่งผ่าน

พารามิเตอร์

  • fileSystemId

    สตริง

  • callback

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

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

    (fileSystem: FileSystemInfo) => void

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

  • Promise<FileSystemInfo>

    Chrome 96 ขึ้นไป

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

getAll()

Promise 
chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

แสดงระบบไฟล์ทั้งหมดที่ส่วนขยายติดตั้ง

พารามิเตอร์

  • callback

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

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

    (fileSystems: FileSystemInfo[]) => void

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

  • Promise<FileSystemInfo[]>

    Chrome 96 ขึ้นไป

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

mount()

Promise 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
): Promise<void>

เมานต์ระบบไฟล์ด้วย fileSystemId และ displayName ที่ระบุ displayName จะแสดงในแผงด้านซ้ายของแอป Files displayName สามารถมีอักขระใดก็ได้ รวมถึง "/" แต่ต้องไม่ใช่สตริงว่าง displayName ต้องอธิบายได้ แต่ไม่จำเป็นต้องไม่ซ้ำกัน fileSystemId ต้องไม่ใช่สตริงว่าง

source ต้องได้รับการตั้งค่าอย่างเหมาะสม ทั้งนี้ขึ้นอยู่กับประเภทของระบบไฟล์ที่กำลังติดตั้ง

ในกรณีที่เกิดข้อผิดพลาด ระบบจะตั้งค่า runtime.lastError พร้อมรหัสข้อผิดพลาดที่เกี่ยวข้อง

พารามิเตอร์

  • ตัวเลือก

    MountOptions

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

notify()

Promise Chrome 45 ขึ้นไป 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

แจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในไดเรกทอรีที่ดูที่ observedPath ในโหมด recursive หากมีการติดตั้งระบบไฟล์ด้วย supportsNotifyTag จะต้องระบุ tag และจะมีการรายงานการเปลี่ยนแปลงทั้งหมดนับตั้งแต่การแจ้งเตือนครั้งล่าสุดเสมอ แม้ว่าจะมีการปิดระบบก็ตาม คุณรับแท็กสุดท้ายได้ด้วย getAll

หากต้องการใช้ตัวเลือกนี้ คุณต้องตั้งค่าตัวเลือกไฟล์ Manifest file_system_provider.notify เป็น true

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

ผู้ให้บริการบางรายอาจไม่สามารถระบุแท็กได้ แต่หากระบบไฟล์มีบันทึกการเปลี่ยนแปลง แท็กอาจเป็นหมายเลขการเปลี่ยนแปลงหรือหมายเลขการแก้ไข เป็นต้น

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

ในกรณีที่เกิดข้อผิดพลาด ระบบจะตั้งค่า runtime.lastError พร้อมรหัสข้อผิดพลาดที่เกี่ยวข้อง

พารามิเตอร์

  • ตัวเลือก

    NotifyOptions

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

unmount()

Promise 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
): Promise<void>

ยกเลิกการเชื่อมต่อระบบไฟล์ที่มี fileSystemId ที่ระบุ โดยจะต้องเรียกใช้หลังจากเรียกใช้ onUnmountRequested นอกจากนี้ ส่วนขยายที่ให้บริการยังสามารถเลือกที่จะยกเลิกการเชื่อมต่อได้หากไม่มีการขอ (เช่น ในกรณีที่การเชื่อมต่อขาดหายไปหรือเกิดข้อผิดพลาดเกี่ยวกับไฟล์)

ในกรณีที่เกิดข้อผิดพลาด ระบบจะตั้งค่า runtime.lastError พร้อมรหัสข้อผิดพลาดที่เกี่ยวข้อง

พารามิเตอร์

  • ตัวเลือก

    UnmountOptions

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

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

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      AbortRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onAddWatcherRequested

Chrome 45 ขึ้นไป 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอตั้งค่าเครื่องมือตรวจสอบไดเรกทอรีใหม่ หากเกิดข้อผิดพลาด จะต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      AddWatcherRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอปิดไฟล์ที่เปิดด้วย openRequestId ก่อนหน้านี้

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      CloseFileRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onConfigureRequested

Chrome 44 ขึ้นไป 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอแสดงกล่องโต้ตอบการกำหนดค่าสำหรับ fileSystemId หากมีการจัดการ ตัวเลือก file_system_provider.configurable ในไฟล์ Manifest ต้องตั้งค่าเป็น "จริง"

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      ConfigureRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอคัดลอกรายการ (แบบเรียกซ้ำหากเป็นไดเรกทอรี) หากเกิดข้อผิดพลาด จะต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      CopyEntryRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอสร้างไดเรกทอรี การดำเนินการต้องล้มเหลวโดยมีข้อผิดพลาด EXISTS หากมีไดเรกทอรีเป้าหมายอยู่แล้ว หาก recursive เป็นจริง จะต้องสร้างไดเรกทอรีที่ขาดหายไปทั้งหมดในเส้นทางไดเรกทอรี

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      CreateDirectoryRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอสร้างไฟล์ หากมีไฟล์อยู่แล้ว จะต้องเรียกใช้ errorCallback พร้อม"EXISTS" รหัสข้อผิดพลาด

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      CreateFileRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอให้ลบรายการ หาก recursive เป็นจริงและรายการเป็นไดเรกทอรี ระบบจะต้องลบรายการทั้งหมดภายในแบบเรียกซ้ำด้วย

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      DeleteEntryRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onExecuteActionRequested

Chrome 48 ขึ้นไป 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอให้ดำเนินการกับชุดไฟล์หรือไดเรกทอรี หลังจากดำเนินการเสร็จแล้ว ต้องเรียกใช้ successCallback ในกรณีที่เกิดข้อผิดพลาด ต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      ExecuteActionRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onGetActionsRequested

Chrome 48 ขึ้นไป 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอรายการการดำเนินการสำหรับชุดไฟล์หรือไดเรกทอรีที่ entryPaths การดำเนินการที่ส่งคืนทั้งหมดต้องใช้ได้กับแต่ละรายการ หากไม่มีการดำเนินการดังกล่าว ควรแสดงผลอาร์เรย์เปล่า ต้องส่งคืนการดำเนินการพร้อมกับการเรียก successCallback ในกรณีที่เกิดข้อผิดพลาด ต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      GetActionsRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      (actions: Action[]) => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอข้อมูลเมตาของไฟล์หรือไดเรกทอรีที่ entryPath ระบบต้องส่งคืนข้อมูลเมตาพร้อมกับการเรียก successCallback ในกรณีที่เกิดข้อผิดพลาด ต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      GetMetadataRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      (metadata: EntryMetadata) => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onMountRequested

Chrome 44 ขึ้นไป 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอแสดงกล่องโต้ตอบสำหรับการติดตั้งระบบไฟล์ใหม่ หากส่วนขยาย/แอปเป็นตัวแฮนเดิลไฟล์ ก็ไม่ควรจัดการเหตุการณ์นี้ แต่ควรจัดการ app.runtime.onLaunched เพื่อติดตั้งระบบไฟล์ใหม่เมื่อเปิดไฟล์ หากมีการติดตั้งหลายรายการ คุณต้องตั้งค่าตัวเลือกไฟล์ Manifest file_system_provider.multiple_mounts เป็น "จริง"

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (successCallback: function, errorCallback: function) => void

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอให้ย้ายรายการ (แบบเรียกซ้ำหากเป็นไดเรกทอรี) หากเกิดข้อผิดพลาด จะต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      MoveEntryRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอเปิดไฟล์ที่ filePath หากไม่มีไฟล์ดังกล่าว การดำเนินการจะต้องไม่สำเร็จ ระบุจำนวนไฟล์สูงสุดที่เปิดได้พร้อมกันได้ด้วย MountOptions

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      OpenFileRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      (metadata?: EntryMetadata) => void

      • ข้อมูลเมตา

        EntryMetadata ไม่บังคับ

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอเนื้อหาของไดเรกทอรีที่ directoryPath ระบบต้องส่งคืนผลลัพธ์เป็นกลุ่มโดยการเรียกใช้ successCallback หลายครั้ง ในกรณีที่เกิดข้อผิดพลาด ต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      ReadDirectoryRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      (entries: EntryMetadata[], hasMore: boolean) => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขออ่านเนื้อหาของไฟล์ที่เปิดไว้ก่อนหน้านี้ด้วย openRequestId ระบบต้องแสดงผลลัพธ์เป็นกลุ่มโดยการเรียกใช้ successCallback หลายครั้ง ในกรณีที่เกิดข้อผิดพลาด ต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      ReadFileRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      (data: ArrayBuffer, hasMore: boolean) => void

      • เพิ่มเติม

        ArrayBuffer

      • hasMore

        บูลีน

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 ขึ้นไป 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อควรนำผู้สังเกตการณ์ออก หากเกิดข้อผิดพลาด จะต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      RemoveWatcherRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอตัดไฟล์ให้มีความยาวตามที่ต้องการ หากเกิดข้อผิดพลาด จะต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      TruncateRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอเลิกเมานต์ระบบไฟล์ที่มีตัวระบุ fileSystemId ในการตอบกลับ ต้องเรียกใช้เมธอด API unmount พร้อมกับ successCallback หากถอนการเชื่อมต่อไม่ได้ (เช่น เนื่องจากมีการดำเนินการที่รอดำเนินการ) คุณต้องเรียกใช้ errorCallback

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      UnmountRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

เกิดขึ้นเมื่อมีการขอเขียนเนื้อหาลงในไฟล์ที่เปิดไว้ก่อนหน้านี้ด้วย openRequestId

พารามิเตอร์

  • callback

    ฟังก์ชัน

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

    (options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • ตัวเลือก

      WriteFileRequestedOptions

    • successCallback

      ฟังก์ชัน

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

      () => void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError) => void