FileSystemDirectoryHandle: phương thức getDirectoryHandle()

Cú pháp

getDirectoryHandle(name)
getDirectoryHandle(name, options)

Tham số

name

Một chuỗi biểu thị FileSystemHandle.name của thư mục con mà bạn muốn truy xuất.

options Optional

Một đối tượng tùy chọn chứa các thiết lập cho thư mục con được truy xuất. Các tùy chọn như sau:

create Optional

Một giá trị boolean, mặc định là false. Khi đặt là true mà thư mục không được tìm thấy, một thư mục với tên đã chỉ định sẽ được tạo và trả về.

Giá trị trả về

Một Promise được thực thi thành một FileSystemDirectoryHandle.

Ngoại lệ

NotAllowedError DOMException

Được ném ra nếu trạng thái PermissionStatus.state của handle không phải là 'granted' ở chế độ readwrite khi tùy chọn create được đặt thành true, hoặc ở chế độ read khi tùy chọn create được đặt thành false.

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.

TypeMismatchError DOMException

Được ném ra nếu mục được trả về là một tệp chứ không phải thư mục.

NotFoundError DOMException

Được ném ra nếu mục hiện tại không được tìm thấy hoặc nếu thư mục đích không tồn tại và tùy chọn create được đặt thành false.

Ví dụ

Ví dụ sau trả về một handle thư mục với tên được chỉ định; nếu thư mục chưa tồn tại thì nó sẽ được tạo.

const dirName = "directoryToGetName";

// giả sử chúng ta có một handle thư mục: 'currentDirHandle'
const subDir = await currentDirHandle.getDirectoryHandle(dirName, {
  create: true,
});

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• File System API
• The File System Access API: simplifying access to local files