chrome.downloads

Quyền này kích hoạt một cảnh báo

Mô tả

Sử dụng API chrome.downloads để khởi động, giám sát, thao tác và tìm kiếm tệp đã tải xuống theo phương thức lập trình.

Quyền

downloads

Tệp kê khai

Bạn phải khai báo quyền "downloads" trong tệp kê khai tiện ích để sử dụng API này.

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
  ...
}

Ví dụ

Bạn có thể tìm thấy các ví dụ đơn giản về cách sử dụng API chrome.downloads trong examples/api/downloads thư mục. Để biết các ví dụ khác và để được trợ giúp xem mã nguồn, hãy xem phần Mẫu.

Loại

BooleanDelta

Thuộc tính

• hồ sơ thanh toán

  boolean không bắt buộc

• trước

  boolean không bắt buộc

DangerType

tệp

Tên tệp của tệp tải xuống đáng ngờ.

url

URL của tệp tải xuống đó được xác định là độc hại.

nội dung

Tệp đã tải xuống được xác định là độc hại.

không phổ biến

URL của tệp tải xuống thường không được tải xuống và có thể nguy hiểm.

người tổ chức

Tệp tải xuống bắt nguồn từ một máy chủ lưu trữ được xác định là phân phối các tệp nhị phân độc hại và có thể nguy hiểm.

không mong muốn

Tệp tải xuống có thể không mong muốn hoặc không an toàn. Ví dụ: nó có thể làm thay đổi chế độ cài đặt của trình duyệt hoặc máy tính.

an toàn

Nội dung tải xuống không gây nguy hiểm đã biết cho máy tính của người dùng.

đã chấp nhận

Người dùng đã chấp nhận nội dung tải xuống nguy hiểm.

Enum

"file"

"url"

"content"

"không phổ biến"

"người tổ chức"

"không mong muốn"

"an toàn"

"được chấp nhận"

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"Bị chặn quá lớn"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedStrict"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

" blockedscanFailed"

DoubleDelta

Thuộc tính

• hồ sơ thanh toán

  số không bắt buộc

• trước

  số không bắt buộc

DownloadDelta

Thuộc tính

• canResume

  BooleanDelta không bắt buộc

  Thay đổi trong canResume, nếu có.

• mối nguy hiểm

  StringDelta không bắt buộc

  Thay đổi trong danger, nếu có.

• endTime

  StringDelta không bắt buộc

  Thay đổi trong endTime, nếu có.

• error

  StringDelta không bắt buộc

  Thay đổi trong error, nếu có.

• tồn tại

  BooleanDelta không bắt buộc

  Thay đổi trong exists, nếu có.

• fileSize

  DoubleDelta không bắt buộc

  Thay đổi trong fileSize, nếu có.

• filename

  StringDelta không bắt buộc

  Thay đổi trong filename, nếu có.

• finalUrl

  StringDelta không bắt buộc

  Chrome 54 trở lên

  Thay đổi trong finalUrl, nếu có.

• id

  số

  id của DownloadItem đã thay đổi.

• điệu bộ

  StringDelta không bắt buộc

  Thay đổi trong mime, nếu có.

• tạm dừng

  BooleanDelta không bắt buộc

  Thay đổi trong paused, nếu có.

• startTime

  StringDelta không bắt buộc

  Thay đổi trong startTime, nếu có.

• tiểu bang

  StringDelta không bắt buộc

  Thay đổi trong state, nếu có.

• totalBytes

  DoubleDelta không bắt buộc

  Thay đổi trong totalBytes, nếu có.

• url

  StringDelta không bắt buộc

  Thay đổi trong url, nếu có.

DownloadItem

Thuộc tính

• byExtensionId

  chuỗi không bắt buộc

  Giá trị nhận dạng của tiện ích đã bắt đầu quá trình tải xuống này nếu quá trình tải xuống này do một tiện ích thực hiện. Không thay đổi sau khi được đặt.

• byExtensionName

  chuỗi không bắt buộc

  Tên đã bản địa hoá của tiện ích đã kích hoạt quá trình tải xuống này nếu quá trình tải xuống này do một tiện ích thực hiện. Có thể thay đổi nếu tiện ích thay đổi tên hoặc người dùng thay đổi ngôn ngữ.

