chrome.fileSystemProvider

คำอธิบาย

ใช้ chrome.fileSystemProvider API เพื่อสร้างระบบไฟล์ที่สามารถเข้าถึงได้จากโปรแกรมจัดการไฟล์ใน Chrome OS

สิทธิ์

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 หรือไม่ โดยค่าเริ่มต้น: เท็จ
multiple_mounts (บูลีน) - ไม่บังคับ
รองรับระบบไฟล์ที่ต่อเชื่อมหลายระบบ (มากกว่า 1) ระบบหรือไม่ โดยค่าเริ่มต้น: เท็จ
watchable (บูลีน) - ไม่บังคับ
รองรับการตั้งค่าผู้ดูและแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงหรือไม่ โดยค่าเริ่มต้น: เท็จ
source (enum ของ "ไฟล์" "อุปกรณ์" หรือ "เครือข่าย") - ต้องระบุ
แหล่งที่มาของข้อมูลสำหรับระบบไฟล์ที่ต่อเชื่อม

แอป Files ใช้ข้อมูลข้างต้นเพื่อแสดงผลองค์ประกอบ 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

    string ไม่บังคับ

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

AddWatcherRequestedOptions

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

  • entryPath

    สตริง

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

  • fileSystemId

    สตริง

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

  • การเกิดซ้ำ

    boolean

    การสังเกตการณ์ควรรวมรายการย่อยทั้งหมดที่เกิดซ้ำหรือไม่ อาจเป็นจริงสำหรับไดเรกทอรีเท่านั้น

  • requestId

    ตัวเลข

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

Change

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

  • changeType

    ChangeType

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

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    Chrome 125 ขึ้นไป

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

  • entryPath

    สตริง

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

ChangeType

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

ค่าแจกแจง

"เปลี่ยนแปลงแล้ว"

"ลบแล้ว"

CloseFileRequestedOptions

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

  • fileSystemId

    สตริง

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

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

CloudFileInfo

Chrome 125 ขึ้นไป

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

  • versionTag

    string ไม่บังคับ

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

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

    สตริง

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

  • การเกิดซ้ำ

    boolean

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

  • requestId

    ตัวเลข

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

CreateFileRequestedOptions

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

  • filePath

    สตริง

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

  • fileSystemId

    สตริง

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

  • requestId

    ตัวเลข

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

DeleteEntryRequestedOptions

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

  • entryPath

    สตริง

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

  • fileSystemId

    สตริง

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

  • การเกิดซ้ำ

    boolean

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

  • requestId

    ตัวเลข

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

EntryMetadata

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

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    Chrome 125 ขึ้นไป

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

  • cloudIdentifier

    CloudIdentifier ไม่บังคับ

    Chrome 117 ขึ้นไป

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

  • ไดเรกทอรี

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

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

  • mimeType

    string ไม่บังคับ

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

  • modificationTime

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

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

  • ชื่อ

    string ไม่บังคับ

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

  • ขนาด

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

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

  • ภาพขนาดย่อ

    string ไม่บังคับ

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

ExecuteActionRequestedOptions

Chrome 45 ขึ้นไป

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

  • actionId

    สตริง

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

  • entryPaths

    สตริง[]

    Chrome 47 ขึ้นไป

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

  • fileSystemId

    สตริง

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

  • requestId

    ตัวเลข

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

FileSystemInfo

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

  • displayName

    สตริง

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

  • fileSystemId

    สตริง

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

  • openedFiles

    OpenedFile[]

    รายการไฟล์ที่เปิดอยู่ในขณะนี้

  • openedFilesLimit

    ตัวเลข

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

  • supportsNotifyTag

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

    Chrome 45 ขึ้นไป

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

  • ผู้เฝ้าดู

    ผู้ดู[]

    Chrome 45 ขึ้นไป

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

  • เขียนได้

    boolean

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

GetActionsRequestedOptions

Chrome 45 ขึ้นไป

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

  • entryPaths

    สตริง[]

    Chrome 47 ขึ้นไป

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

  • fileSystemId

    สตริง

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

  • requestId

    ตัวเลข

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

GetMetadataRequestedOptions

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

  • cloudFileInfo

    boolean

    Chrome 125 ขึ้นไป

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

  • cloudIdentifier

    boolean

    Chrome 117 ขึ้นไป

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

  • entryPath

    สตริง

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

  • fileSystemId

    สตริง

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

  • ไดเรกทอรี

    boolean

    Chrome 49 ขึ้นไป

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

  • mimeType

    boolean

    Chrome 49 ขึ้นไป

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

  • modificationTime

    boolean

    Chrome 49 ขึ้นไป

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

  • ชื่อ

    boolean

    Chrome 49 ขึ้นไป

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

  • requestId

    ตัวเลข

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

  • ขนาด

    boolean

    Chrome 49 ขึ้นไป

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

  • ภาพขนาดย่อ

    boolean

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

MountOptions

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

  • displayName

    สตริง

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

  • fileSystemId

    สตริง

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

  • openedFilesLimit

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

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

  • ต่อเนื่อง

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

    Chrome 64 ขึ้นไป

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

  • supportsNotifyTag

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

    Chrome 45 ขึ้นไป

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

  • เขียนได้

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

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

MoveEntryRequestedOptions

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

  • fileSystemId

    สตริง

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

  • requestId

    ตัวเลข

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

  • sourcePath

    สตริง

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

  • targetPath

    สตริง

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

NotifyOptions

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

  • changeType

    ChangeType

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

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

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

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

  • fileSystemId

    สตริง

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

  • observedPath

    สตริง

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

  • การเกิดซ้ำ

    boolean

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

  • แท็ก

    string ไม่บังคับ

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

