FileSystemFileHandle: phương thức getFile()

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 getFile() của giao diện FileSystemFileHandle trả về một Promise được thực thi thành một đối tượng File đại diện cho trạng thái trên đĩa của mục nhập được handle biểu diễn.

Nếu file trên đĩa thay đổi hoặc bị xóa sau khi phương thức này được gọi, đối tượng File trả về có khả năng sẽ không còn đọc được nữa.

Cú pháp

js
getFile()

Tham số

Không có.

Giá trị trả về

Một Promise được thực thi thành một đối tượng File.

Ngoại lệ

NotAllowedError DOMException

Được ném ra nếu PermissionStatus.state không phải là granted ở chế độ read.

NotFoundError DOMException

Được ném ra nếu mục hiện tại không được tìm thấy.

Ví dụ

Hàm bất đồng bộ sau hiển thị bộ chọn file và, sau khi người dùng chọn file, dùng phương thức getFile() để lấy nội dung.

js
async function getTheFile() {
  // open file picker
  const [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // get file contents
  const fileData = await fileHandle.getFile();
}

Thông số kỹ thuật

Thông số kỹ thuật
File System
# api-filesystemfilehandle-getfile

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

Xem thêm