ตอนนี้ Chrome รองรับเนมสเปซ browser.* ที่ได้มาตรฐานแล้ว (พร้อมใช้งานตั้งแต่ Chrome 148 เป็นต้นไป) เรากำลังทยอยอัปเดตเอกสารประกอบ อ่านเพิ่มเติมในคู่มือการเปลี่ยนผ่าน

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

browser.fileSystemProvider

คำอธิบาย

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

สิทธิ์

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

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

ภาพรวม

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

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

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

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

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

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

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

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

วงจร

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

ประเภท

AbortRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

ตัวเลข

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

Action

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

id

สตริง

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

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

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

AddWatcherRequestedOptions

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

entryPath

สตริง

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

สตริง

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

บูลีน

การสังเกตการณ์ควรรวมรายการย่อยทั้งหมดซ้ำหรือไม่ ซึ่งใช้ได้กับไดเรกทอรีเท่านั้น
requestId

ตัวเลข

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

Change

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

changeType

ChangeType

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

CloudFileInfo ไม่บังคับ

Chrome 125 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148

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

สตริง

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

ChangeType

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

ค่าแจกแจง

"CHANGED"

"DELETED"

CloseFileRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

ตัวเลข

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

CloudFileInfo

Chrome 125 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148

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

versionTag

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

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

CloudIdentifier

Chrome 117 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

id

สตริง

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

สตริง

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

CommonActionId

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

ค่าแจกแจง

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"แชร์"

ConfigureRequestedOptions

Chrome 44 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

fileSystemId

สตริง

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

ตัวเลข

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

CopyEntryRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

สตริง

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

สตริง

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

CreateDirectoryRequestedOptions

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

directoryPath

สตริง

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

สตริง

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

บูลีน

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

ตัวเลข

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

CreateFileRequestedOptions

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

filePath

สตริง

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

สตริง

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

ตัวเลข

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

DeleteEntryRequestedOptions

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

entryPath

สตริง

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

สตริง

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

บูลีน

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

ตัวเลข

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

EntryMetadata

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

cloudFileInfo

CloudFileInfo ไม่บังคับ

Chrome 125 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148

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

CloudIdentifier ไม่บังคับ

Chrome 117 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

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

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

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

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

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

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

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

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

number ไม่บังคับ

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

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

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

ExecuteActionRequestedOptions

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

actionId

สตริง

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

string[]

Chrome 47 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

สตริง

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

ตัวเลข

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

FileSystemInfo

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

displayName

สตริง

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

สตริง

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

OpenedFile[]

รายการไฟล์ที่เปิดอยู่
openedFilesLimit

ตัวเลข

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

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

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

Watcher[]

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

รายชื่อผู้ติดตาม
เขียนได้

บูลีน

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

GetActionsRequestedOptions

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

entryPaths

string[]

Chrome 47 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

สตริง

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

ตัวเลข

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

GetMetadataRequestedOptions

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

cloudFileInfo

บูลีน

Chrome 125 ขึ้นไป เบราว์เซอร์* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 117 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

สตริง

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

สตริง

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

ตัวเลข

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

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

MountOptions

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

displayName

สตริง

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

สตริง

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

number ไม่บังคับ

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

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

เบราว์เซอร์ Chrome 64 ขึ้นไป * ตั้งแต่ Chrome 148

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

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

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

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

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

MoveEntryRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

สตริง

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

สตริง

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

NotifyOptions

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

changeType

ChangeType

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

Change[] ไม่บังคับ

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

สตริง

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

สตริง

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

บูลีน

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

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

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

OpenedFile

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

filePath

สตริง

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

OpenFileMode

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

ตัวเลข

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

OpenFileMode

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

ค่าแจกแจง

"READ"

"เขียน"

OpenFileRequestedOptions

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

filePath

สตริง

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

สตริง

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

OpenFileMode

จะใช้ไฟล์เพื่อการอ่านหรือการเขียน
requestId

ตัวเลข

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

ProviderError

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

ค่าแจกแจง

"ตกลง"

"FAILED"

"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 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

ตัวเลข

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

บูลีน

Chrome 49 ขึ้นไป browser.* ตั้งแต่ Chrome 148

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

ReadFileRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

ตัวเลข

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

ตัวเลข

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

ตัวเลข

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

