chrome.fileSystemProvider

คำอธิบาย

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

สิทธิ์

fileSystemProvider

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

ChromeOS เท่านั้น

คุณต้องประกาศสิทธิ์และส่วน "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 ของ "file", "device" หรือ "network") - ต้องระบุ
แหล่งข้อมูลสำหรับระบบไฟล์ที่ต่อเชื่อม

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

ภาพรวม

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

ระบบไฟล์การต่อเชื่อม

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

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

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

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

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

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

วงจร

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

ประเภท

AbortRequestedOptions

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

  • fileSystemId

    string

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

  • operationRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

Action

Chrome 45 ขึ้นไป

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

  • id

    string

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

  • title

    string ไม่บังคับ

    ชื่อของการดำเนินการ การดําเนินการทั่วไปอาจไม่สนใจ

AddWatcherRequestedOptions

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

  • entryPath

    string

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

  • fileSystemId

    string

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

  • เกิดซ้ำ

    boolean

    ควรรวมรายการย่อยทั้งหมดซ้ำๆ ไหม ซึ่งสามารถเกิดขึ้นได้กับไดเรกทอรีเท่านั้น

  • requestId

    ตัวเลข

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

Change

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

  • changeType

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

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    รอดำเนินการ

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

  • entryPath

    string

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

ChangeType

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

ค่าแจกแจง

CloseFileRequestedOptions

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

  • fileSystemId

    string

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

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

CloudFileInfo

รอดำเนินการ

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

  • versionTag

    string ไม่บังคับ

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

CloudIdentifier

Chrome 117 ขึ้นไป

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

  • id

    string

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

  • providerName

    string

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

CommonActionId

Chrome 45 ขึ้นไป

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

ค่าแจกแจง

ConfigureRequestedOptions

Chrome 44 ขึ้นไป

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

CopyEntryRequestedOptions

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

  • sourcePath

    string

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

  • targetPath

    string

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

CreateDirectoryRequestedOptions

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

  • directoryPath

    string

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

  • fileSystemId

    string

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

  • เกิดซ้ำ

    boolean

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

  • requestId

    ตัวเลข

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

CreateFileRequestedOptions

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

  • filePath

    string

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

DeleteEntryRequestedOptions

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

  • entryPath

    string

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

  • fileSystemId

    string

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

  • เกิดซ้ำ

    boolean

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

  • requestId

    ตัวเลข

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

EntryMetadata

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

  • cloudFileInfo

    CloudFileInfo ไม่บังคับ

    รอดำเนินการ

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

  • cloudIdentifier

    CloudIdentifier ไม่บังคับ

    Chrome 117 ขึ้นไป

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

  • isDirectory

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

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

  • mimeType

    string ไม่บังคับ

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

  • modificationTime

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

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

  • ชื่อ

    string ไม่บังคับ

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

  • ขนาด

    ตัวเลข ไม่บังคับ

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

  • ภาพปก

    string ไม่บังคับ

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

ExecuteActionRequestedOptions

Chrome 45 ขึ้นไป

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

  • actionId

    string

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

  • entryPaths

    สตริง[]

    Chrome 47 ขึ้นไป

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

FileSystemInfo

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

  • displayName

    string

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

  • fileSystemId

    string

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

  • openedFiles

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

  • openedFilesLimit

    ตัวเลข

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

  • supportsNotifyTag

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

    Chrome 45 ขึ้นไป

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

  • ผู้ชม
    Chrome 45 ขึ้นไป

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

  • เขียนได้

    boolean

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

GetActionsRequestedOptions

Chrome 45 ขึ้นไป

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

  • entryPaths

    สตริง[]

    Chrome 47 ขึ้นไป

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

GetMetadataRequestedOptions

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

  • cloudFileInfo

    boolean

    รอดำเนินการ

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

  • cloudIdentifier

    boolean

    Chrome 117 ขึ้นไป

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

  • entryPath

    string

    เส้นทางของรายการเพื่อดึงข้อมูลเมตา

  • fileSystemId

    string

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

  • isDirectory

    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

    string

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

  • fileSystemId

    string

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

  • openedFilesLimit

    ตัวเลข ไม่บังคับ

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

  • ต่อเนื่อง

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

    Chrome 64 ขึ้นไป

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

  • supportsNotifyTag

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

    Chrome 45 ขึ้นไป

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

  • เขียนได้

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

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