• bytesReceived

  số

  Số byte nhận được từ máy chủ lưu trữ tính đến thời điểm hiện tại, chưa tính đến việc nén tệp.

• canResume

  boolean

  Đúng nếu quá trình tải xuống đang diễn ra và bị tạm dừng, hoặc nếu quá trình tải xuống bị gián đoạn và có thể tiếp tục từ nơi bị gián đoạn.

• mối nguy hiểm

  DangerType

  Cho biết nội dung tải xuống này được cho là an toàn hay đáng ngờ.

• endTime

  chuỗi không bắt buộc

  Thời điểm quá trình tải xuống kết thúc ở định dạng ISO 8601. Có thể được truyền trực tiếp đến hàm khởi tạo Ngày: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

• error

  InterruptReason không bắt buộc

  Lý do quá trình tải xuống bị gián đoạn. Một số loại lỗi HTTP có thể được nhóm vào một trong các lỗi bắt đầu bằng SERVER_. Lỗi liên quan đến mạng bắt đầu bằng NETWORK_, lỗi liên quan đến quá trình ghi tệp vào hệ thống tệp bắt đầu bằng FILE_ và gián đoạn do người dùng thực hiện bắt đầu bằng USER_.

• estimatedEndTime

  chuỗi không bắt buộc

  Thời gian ước tính khi quá trình tải xuống hoàn tất, ở định dạng ISO 8601. Có thể được truyền trực tiếp đến hàm khởi tạo Ngày: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

• tồn tại

  boolean

  Liệu tệp đã tải xuống có còn tồn tại hay không. Thông tin này có thể đã lỗi thời vì Chrome không tự động theo dõi hoạt động xoá tệp. Gọi search() để kích hoạt quá trình kiểm tra sự tồn tại của tệp. Khi quá trình kiểm tra sự tồn tại hoàn tất, nếu tệp đã bị xoá, thì sự kiện onChanged sẽ kích hoạt. Lưu ý rằng search() không đợi quá trình kiểm tra sự tồn tại kết thúc trước khi trả về, vì vậy, kết quả từ search() có thể không phản ánh chính xác hệ thống tệp. Ngoài ra, search() có thể được gọi thường xuyên khi cần, nhưng sẽ không kiểm tra sự tồn tại của tệp thường xuyên hơn 10 giây một lần.

• fileSize

  số

  Số byte trong toàn bộ tệp sau khi giải nén hoặc -1 nếu không xác định.

• filename

  string

  Đường dẫn cục bộ tuyệt đối.

• finalUrl

  string

  Chrome 54 trở lên

  URL tuyệt đối mà nội dung tải xuống này đang được tạo từ đó, sau tất cả các lần chuyển hướng.

• id

  số

  Giá trị nhận dạng không đổi qua các phiên của trình duyệt.

• ẩn danh

  boolean

  Sai nếu nội dung tải xuống này được ghi lại trong lịch sử, true nếu nội dung tải xuống này không được ghi lại.

• điệu bộ

  string

  Loại MIME của tệp.

• tạm dừng

  boolean

  Đúng nếu quá trình tải xuống đã ngừng đọc dữ liệu từ máy chủ nhưng vẫn mở kết nối.

• người giới thiệu

  string

  URL tuyệt đối.

• startTime

  string

  Thời điểm bắt đầu tải xuống ở định dạng ISO 8601. Có thể được truyền trực tiếp đến hàm khởi tạo Ngày: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

• tiểu bang

  Trạng thái

  Cho biết quá trình tải xuống đang diễn ra, bị gián đoạn hay hoàn tất.

• totalBytes

  số

  Số byte trong toàn bộ tệp, không tính đến việc nén tệp hoặc -1 nếu không xác định.

• url

  string

  URL tuyệt đối mà quá trình tải xuống này bắt đầu từ đó, trước bất kỳ lượt chuyển hướng nào.

DownloadOptions

Thuộc tính

• cơ thể

  chuỗi không bắt buộc

  Nội dung bài đăng.

• conflictAction

  FilenameConflictAction không bắt buộc

  Hành động cần thực hiện nếu filename đã tồn tại.

