Cache: phương thức addAll()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.
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 addAll() của giao diện Cache nhận một mảng URL, lấy dữ liệu từ chúng và thêm các đối tượng phản hồi kết quả vào bộ nhớ đệm đã cho. Các đối tượng yêu cầu được tạo ra trong quá trình truy xuất trở thành khóa cho các thao tác phản hồi đã lưu.
Note:
addAll() sẽ ghi đè bất kỳ cặp khóa/giá trị nào trước đó đã lưu trong bộ nhớ đệm mà khớp với yêu cầu, nhưng sẽ thất bại nếu một thao tác put() kết quả sẽ ghi đè một mục bộ nhớ đệm trước đó được lưu bởi cùng phương thức addAll().
Cú pháp
addAll(requests)
Tham số
requests-
Một mảng yêu cầu cho các tài nguyên bạn muốn thêm vào bộ nhớ đệm. Đây có thể là các đối tượng
Requesthoặc URL.Các yêu cầu này được dùng làm tham số cho hàm khởi tạo
Request(), nên URL tuân theo các quy tắc tương tự như hàm khởi tạo đó. Đặc biệt, URL có thể là tương đối so với URL cơ sở, tức làbaseURIcủa tài liệu trong ngữ cảnh cửa sổ, hoặcWorkerGlobalScope.locationtrong ngữ cảnh worker.
Giá trị trả về
Một Promise phân giải thành undefined.
Ngoại lệ
TypeError-
Lược đồ URL không phải là
httphoặchttps.Trạng thái phản hồi không nằm trong khoảng 200 (tức không phải phản hồi thành công). Điều này xảy ra nếu yêu cầu không trả về thành công, nhưng cũng xảy ra nếu yêu cầu là một yêu cầu cross-origin no-cors (trong trường hợp đó trạng thái báo cáo luôn là 0).
Ví dụ
Khối mã này chờ một InstallEvent xảy ra, sau đó chạy
waitUntil() để xử lý quá trình cài đặt cho
ứng dụng. Việc này bao gồm gọi CacheStorage.open để tạo một bộ nhớ đệm mới,
sau đó dùng addAll() để thêm một loạt tài nguyên vào đó.
this.addEventListener("install", (event) => {
event.waitUntil(
caches
.open("v1")
.then((cache) =>
cache.addAll([
"/",
"/index.html",
"/style.css",
"/app.js",
"/image-list.js",
"/star-wars-logo.jpg",
"/gallery/",
"/gallery/bountyHunters.jpg",
"/gallery/myLittleVader.jpg",
"/gallery/snowTroopers.jpg",
]),
),
);
});
Thông số kỹ thuật
| Specification |
|---|
| Service Workers Nightly # cache-addAll |