Cache: phương thức matchAll()
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 matchAll() của giao diện Cache
trả về một Promise phân giải thành một mảng chứa tất cả các
phản hồi khớp trong đối tượng Cache.
Cú pháp
matchAll()
matchAll(request)
matchAll(request, options)
Tham số
requestOptional-
Requestmà bạn đang cố tìm phản hồi trongCache. Đây có thể là một đối tượngRequesthoặc một URL. Nếu đối số này bị bỏ qua, bạn sẽ nhận được bản sao của tất cả phản hồi trong bộ nhớ đệm này. optionsOptional-
Một đối tượng tùy chọn cho phép bạn đặt các tùy chọn kiểm soát cụ thể cho việc so khớp. Các tùy chọn có sẵn là:
ignoreSearch-
Một giá trị boolean chỉ định xem quá trình so khớp có nên bỏ qua chuỗi truy vấn trong URL hay không. Nếu đặt thành
true, phần?value=barcủahttps://example.com/?value=barsẽ bị bỏ qua khi thực hiện so khớp. Giá trị mặc định làfalse. ignoreMethod-
Một giá trị boolean, khi đặt thành
true, ngăn các thao tác so khớp xác thực phương thứcRequesthttp(thường chỉGETvàHEADđược cho phép). Giá trị mặc định làfalse. ignoreVary-
Một giá trị boolean, khi đặt thành
true, yêu cầu thao tác so khớp không thực hiện so khớp tiêu đềVARY— tức nếu URL khớp bạn sẽ nhận được kết quả bất kể đối tượngResponsecó tiêu đềVARYhay không. Giá trị mặc định làfalse.
Giá trị trả về
Một Promise phân giải thành một mảng chứa tất cả các phản hồi khớp trong đối tượng
Cache.
Note:
Cache.match() về cơ bản giống với
Cache.matchAll(), ngoại trừ việc thay vì phân giải thành một mảng chứa tất cả
các phản hồi khớp, nó chỉ phân giải thành phản hồi khớp đầu tiên (tức là
response[0]).
Ví dụ
Ví dụ sau truy xuất tất cả các phản hồi trong bộ nhớ đệm v1 khớp với URL /, bao gồm cả các tham số truy vấn tiềm năng. Bằng cách dùng { ignoreSearch: true }, matchAll sẽ truy xuất cả / lẫn /?value=bar.
Sau đó nó ghi lại số lượng phản hồi khớp.
caches
.open("v1")
.then((cache) => cache.matchAll("/", { ignoreSearch: true }))
.then((responses) => {
console.log(`Found ${responses.length} matching responses`);
});
Thông số kỹ thuật
| Specification |
|---|
| Service Workers Nightly # cache-matchall |