• filename

  chuỗi không bắt buộc

  Một đường dẫn tệp tương ứng với thư mục Tài nguyên đã tải xuống để chứa tệp đã tải xuống, có thể chứa các thư mục con. Đường dẫn tuyệt đối, đường dẫn trống và đường dẫn chứa tham chiếu ngược ".." sẽ gây ra lỗi. onDeterminingFilename cho phép đề xuất tên tệp sau khi xác định loại MIME của tệp và tên tệp dự kiến.

• tiêu đề

  HeaderNameValuePair[] không bắt buộc

  Các tiêu đề HTTP bổ sung để gửi cùng với yêu cầu nếu URL sử dụng giao thức HTTP. Mỗi tiêu đề được biểu thị dưới dạng một từ điển chứa các khoá name và value hoặc binaryValue, chỉ dành cho các khoá mà XMLHttpRequest cho phép.

• method

  HttpMethod không bắt buộc

  Phương thức HTTP cần sử dụng nếu URL sử dụng giao thức HTTP[S].

• saveAs

  boolean không bắt buộc

  Sử dụng trình chọn tệp để cho phép người dùng chọn tên tệp bất kể filename được đặt hay đã tồn tại.

• url

  string

  URL cần tải xuống.

DownloadQuery

Thuộc tính

• bytesReceived

  số không bắt buộc

  Số byte nhận được từ máy chủ lưu trữ tính đến thời điểm hiện tại, chưa tính đến việc nén tệp.

• mối nguy hiểm

  DangerType không bắt buộc

  Cho biết nội dung tải xuống này được cho là an toàn hay đáng ngờ.

• endTime

  chuỗi không bắt buộc

  Thời điểm quá trình tải xuống kết thúc ở định dạng ISO 8601.

• endedAfter

  chuỗi không bắt buộc

  Giới hạn kết quả còn DownloadItem kết thúc sau ms nhất định ở định dạng ISO 8601

• endedBefore

  chuỗi không bắt buộc

  Giới hạn kết quả còn DownloadItem kết thúc trước mili giây đã cho ở định dạng ISO 8601.

• error

  InterruptReason không bắt buộc

  Lý do quá trình tải xuống bị gián đoạn.

• tồn tại

  boolean không bắt buộc

  Liệu tệp đã tải xuống có tồn tại hay không;

• fileSize

  số không bắt buộc

  Số byte trong toàn bộ tệp sau khi giải nén hoặc -1 nếu không xác định.

• filename

  chuỗi không bắt buộc

  Đường dẫn cục bộ tuyệt đối.

• filenameRegex

  chuỗi không bắt buộc

  Giới hạn kết quả đến DownloadItem có filename khớp với biểu thức chính quy đã cho.

• finalUrl

  chuỗi không bắt buộc

  Chrome 54 trở lên

  URL tuyệt đối mà nội dung tải xuống này đang được tạo từ đó, sau tất cả các lần chuyển hướng.

• finalUrlRegex

  chuỗi không bắt buộc

  Chrome 54 trở lên

  Giới hạn kết quả đến DownloadItem có finalUrl khớp với biểu thức chính quy đã cho.

• id

  số không bắt buộc

  id của DownloadItem để truy vấn.

• giới hạn

  số không bắt buộc

  Số lượng tối đa các kết quả trùng khớp DownloadItem được trả về. Giá trị mặc định là 1000. Được đặt thành 0 để trả về tất cả các DownloadItem trùng khớp. Hãy xem search để biết cách phân trang kết quả.

• điệu bộ

  chuỗi không bắt buộc

  Loại MIME của tệp.

• orderBy

  string[] không bắt buộc

  Đặt các phần tử của mảng này thành các thuộc tính DownloadItem để sắp xếp kết quả tìm kiếm. Ví dụ: việc đặt orderBy=['startTime'] sẽ sắp xếp DownloadItem theo thời gian bắt đầu theo thứ tự tăng dần. Để chỉ định thứ tự giảm dần, hãy thêm tiền tố bằng dấu gạch nối: '-startTime'.

• tạm dừng

  boolean không bắt buộc

  Đúng nếu quá trình tải xuống đã ngừng đọc dữ liệu từ máy chủ nhưng vẫn mở kết nối.

