BackgroundFetchRegistration: matchAll() method

Cú pháp

matchAll()
matchAll(request)
matchAll(request,options)

Tham số

request Optional

Request mà bạn đang cố tìm các bản ghi tương ứng. Tham số này có thể là một đối tượng Request hoặc một URL. Nếu bỏ qua tham số này thì mọi bản ghi đều sẽ được đưa vào kết quả.

options Optional

Một đối tượng thiết lập các tùy chọn cho thao tác match. Các tùy chọn khả dụng là:

ignoreSearch Optional

Một giá trị boolean cho biết có bỏ qua chuỗi truy vấn trong URL hay không. Ví dụ, nếu đặt thành true thì phần ?value=bar của https://example.com/?value=bar sẽ bị bỏ qua khi thực hiện so khớp. Mặc định là false.

ignoreMethod Optional

Một giá trị boolean. Khi là true, thao tác so khớp sẽ không kiểm tra phương thức http của Request. Nếu là false (mặc định) thì chỉ cho phép GET và HEAD.

ignoreVary Optional

Một giá trị boolean. Khi là true, nó cho biết nên bỏ qua header Vary. Mặc định là false.

Giá trị trả về

Một Promise phân giải thành một mảng gồm tất cả các đối tượng BackgroundFetchRecord khớp.

Ngoại lệ

InvalidStateError DOMException

Được trả về nếu cờ recordsAvailable là false, cho biết không có lượt tìm nạp nào đang diễn ra.

Ví dụ

Dùng matchAll() mà không có tham số để trả về mọi bản ghi trong một tác vụ tìm nạp nền.

const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects

Thông số kỹ thuật

Khả năng tương thích với trình duyệt