Clients: 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.
Note: This feature is only available in Service Workers.
Phương thức matchAll() của giao diện Clients
trả về một Promise cho danh sách các đối tượng Client
của service worker. Hãy thêm tham số options để trả về mọi client service worker
có cùng origin với origin của service worker liên kết. Nếu không truyền options,
phương thức chỉ trả về các client service worker đang được service worker đó kiểm soát.
Cú pháp
matchAll()
matchAll(options)
Tham số
optionsOptional-
Một đối tượng tùy chọn cho phép bạn đặt các tùy chọn cho thao tác đối sánh. Các tùy chọn hiện có là:
includeUncontrolled-
Một giá trị boolean. Nếu đặt thành
true, thao tác đối sánh sẽ trả về mọi client service worker có cùng origin với service worker hiện tại. Nếu không, nó chỉ trả về các client service worker đang được service worker hiện tại kiểm soát. Giá trị mặc định làfalse. type-
Đặt kiểu client mà bạn muốn đối sánh. Các giá trị hiện có là
"window","worker","sharedworker"và"all". Mặc định là"window".
Giá trị trả về
Một Promise được phân giải thành một mảng các đối tượng Client. Trong
Chrome 46/Firefox 54 trở lên, phương thức này trả về các client theo thứ tự
được lấy tiêu điểm gần đây nhất, đúng theo đặc tả.
Ví dụ
clients.matchAll(options).then((clientList) => {
for (const client of clientList) {
if (client.url === "index.html") {
clients.openWindow(client);
// or do something else involving the matching client
}
}
});
Thông số kỹ thuật
| Specification |
|---|
| Service Workers Nightly # clients-matchall |