• truy vấn

  string[] không bắt buộc

  Mảng cụm từ tìm kiếm này giới hạn kết quả ở DownloadItem có filename, url hoặc finalUrl chứa tất cả các cụm từ tìm kiếm không bắt đầu bằng dấu gạch ngang '-' và không có cụm từ tìm kiếm nào bắt đầu bằng dấu gạch ngang.

• startTime

  chuỗi không bắt buộc

  Thời điểm bắt đầu tải xuống ở định dạng ISO 8601.

• startedAfter

  chuỗi không bắt buộc

  Giới hạn kết quả thành DownloadItem bắt đầu sau mili giây đã cho ở định dạng ISO 8601.

• startedBefore

  chuỗi không bắt buộc

  Giới hạn kết quả thành DownloadItem bắt đầu trước mili giây đã cho ở định dạng ISO 8601.

• tiểu bang

  Tiểu bang không bắt buộc

  Cho biết quá trình tải xuống đang diễn ra, bị gián đoạn hay hoàn tất.

• totalBytes

  số không bắt buộc

  Số byte trong toàn bộ tệp, không tính đến việc nén tệp hoặc -1 nếu không xác định.

• totalBytesGreater

  số không bắt buộc

  Giới hạn kết quả đến DownloadItem có totalBytes lớn hơn số nguyên đã cho.

• totalBytesLess

  số không bắt buộc

  Giới hạn kết quả đến DownloadItem có totalBytes nhỏ hơn số nguyên đã cho.

• url

  chuỗi không bắt buộc

  URL tuyệt đối mà quá trình tải xuống này bắt đầu từ đó, trước bất kỳ lượt chuyển hướng nào.

• urlRegex

  chuỗi không bắt buộc

  Giới hạn kết quả đến DownloadItem có url khớp với biểu thức chính quy đã cho.

FilenameConflictAction

đơn hoá

Để tránh trùng lặp, filename được thay đổi để bao gồm bộ đếm trước đuôi tệp.

ghi đè

Tệp hiện tại sẽ bị ghi đè bằng tệp mới.

câu lệnh

Người dùng sẽ thấy một hộp thoại của bộ chọn tệp.

Enum

"uniquify"

"ghi đè"

"prompt"

FilenameSuggestion

Thuộc tính

• conflictAction

  FilenameConflictAction không bắt buộc

  Hành động cần thực hiện nếu filename đã tồn tại.

• filename

  string

  Đích đến mới DownloadItem.filename của DownloadItem, dưới dạng đường dẫn tương ứng với thư mục Tệp đã tải xuống mặc định của người dùng, có thể chứa các thư mục con. Đường dẫn tuyệt đối, đường dẫn trống và đường dẫn chứa tham chiếu ngược ".." sẽ bị bỏ qua. filename sẽ bị bỏ qua nếu có bất kỳ trình nghe onDeterminingFilename nào được đăng ký bởi bất kỳ tiện ích nào.

GetFileIconOptions

Thuộc tính

• size

  số không bắt buộc

  Kích thước của biểu tượng được trả về. Biểu tượng sẽ có hình vuông, có kích thước * kích thước pixel. Kích thước mặc định và lớn nhất cho biểu tượng là 32x32 pixel. Kích thước duy nhất được hỗ trợ là 16 và 32. Sẽ có lỗi khi chỉ định bất kỳ kích thước nào khác.

HeaderNameValuePair

Thuộc tính

• tên

  string

  Tên của tiêu đề HTTP.

• value

  string

  Giá trị của tiêu đề HTTP.

HttpMethod

Enum

"GET"

"ĐĂNG"

InterruptReason

Enum

"FILE_FAILED"

"FILE_ACCESS_DENIED"

"FILE_NO_SPACE"

"FILE_NAME_TOO_LONG"

"FILE_TOO_LARGE"

"FILE_VIRUS_INFECTED"

"FILE_TRANSIENT_ERROR"

"FILE_BLOCKED"

"FILE_SECURITY_CHECK_FAILED"

"FILE_TOO_SHORT"

"FILE_HASH_MISMATCH"

"FILE_SAME_AS_SOURCE"

"NETWORK_FAILED"

"NETWORK_TIMEOUT"

"NETWORK_DISCONNECTED"

"NETWORK_SERVER_DOWN"

"NETWORK_INVALID_REQUEST"