MoveEntryRequestedOptions

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

  • sourcePath

    string

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

  • targetPath

    string

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

NotifyOptions

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

  • changeType

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

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

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

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

  • fileSystemId

    string

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

  • observedPath

    string

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

  • เกิดซ้ำ

    boolean

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

  • แท็ก

    string ไม่บังคับ

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

OpenedFile

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

  • filePath

    string

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

  • โหมด

    มีการเปิดไฟล์สำหรับการอ่านหรือการเขียนหรือไม่

  • openRequestId

    ตัวเลข

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

OpenFileMode

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

ค่าแจกแจง

OpenFileRequestedOptions

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

  • filePath

    string

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

  • fileSystemId

    string

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

  • โหมด

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

  • requestId

    ตัวเลข

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

ProviderError

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

ค่าแจกแจง

"IN_USE"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"NOT_A_FILE"

"NOT_EMPTY"

"IO"

ReadDirectoryRequestedOptions

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

  • directoryPath

    string

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

  • fileSystemId

    string

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

  • isDirectory

    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

    string

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

  • length

    ตัวเลข

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

  • ออฟเซ็ต

    ตัวเลข

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

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

RemoveWatcherRequestedOptions

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

  • entryPath

    string

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

  • fileSystemId

    string

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

  • เกิดซ้ำ

    boolean

    โหมดของผู้รับชม

  • requestId

    ตัวเลข

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

TruncateRequestedOptions

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

  • filePath

    string

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

  • fileSystemId

    string

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

  • length

    ตัวเลข

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

  • requestId

    ตัวเลข

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

UnmountOptions

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

  • fileSystemId

    string

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

UnmountRequestedOptions

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

  • fileSystemId

    string

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

  • requestId

    ตัวเลข

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

Watcher

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

  • entryPath

    string

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

  • lastTag

    string ไม่บังคับ

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

  • เกิดซ้ำ

    boolean

    ควรรวมรายการย่อยทั้งหมดซ้ำๆ ไหม ซึ่งสามารถเกิดขึ้นได้กับไดเรกทอรีเท่านั้น

WriteFileRequestedOptions

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

  • ข้อมูล

    ArrayBuffer

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

  • fileSystemId

    string

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

  • ออฟเซ็ต

    ตัวเลข

    ตําแหน่งในไฟล์ (หน่วยเป็นไบต์) เพื่อเริ่มเขียนไบต์ต้นทาง

  • openRequestId

    ตัวเลข

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

  • requestId

    ตัวเลข

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

วิธีการ

get()

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

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

พารามิเตอร์

  • fileSystemId

    string

  • Callback

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

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

    (fileSystem: FileSystemInfo)=>void

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

  • Chrome 96 ขึ้นไป

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

getAll()

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

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

พารามิเตอร์

  • Callback

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

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

    (fileSystems: FileSystemInfo[])=>void

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

  • Promise<FileSystemInfo[]>

    Chrome 96 ขึ้นไป

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

mount()

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

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

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

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

พารามิเตอร์

  • ตัวเลือก
  • Callback

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

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

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 เกี่ยวกับข้อเท็จจริงดังกล่าว นอกจากนี้ หากมีการเปลี่ยนชื่อไดเรกทอรี ระบบลบรายการสืบทอดทั้งหมดจริงๆ เนื่องจากไม่มีรายการใดๆ ภายใต้เส้นทางเดิมอีกต่อไป

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

พารามิเตอร์

  • ตัวเลือก
  • Callback

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

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

unmount()

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

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

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

พารามิเตอร์

  • ตัวเลือก
  • Callback

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

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

    ()=>void

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

  • Promise<void>

    Chrome 96 ขึ้นไป

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

กิจกรรม

onAbortRequested

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • successCallback

      ฟังก์ชัน

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

      ()=>void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError)=>void

onConfigureRequested

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

onGetMetadataRequested

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

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

พารามิเตอร์

  • Callback

    ฟังก์ชัน

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

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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • successCallback

      ฟังก์ชัน

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

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

      • ข้อมูล

        ArrayBuffer

      • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • 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

    • ตัวเลือก
    • successCallback

      ฟังก์ชัน

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

      ()=>void

    • errorCallback

      ฟังก์ชัน

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

      (error: ProviderError)=>void