FileSystemDirectoryHandle: phương thức getFileHandle()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
Phương thức getFileHandle() của giao diện FileSystemDirectoryHandle trả về một FileSystemFileHandle cho một tệp có tên được chỉ định, nằm trong thư mục mà phương thức được gọi.
Cú pháp
getFileHandle(name)
getFileHandle(name, options)
Tham số
name-
Một chuỗi biểu thị
FileSystemHandle.namecủa tệp bạn muốn truy xuất. optionsOptional-
Một đối tượng với các thuộc tính sau:
createOptional-
Một
Boolean. Mặc định làfalse. Khi đặt thànhtruemà tệp không được tìm thấy, một tệp với tên được chỉ định sẽ được tạo và trả về.
Giá trị trả về
Một Promise được thực thi thành một FileSystemFileHandle.
Ngoại lệ
NotAllowedErrorDOMException-
Được ném ra nếu trạng thái
PermissionStatus.statecủa handle không phải là'granted'ở chế độreadwritekhi tùy chọncreateđược đặt thànhtrue, hoặc ở chế độreadkhi tùy chọncreateđược đặt thànhfalse. TypeError-
Được ném ra nếu tên được chỉ định không phải là một chuỗi hợp lệ hoặc chứa các ký tự có thể gây xung đột với hệ thống tệp gốc.
TypeMismatchErrorDOMException-
Được ném ra nếu mục được đặt tên là một thư mục chứ không phải tệp.
NotFoundErrorDOMException-
Được ném ra nếu mục hiện tại không được tìm thấy hoặc nếu tệp không tồn tại và tùy chọn
createđược đặt thànhfalse.
Ví dụ
Ví dụ sau trả về một file handle với tên được chỉ định; nếu tệp chưa tồn tại thì nó sẽ được tạo.
const fileName = "fileToGetName";
// giả sử chúng ta có một handle thư mục: 'currentDirHandle'
const fileHandle = await currentDirHandle.getFileHandle(fileName, {
create: true,
});
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| File System # api-filesystemdirectoryhandle-getfilehandle |