"SERVER_FAILED"

"SERVER_NO_RANGE"

"SERVER_context_CONTENT"

"SERVER_UNAUTHORIZED"

"SERVER_CERT_ISSUES"

"SERVER_FORBIDDEN"

"SERVER_UNREACHABLE"

"SERVER_CONTENT_LENGTH_MISMATCH"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

"Hàm CRASH"

State

in_progress

Tệp tải xuống hiện đang nhận dữ liệu từ máy chủ.

bị gián đoạn

Đã xảy ra lỗi làm gián đoạn kết nối với máy chủ lưu trữ tệp.

đã hoàn tất

Đã tải xuống thành công.

Enum

"in_progress"

"bị gián đoạn"

"hoàn tất"

StringDelta

Thuộc tính

• hồ sơ thanh toán

  chuỗi không bắt buộc

• trước

  chuỗi không bắt buộc

UiOptions

Chrome 105 trở lên

Thuộc tính

• đang bật

  boolean

  Bật hoặc tắt giao diện người dùng tải xuống.

Phương thức

acceptDanger()

Lời hứa

chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
)

Nhắc người dùng chấp nhận một nội dung tải xuống nguy hiểm. Chỉ có thể gọi được từ bối cảnh hiển thị (thẻ, cửa sổ hoặc cửa sổ bật lên hành động trên trang/trình duyệt). Không tự động chấp nhận nội dung tải xuống nguy hiểm. Nếu nội dung tải xuống được chấp nhận thì sự kiện onChanged sẽ kích hoạt, nếu không thì sẽ không có gì xảy ra. Khi tất cả dữ liệu được tìm nạp vào một tệp tạm thời và nội dung tải xuống đó không nguy hiểm hoặc mối nguy hiểm đã được chấp nhận, thì tệp tạm thời đó được đổi tên thành tên tệp đích, state sẽ chuyển thành "hoàn tất" và onChanged sẽ kích hoạt.

Tham số

• downloadId

  số

  Giá trị nhận dạng của DownloadItem.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

cancel()

Lời hứa

chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
)

Huỷ quá trình tải xuống. Khi callback chạy, quá trình tải xuống sẽ bị huỷ, hoàn tất, bị gián đoạn hoặc không tồn tại nữa.

Tham số

• downloadId

  số

  Mã của tệp tải xuống cần huỷ.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

download()

Lời hứa

chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
)

Tải một URL xuống. Nếu URL sử dụng giao thức HTTP[S] thì yêu cầu sẽ bao gồm tất cả cookie hiện được đặt làm tên máy chủ. Nếu bạn chỉ định cả filename và saveAs, thì hộp thoại Lưu dưới dạng sẽ xuất hiện và được điền sẵn filename đã chỉ định. Nếu quá trình tải xuống bắt đầu thành công, callback sẽ được gọi bằng downloadId của DownloadItem mới. Nếu xảy ra lỗi khi bắt đầu tải xuống, thì callback sẽ được gọi bằng downloadId=undefined và runtime.lastError sẽ chứa một chuỗi mô tả. Không phải lúc nào chuỗi lỗi cũng duy trì khả năng tương thích ngược giữa các bản phát hành. Tiện ích không được phân tích cú pháp phần này.

Tham số

• tùy chọn

  DownloadOptions

  Nội dung cần tải xuống và cách thức tải xuống.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  (downloadId: number) => void

  • downloadId

    số

Giá trị trả về

• Promise&lt;number&gt;

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

erase()

Lời hứa

chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)

Xoá DownloadItem trùng khớp khỏi nhật ký mà không xoá tệp đã tải xuống. Một sự kiện onErased sẽ kích hoạt cho mỗi DownloadItem khớp với query, sau đó callback sẽ được gọi.

Tham số

• truy vấn

  DownloadQuery

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  (erasedIds: number[]) => void

  • erasedIds

    số[]

Giá trị trả về

• Cam kết<number[]>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getFileIcon()

Lời hứa

chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
)