RemoveWatcherRequestedOptions

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

entryPath

สตริง

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

สตริง

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

บูลีน

โหมดของผู้สังเกตการณ์
requestId

ตัวเลข

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

TruncateRequestedOptions

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

filePath

สตริง

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

สตริง

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

ตัวเลข

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

ตัวเลข

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

UnmountOptions

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

fileSystemId

สตริง

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

UnmountRequestedOptions

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

fileSystemId

สตริง

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

ตัวเลข

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

Watcher

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

entryPath

สตริง

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

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

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

บูลีน

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

WriteFileRequestedOptions

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

เพิ่มเติม

ArrayBuffer

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

สตริง

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

ตัวเลข

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

ตัวเลข

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

ตัวเลข

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

เมธอด

get()

browser.fileSystemProvider.get(
  fileSystemId: string,
): Promise<FileSystemInfo>

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

พารามิเตอร์

fileSystemId

สตริง

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

Promise<FileSystemInfo>

Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

Callback เพื่อรับผลลัพธ์ของฟังก์ชัน get

getAll()

browser.fileSystemProvider.getAll(): Promise<FileSystemInfo[]>

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

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

Promise<FileSystemInfo[]>

Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

Callback เพื่อรับผลลัพธ์ของฟังก์ชัน getAll

mount()

browser.fileSystemProvider.mount(
  options: MountOptions,
): Promise<void>

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

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

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

พารามิเตอร์

ตัวเลือก

MountOptions

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

Promise<void>

Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

Callback ผลลัพธ์ทั่วไปเพื่อระบุความสำเร็จหรือความล้มเหลว

notify()

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.fileSystemProvider.notify(
  options: NotifyOptions,
): Promise<void>

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

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

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

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

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

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

พารามิเตอร์

ตัวเลือก

NotifyOptions

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

Promise<void>

Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

Callback ผลลัพธ์ทั่วไปเพื่อระบุความสำเร็จหรือความล้มเหลว

unmount()

browser.fileSystemProvider.unmount(
  options: UnmountOptions,
): Promise<void>

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

พารามิเตอร์

ตัวเลือก

UnmountOptions

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

Promise<void>

Chrome 96 ขึ้นไป browser.* ตั้งแต่ Chrome 148

Callback ผลลัพธ์ทั่วไปเพื่อระบุความสำเร็จหรือความล้มเหลว

กิจกรรม

onAbortRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  AbortRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onAddWatcherRequested

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  AddWatcherRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onCloseFileRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  CloseFileRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onConfigureRequested

Chrome 44 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  ConfigureRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onCopyEntryRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  CopyEntryRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onCreateDirectoryRequested

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onCreateFileRequested

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onDeleteEntryRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  DeleteEntryRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onExecuteActionRequested

Chrome 48 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onGetActionsRequested

Chrome 48 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onGetMetadataRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  GetMetadataRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
(metadata: EntryMetadata) => void
```
  - ข้อมูลเมตา
    
    EntryMetadata
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onMountRequested

Chrome 44 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(successCallback: function, errorCallback: function) => void
```
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onMoveEntryRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  MoveEntryRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onOpenFileRequested

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onReadDirectoryRequested

browser.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
```
  - รายการ
    
    EntryMetadata[]
  - hasMore
    
    บูลีน
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onReadFileRequested

browser.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
```
  - ข้อผิดพลาด
    
    ProviderError

onRemoveWatcherRequested

Chrome 45 ขึ้นไป browser.* ตั้งแต่ Chrome 148

browser.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

แสดงเมื่อควรนำ Watcher ออก หากเกิดข้อผิดพลาด ระบบจะเรียกใช้ errorCallback

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  RemoveWatcherRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onTruncateRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  TruncateRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onUnmountRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  UnmountRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError

onWriteFileRequested

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

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

พารามิเตอร์

callback

ฟังก์ชัน

พารามิเตอร์ callback จะมีลักษณะดังนี้
```
(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
```
- ตัวเลือก
  
  WriteFileRequestedOptions
- successCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ successCallback จะมีลักษณะดังนี้
```
() => void
```
- errorCallback
  
  ฟังก์ชัน
  
  พารามิเตอร์ errorCallback จะมีลักษณะดังนี้
```
(error: ProviderError) => void
```
  - ข้อผิดพลาด
    
    ProviderError