OpenedFile

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

  • filePath

    สตริง

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

  • โหมด

    OpenFileMode

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

  • openRequestId

    ตัวเลข

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

OpenFileMode

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

ค่าแจกแจง

"อ่าน"

"เขียน"

OpenFileRequestedOptions

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

  • filePath

    สตริง

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

  • fileSystemId

    สตริง

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

  • โหมด

    OpenFileMode

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

  • requestId

    ตัวเลข

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

ProviderError

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

ค่าแจกแจง

"ตกลง"

"ล้มเหลว"

"IN_USE"

"มีอยู่"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

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

"ยกเลิก"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

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

  • directoryPath

    สตริง

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

  • fileSystemId

    สตริง

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

  • ไดเรกทอรี

    boolean

    Chrome 49 ขึ้นไป

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

  • mimeType

    boolean

    Chrome 49 ขึ้นไป

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

  • modificationTime

    boolean

    Chrome 49 ขึ้นไป

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

  • ชื่อ

    boolean

    Chrome 49 ขึ้นไป

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

  • requestId

    ตัวเลข

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

  • ขนาด

    boolean

    Chrome 49 ขึ้นไป

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

  • ภาพขนาดย่อ

    boolean

    Chrome 49 ขึ้นไป

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

ReadFileRequestedOptions

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

  • fileSystemId

    สตริง

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

  • ความยาว

    ตัวเลข

    จำนวนไบต์ที่จะส่งคืน

  • หักลบ

    ตัวเลข

    ตำแหน่งในไฟล์ (ในหน่วยไบต์) เพื่อเริ่มการอ่าน

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

RemoveWatcherRequestedOptions

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

  • entryPath

    สตริง

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

  • fileSystemId

    สตริง

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

  • การเกิดซ้ำ

    boolean

    โหมดของผู้เฝ้าดู

  • requestId

    ตัวเลข

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

TruncateRequestedOptions

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

  • filePath

    สตริง

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

  • fileSystemId

    สตริง

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

  • ความยาว

    ตัวเลข

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

  • requestId

    ตัวเลข

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

UnmountOptions

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

  • fileSystemId

    สตริง

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

UnmountRequestedOptions

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

  • fileSystemId

    สตริง

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

  • requestId

    ตัวเลข

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

Watcher

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

  • entryPath

    สตริง

    เส้นทางของรายการที่พบ

  • lastTag

    string ไม่บังคับ

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

  • การเกิดซ้ำ

    boolean

    การเลือกให้รวมรายการย่อยทั้งหมดที่เกิดซ้ำหรือไม่ อาจเป็นจริงสำหรับไดเรกทอรีเท่านั้น

WriteFileRequestedOptions

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

  • ข้อมูล

    อาร์เรย์บัฟเฟอร์

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

  • fileSystemId

    สตริง

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

  • หักลบ

    ตัวเลข

    ตำแหน่งในไฟล์ (ในหน่วยไบต์) เพื่อเริ่มเขียนข้อมูลไบต์

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

เมธอด

get()

สัญญา 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

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

พารามิเตอร์

  • fileSystemId

    สตริง

  • Callback

    ไม่บังคับ

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

    (fileSystem: FileSystemInfo) => void

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

  • Promise<FileSystemInfo>

    Chrome 96 ขึ้นไป

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

getAll()

สัญญา 
chrome.fileSystemProvider.getAll(
  callback?: function,
)

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

พารามิเตอร์

  • Callback

    ไม่บังคับ

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

    (fileSystems: FileSystemInfo[]) => void

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

  • Promise<FileSystemInfo[]>

    Chrome 96 ขึ้นไป

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

mount()

สัญญา 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

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

ต้องตั้งค่าตัวเลือก source ให้เหมาะสม ทั้งนี้ขึ้นอยู่กับประเภทของระบบไฟล์ที่จะต่อเชื่อม

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

พารามิเตอร์

  • ตัวเลือก

    MountOptions

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

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

notify()

สัญญา Chrome 45 ขึ้นไป 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

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

ในการใช้งาน ต้องตั้งค่าตัวเลือกไฟล์ Manifest file_system_provider.notify เป็น "จริง"

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

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

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

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

พารามิเตอร์

  • ตัวเลือก

    NotifyOptions

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

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

unmount()

สัญญา 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

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

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

พารามิเตอร์

  • ตัวเลือก

    UnmountOptions

  • Callback

    ไม่บังคับ

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

    () => void

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

  • คำสัญญา<โมฆะ>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onAbortRequested

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

เพิ่มขึ้นเมื่อขอล้มเลิกการดำเนินการด้วย operationRequestId การดำเนินการที่ดำเนินการกับ operationRequestId ต้องหยุดลงทันที และ successCallback ของคำขอล้มเลิกนี้ที่ดำเนินการ หากล้มเลิกไม่สำเร็จ จะต้องเรียกใช้ errorCallback โปรดทราบว่าต้องไม่มีการเรียกใช้ Callback ของการดำเนินการที่ล้มเลิก เนื่องจากจะไม่มีผล แม้ว่าจะโทรติดต่อ 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 หากมีการจัดการ ตัวเลือก manfiest ของ file_system_provider.configurable ต้องตั้งค่าเป็น "จริง"

พารามิเตอร์

  • 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,
)

ยกขึ้นเมื่อมีการขอสร้างไดเรกทอรี การดำเนินการต้องล้มเหลวโดยมีข้อผิดพลาด "มีอยู่" หากมีไดเรกทอรีเป้าหมายอยู่แล้ว หาก 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

      • ข้อมูล

        อาร์เรย์บัฟเฟอร์

      • hasMore

        boolean

    • 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