Truy xuất biểu tượng cho nội dung tải xuống được chỉ định. Đối với các tệp mới tải xuống, bạn sẽ thấy biểu tượng tệp sau khi nhận được sự kiện onCreated. Hình ảnh mà hàm này trả về khi quá trình tải xuống đang diễn ra có thể khác với hình ảnh được trả về sau khi quá trình tải xuống hoàn tất. Quá trình truy xuất biểu tượng được thực hiện bằng cách truy vấn hệ điều hành hoặc bộ công cụ cơ bản tuỳ thuộc vào nền tảng. Do đó, biểu tượng được trả về sẽ phụ thuộc vào một số yếu tố, bao gồm cả trạng thái của tệp tải xuống, nền tảng, loại tệp đã đăng ký và giao diện trực quan. Nếu không xác định được biểu tượng tệp, runtime.lastError sẽ xuất hiện thông báo lỗi.

Tham số

• downloadId

  số

  Giá trị nhận dạng của tệp đã tải xuống.

• tùy chọn

  GetFileIconOptions không bắt buộc

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  (iconURL?: string) => void

  • iconURL

    chuỗi không bắt buộc

Giá trị trả về

• Cam kết<chuỗi | không xác định>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

open()

Lời hứa

chrome.downloads.open(
  downloadId: number,
  callback?: function,
)

Mở tệp đã tải xuống ngay nếu DownloadItem đã hoàn tất; nếu không thì sẽ trả về lỗi thông qua runtime.lastError. Phương thức này yêu cầu quyền "downloads.open" ngoài quyền "downloads". Sự kiện onChanged sẽ kích hoạt trong lần đầu mở mục. Phương thức này chỉ có thể được gọi để phản hồi một cử chỉ của người dùng.

Tham số

• downloadId

  số

  Giá trị nhận dạng của tệp đã tải xuống.

• số gọi lại

  hàm không bắt buộc

  Chrome 123 trở lên

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 123 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

pause()

Lời hứa

chrome.downloads.pause(
  downloadId: number,
  callback?: function,
)

Tạm dừng quá trình tải xuống. Nếu yêu cầu thành công thì quá trình tải xuống sẽ ở trạng thái tạm dừng. Nếu không, runtime.lastError sẽ chứa thông báo lỗi. Yêu cầu sẽ không thành công nếu quá trình tải xuống không hoạt động.

Tham số

• downloadId

  số

  Mã của quá trình tải xuống cần tạm dừng.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

removeFile()

Lời hứa

chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
)

Xoá tệp đã tải xuống nếu tệp đó tồn tại và DownloadItem đã hoàn tất; nếu không, hãy trả về lỗi thông qua runtime.lastError.

Tham số

• downloadId

  số

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

resume()

Lời hứa

chrome.downloads.resume(
  downloadId: number,
  callback?: function,
)

Tiếp tục quá trình tải xuống đã tạm dừng. Nếu yêu cầu thành công thì quá trình tải xuống đang diễn ra và huỷ tạm dừng. Nếu không, runtime.lastError sẽ chứa thông báo lỗi. Yêu cầu sẽ không thành công nếu quá trình tải xuống không hoạt động.

Tham số

• downloadId

  số

  Mã của quá trình tải xuống cần tiếp tục.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

search()

Lời hứa

chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)

Tìm DownloadItem. Đặt query thành đối tượng trống để nhận tất cả DownloadItem. Để có một DownloadItem cụ thể, bạn chỉ cần đặt trường id. Để chuyển trang thông qua một số lượng lớn các mục, hãy thiết lập orderBy: ['-startTime'], đặt limit thành số lượng mục trên mỗi trang rồi đặt startedAfter thành startTime của mục cuối cùng ở trang cuối.

Tham số

• truy vấn

  DownloadQuery

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  (results: DownloadItem[]) => void

  • kết quả

    DownloadItem[]

Giá trị trả về

• Promise&lt;DownloadItem[]&gt;

  Chrome 96 trở lên

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

setShelfEnabled()

Không được dùng nữa kể từ Chrome 117

chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

Thay vào đó, hãy sử dụng setUiOptions.

Bật hoặc tắt giá màu xám ở cuối mỗi cửa sổ được liên kết với hồ sơ trình duyệt hiện tại. Kệ này sẽ bị tắt khi có ít nhất một tiện ích đã tắt. Khi bật kệ trong khi ít nhất một tiện ích khác đã tắt, kệ sẽ trả về thông báo lỗi thông qua runtime.lastError. Cần có quyền "downloads.shelf" cùng với quyền "downloads".

Tham số

• đang bật

  boolean

setUiOptions()

Lời hứa Chrome 105 trở lên

chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)

Thay đổi giao diện người dùng tải xuống của mọi cửa sổ được liên kết với hồ sơ trình duyệt hiện tại. Chỉ cần ít nhất một tiện ích đã đặt UiOptions.enabled thành false, thì giao diện người dùng tải xuống sẽ bị ẩn. Nếu bạn đặt UiOptions.enabled thành true (đúng) khi ít nhất một tiện ích khác đã tắt, tiện ích sẽ trả về lỗi thông qua runtime.lastError. Cần có quyền "downloads.ui" cùng với quyền "downloads".

Tham số

• tùy chọn

  UiOptions

  Đóng gói thay đổi đối với giao diện người dùng tải xuống.

• số gọi lại

  hàm không bắt buộc

  Tham số callback sẽ có dạng như sau:

  () => void

Giá trị trả về

• Lời hứa<vô hiệu>

  Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

show()

chrome.downloads.show(
  downloadId: number,
)

Hiển thị tệp đã tải xuống trong thư mục của tệp đó trong trình quản lý tệp.

Tham số

• downloadId

  số

  Giá trị nhận dạng của tệp đã tải xuống.

showDefaultFolder()

chrome.downloads.showDefaultFolder()

Hiển thị thư mục Tệp đã tải xuống mặc định trong trình quản lý tệp.

Sự kiện

onChanged

chrome.downloads.onChanged.addListener(
  callback: function,
)

Khi bất kỳ thuộc tính nào của DownloadItem ngoại trừ bytesReceived và estimatedEndTime thay đổi, sự kiện này sẽ kích hoạt bằng downloadId và một đối tượng chứa các thuộc tính đã thay đổi.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

onCreated

chrome.downloads.onCreated.addListener(
  callback: function,
)

Sự kiện này kích hoạt cùng với đối tượng DownloadItem khi quá trình tải xuống bắt đầu.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

onDeterminingFilename

chrome.downloads.onDeterminingFilename.addListener(
  callback: function,
)

Trong quá trình xác định tên tệp, các phần mở rộng sẽ có cơ hội ghi đè lên mục tiêu DownloadItem.filename. Mỗi tiện ích chỉ được đăng ký một trình nghe cho sự kiện này. Mỗi trình nghe phải gọi suggest chính xác một lần, đồng bộ hoặc không đồng bộ. Nếu trình nghe gọi suggest không đồng bộ, thì trình nghe phải trả về true. Nếu trình nghe không gọi suggest đồng bộ và cũng không trả về true, thì suggest sẽ tự động được gọi. DownloadItem sẽ không hoàn tất cho đến khi tất cả trình nghe gọi suggest. Trình nghe có thể gọi suggest mà không có bất kỳ đối số nào để cho phép tải xuống sử dụng downloadItem.filename cho tên tệp hoặc truyền đối tượng suggestion đến suggest nhằm ghi đè tên tệp mục tiêu. Nếu có nhiều đuôi tệp ghi đè tên tệp, thì tiện ích cuối cùng được cài đặt có trình nghe truyền đối tượng suggestion đến suggest sẽ chiến thắng. Để tránh nhầm lẫn về việc tiện ích nào sẽ giành chiến thắng, người dùng không nên cài đặt các tiện ích có thể xung đột. Nếu quá trình tải xuống do download bắt đầu và tên tệp đích được xác định trước khi loại MIME và tên tệp dự kiến được xác định, hãy chuyển filename đến download.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (downloadItem: DownloadItem, suggest: function) => void

  • downloadItem

    DownloadItem

  • đề xuất

    hàm

    Tham số suggest sẽ có dạng như sau:

    (suggestion?: FilenameSuggestion) => void

    • đề xuất

      FilenameSuggestion không bắt buộc

onErased

chrome.downloads.onErased.addListener(
  callback: function,
)

Kích hoạt bằng downloadId khi một tệp tải xuống bị xoá khỏi nhật ký.

Tham số

• số gọi lại

  hàm

  Tham số callback sẽ có dạng như sau:

  (downloadId: number) => void

  • downloadId

    số